mcpField
A
audit-openclaw-security

audit-openclaw-security

github.com/tristanmanchesterセキュリティ493 回インストール7 週間前に更新
リポジトリ

audit-openclaw-security について

audit-openclaw-securityは、所有または監査権限のあるOpenClawシステムを対象とするスキルです。まず読み取り専用で証拠を集め、公開範囲や権限を確認し、設定の秘匿化と修正後の検証を案内します。

主な機能

  1. 01デプロイの信頼境界の整理
  2. 02CLIとホストの監査証拠の収集
  3. 03設定内の認証情報の秘匿化
  4. 04ネットワーク公開範囲とツール権限の確認
  5. 05承認された変更後の再チェック

活用シーン

  1. 01許可されたOpenClaw環境の評価
  2. 02秘匿化したセキュリティレポートの作成
  3. 03ゲートウェイの公開範囲とアクセス制御の調査
  4. 04承認済み設定変更の検証

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/tristanmanchester/agent-skills --skill audit-openclaw-security

インストール後、Claude Code で/audit-openclaw-securityを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

CHANGELOG.md
assets/
openclaw_checkid_map.json
report-template.md
references/
command-cheatsheet.md
openclaw-audit-checks.md
openclaw-baseline-config.md
platform-aws-ec2.md
platform-docker.md
platform-mac-mini.md
platform-personal-laptop.md
scripts/
collect_openclaw_audit.sh
redact_openclaw_config.py
render_report.py
tests/
test_redaction.py
test_review_regressions.py

詳細

OpenClaw のセキュリティを監査する

ユーザーが所有するシステム、または評価を許可されているシステムを監査します。まずは読み取り専用で開始し、設定変更、修復、再起動、認証情報のローテーション、公開範囲の変更を行う場合は承認を得てください。生のトークン、パスワード、Cookie、認証情報ストアを要求してはいけません。

信頼境界を確立する

インストールされている OpenClaw のバージョン、ホスト／コンテナーの構成、ゲートウェイのバインドアドレス、プロキシ／トンネルの経路、およびメッセージを送信したりツールを呼び出したりできるユーザーを記録します。1 つのゲートウェイは、信頼された 1 つの運用者／チームの境界であり、互いに敵対するユーザー間の隔離にはなりません。異なる信頼ドメインには、別々のゲートウェイと認証情報を使用してください。

ホストへのインストールとコンテナーイメージでは、バインドの既定値が異なる場合があります。インストール方法から公開範囲を推測するのではなく、実行中のリスナーと公開されているコンテナーポートを確認してください。

証拠を収集する

SKILL_DIR を、このファイルを含むディレクトリに設定します。バンドルされたパスは、監査対象のプロジェクトではなく、このディレクトリを基準とします。確認が終わるまでは、出力をローカルに保管し、非公開にしてください。

openclaw --version
openclaw security audit --help
openclaw security audit --json
openclaw security audit --deep --json

ホスト／ネットワークの情報をさらに収集するには、バンドルされたコレクターとレンダラーを実行します。

bash "$SKILL_DIR/scripts/collect_openclaw_audit.sh" --out ./openclaw-audit
python3 "$SKILL_DIR/scripts/render_report.py" --input ./openclaw-audit --output ./openclaw-security-report.md

失敗や未対応のコマンドは、合格したチェックとしてではなく、証拠の欠落として記録してください。レンダラーはレポート作成の補助であり、デプロイが安全であることを証明するものではありません。CLI の診断情報には、非公開の識別子や機密性の高い自由記述が含まれる場合があります。共有する前に確認してください。

必要な場合に限り設定をマスキングする

設定全体をエクスポートするのではなく、秘密ではない設定を対象を絞って読み取る方法を優先してください。設定を共有する必要がある場合：

python3 "$SKILL_DIR/scripts/redact_openclaw_config.py" ~/.openclaw/openclaw.json > openclaw.redacted.json

このヘルパーは JSON／JSON5 を解析し、機密フィールドの値全体を置き換え、URL から認証情報を削除します。入力が無効な場合は、空の stdout とゼロ以外のステータスを返します。必要な場合は JSON5 パーサーをインストールしてください。生の設定を正規表現で編集する方法に切り替えてはいけません。解析時にコメントは削除されます。不明なフィールドや自由記述は手動で確認してください。マスキングは、あらゆる秘密情報を網羅的に検出するものではありません。出力は復元可能なバックアップではありません。

優先順位を付けて対処する

  1. ランタイム／ファイルシステム／昇格権限のツールによる、外部公開とメッセージを受け付ける公開面を封じ込めます。
  2. ゲートウェイ認証、許可されたオリジン、信頼できるプロキシ、実際のクライアント ID の経路を確認します。Tailscale Serve と一般公開の Funnel では公開範囲が異なります。どちらもアクセス制御ポリシーの確認に代わるものではありません。
  3. DM のペアリング／許可リスト、グループアクセス、メンションゲート、セッションの隔離を確認します。メンションゲートが制御するのはトリガーであり、悪意あるユーザーに対するセキュリティ境界ではありません。
  4. ツール、ブラウザー、ノード、プラグイン、自動化の権限をタスクに必要な範囲に制限します。意図した設定だけでなく、実際に適用されるポリシーをテストしてください。
  5. 認証情報、トランスクリプト、ログの権限と保持期間を確認します。インストール済みプラグインと書き込み可能なスキルは、実行可能なサプライチェーンの入力として扱ってください。
  6. 承認された変更ごとに、変更前の設定を安全に保存し、まとまりのある変更を 1 つ適用してから、該当する監査と機能チェックを再実行します。ロールバック手段を確保してください。

正確なキーを確認するには、インストール済みの CLI と最新の公式設定スキーマを使用してください。古いチェック ID リストから安全性を推測したり、プラットフォームのベースラインを無検証で貼り付けたりしてはいけません。

必要に応じて関連資料を読み込む

  • references/platform-mac-mini.md、references/platform-personal-laptop.md、references/platform-docker.md、または references/platform-aws-ec2.md：プラットフォームの調査用プロンプト。
  • references/openclaw-audit-checks.md と assets/openclaw_checkid_map.json：既知の指摘事項の説明。不明な最新のチェック項目も優先順位を付けて調査する必要があります。
  • assets/report-template.md：最終レポートの構成。

対象範囲／バージョン、証拠をマスキングした観測結果、重大度と影響、承認された変更、検証結果、未テストの境界を報告します。観測事項と提案は分けて記載してください。

ソースと検証

OpenClaw のセキュリティを基に、2026-09-13 に確認しました。現在の信頼モデル、監査、ネットワーク公開、シークレットの各セクションが対象です。セキュリティポリシーを変更する前に、これらのページを参照してください。

オフラインのマスキング回帰テストを次のコマンドで実行します。

python3 -m unittest discover -s "$SKILL_DIR/tests" -v

コメント

Markdown 対応