mcpField
C
clawpilot

clawpilot

github.com/kcchienエージェントワークフロー48264 回インストール27 週間前に更新
リポジトリ

clawpilot について

OpenClaw のセットアップ、運用、トラブルシューティング、セキュリティを扱うスキルです。設定やプロンプト、セッション記録をスクリプトで監査し、作業前に参照情報の更新を確認します。

主な機能

  1. 01利用前に参照情報の鮮度を確認
  2. 02インストールとチャンネル設定を案内
  3. 03セキュリティを考慮した設定を提案
  4. 04設定とエージェントのプロンプトを監査
  5. 05セッション記録の漏えいシークレットを検査
  6. 06OpenClaw CLI コマンドで問題を診断

活用シーン

  1. 01OpenClaw の導入とチャンネル接続
  2. 02ゲートウェイとアクセス制御の確認
  3. 03プロンプトインジェクションリスクの点検
  4. 04セッションファイル内の認証情報の検出

インストール

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

$npx skills add https://github.com/kcchien/clawpilot --skill clawpilot

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

同梱ファイル

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

LICENSE
.gitignore
README.md
agents/
openai.yaml
references/
configuration.md
cloud-deployment.md
multi-agent.md
security.md
scripts/
check_updates.sh
config_inspector.sh
prompt_checker.sh
security_audit.sh
mark_updated.sh
session_scanner.sh

詳細

OpenClaw エキスパートスキル

自動更新チェック（最初に実行）

ほかの操作を行う前に、古さのチェックを実行してください。

bash scripts/check_updates.sh
  • UP_TO_DATE の場合：通常どおり進めてください。
  • STALE の場合：スキルの参照情報が古くなっている可能性があります。ユーザーのタスクに取りかかる前に、以下を実行してください。
    1. https://github.com/openclaw/openclaw/releases から最新のリリースを3～5件取得します。
    2. https://docs.openclaw.ai/llms.txt を取得して、ドキュメントの変更を確認します。
    3. Webを検索して、最近のOpenClawのCVEやセキュリティ勧告を確認します。
    4. 調査結果をSKILL.mdのフロントマターおよびreferences/security.mdのバージョンと照合します。
    5. 見つかったバージョンの差異や新たなセキュリティ問題をユーザーに伝えます。
    6. 参照情報を更新した場合は、次を実行します：bash scripts/mark_updated.sh <latest-version>
    7. 更新が不要な場合も、チェック済みとして記録します：bash scripts/mark_updated.sh <current-version>

このチェックでは.last_update_checkマーカーファイルを使用します。しきい値は7日です（第1引数で変更可能）。

セキュリティ優先の原則

設定に関する操作はすべて、推奨する前にセキュリティレビューを通過させる必要があります。

設定を変更するたびに、以下を評価してください。

  1. 影響範囲 — この設定が悪用された場合、攻撃者は何にアクセスできるでしょうか？
  2. 認証情報の露出 — シークレットは安全に保存されていますか？アクセス許可は適切ですか？
  3. ネットワークの公開範囲 — ゲートウェイが必要以上に公開されていませんか？
  4. プロンプトインジェクションのリスク — 信頼できないメッセージ内容によって、エージェントが操作される可能性はありませんか？
  5. サプライチェーンリスク — インストールされたスキルやプラグインは信頼できるソースのものですか？

設定を推奨する際は、まず安全な基本設定を提示し、次に制限を緩和する場合のトレードオフを説明してください。

重大なCVE（要確認）
  • CVE-2026-25253（CVSS 8.8）：Control UI経由のトークン窃取 — 2026.1.29で修正済み
  • CVE-2026-24763：コマンドインジェクション — 2026.1.29で修正済み
  • CVE-2026-25157：コマンドインジェクション（25253と連鎖可能） — 2026.1.29で修正済み
  • 2026.2.12：大規模なセキュリティパッチ（40件以上の脆弱性） — パストラバーサル、SSRF、権限昇格
  • 2026.2.15以降：SHA-256サンドボックスハッシュ、プラグイン検出の強化、ACPセッションDoSの修正
  • 2026.2.17以降：SSRF ISATAP対策、iMessageのSSHホストキー適用、コントロールプレーンRPCのレート制限
  • 2026.2.19：ブラウザーリレーの認証強化（/extensionと/cdpでgateway-tokenが必須）

ほかの助言を行う前に、ユーザーのバージョンが2026.2.19以降であることを必ず確認してください。

クイックリファレンス

タスクコマンド
インストールnpm install -g openclaw@latest
初期設定openclaw onboard --install-daemon
ゲートウェイの起動openclaw gateway --port 18789
チャネルにログインopenclaw channels login
ヘルスチェックopenclaw health
セキュリティ監査openclaw security audit --deep
スキルの安全性スキャンopenclaw skills scan <path>
診断openclaw doctor
更新openclaw update
ログの表示openclaw logs
ステータス（機密情報を除去）openclaw status --all
エージェントの管理openclaw agents list
iOS/macOSノードopenclaw nodes
デバイスの管理openclaw devices remove/clear
Cron（間隔をずらす）openclaw cron add --stagger/--exact
サブエージェントの起動/subagents spawn
シェル補完openclaw completion

コマンドの一覧をすべて表示するには、openclaw --helpを実行してください。

ドキュメントの参照元

このスキルに同梱されている参照ファイルを、主な情報源として使用してください。基本的な設定スキーマ、セキュリティ強化（CVE、OWASPとの対応付け、NISTとの整合性を含む）、クラウドへのデプロイ、マルチエージェントのルーティングを網羅しています。

以下の場合にのみ、https://docs.openclaw.ai/ から情報を取得してください。

  • 同梱の参照情報に、ユーザーが質問した機能についての記載がない場合
  • バージョン固有の動作について、最新のドキュメントが必要な場合
  • コマンドや設定キーが同梱の参照情報にない場合

ドキュメントのインデックス全体：https://docs.openclaw.ai/llms.txt

コアアーキテクチャ

Chat Apps --> Gateway (single process) --> AI Agent(s)
             |                              |
             +- Session manager             +- Workspace (SOUL.md, AGENTS.md, MEMORY.md)
             +- Channel routing             +- Auth profiles
             +- Tool policies               +- Memory (daily logs + vector search)
             +- Sandbox (Docker)            +- Sessions
             +- Cron scheduler              +- Skills
             +- Safety scanner              +- Subagents
             +- Agent mgmt RPC             +- iOS/macOS nodes
  • ゲートウェイ：セッション、ルーティング、チャネル接続の唯一の信頼できる情報源です。デフォルトで 127.0.0.1:18789 にバインドします。
  • エージェント：それぞれ独自のワークスペース、状態ディレクトリ、認証プロファイル、セッションストアを持つ分離されたエンティティです。RPC（agents.create、agents.update、agents.delete）から管理できます。
  • チャネル：プラグインベースです。WhatsApp、Telegram、Discord、Slack、iMessage、Signal、LINE、Matrix、Teams、Google Chat、Mattermost、BlueBubbles、Feishu、Zalo に対応しています。
  • 設定：~/.openclaw/openclaw.json（JSON5 形式）です。OPENCLAW_HOME 環境変数を設定すると、パス解決に使用するホームディレクトリを上書きできます。
  • ノード：ペアリングによるリモートコード実行に対応した iOS アルファ版および macOS ノードです。
  • iOS：Watch コンパニオン（受信トレイ UI、通知リレー）、共有拡張機能（ゲートウェイへのコンテンツ転送）、APNs プッシュ通知（v2026.2.19 以降）。

セキュアなベースライン

常にセキュアなベースラインから始め、正当な理由がある場合にのみ制限を緩和してください。主なデフォルト値：bind: "loopback"、dmPolicy: "pairing"、sandbox: { mode: "non-main" }、redactSensitive: "tools"。

破壊的変更（v2026.2.10～2026.2.19）
  • WebChat クライアントではゲートウェイ HTTP API（sessions.patch、sessions.delete）がブロックされるようになりました
  • ブラウザーリレーで、/extension と /cdp の両方のエンドポイントにゲートウェイトークン認証が必要になりました
  • サブエージェントのタスクメッセージに、ソースコンテキストがプレフィックスとして付加されるようになりました
  • 毎時ちょうどに実行される定期スケジュールに、Cron の分散実行のデフォルト値が適用されるようになりました

ベースラインの完全なテンプレートとメモリーシステムの設定については、設定リファレンスとセキュリティ強化を参照してください。

一般的なワークフロー

初期設定
  1. npm install -g openclaw@latest
  2. openclaw onboard --install-daemon
  3. openclaw channels login（チャネルを選択）
  4. openclaw gateway --port 18789
  5. openclaw security audit --deep を実行 — 検出された問題を修正します
  6. openclaw skills scan を実行 — インストール済みのスキルが安全であることを確認します
  7. openclaw health を実行し、http://127.0.0.1:18789/ を開いて確認します
チャネルの追加
  1. openclaw channels login -> チャネルを選択
  2. openclaw.json で許可リストを設定します（本番環境では "*" を使用しないでください）
  3. dmPolicy: "pairing" または "allowlist" を設定します
  4. グループでは requireMention: true を設定します
  5. セキュリティレビュー：許可リストを確認し、そのチャネルのツールアクセスを確認します
リモートアクセス（セキュア）

推奨：Tailscale Serve — ループバックバインドを維持し、外部に公開しません。 代替：SSH トンネル — ssh -N -L 18789:127.0.0.1:18789 user@host 禁止：認証トークンとファイアウォールを設定せずに 0.0.0.0 にバインドすること。

トラブルシューティング
  1. openclaw doctor — 設定を検証します
  2. openclaw health — ゲートウェイの状態を確認します
  3. openclaw logs — 最近のログを表示します
  4. openclaw status --all — 状態全体を表示します（シークレットはマスキングされます）
  5. openclaw memory search "topic" — エージェントのメモリーを検索します
  6. openclaw sessions list — アクティブなセッションを表示します
  7. /tmp/openclaw/openclaw-YYYY-MM-DD.log を確認します
スキルの検索とインストール

ユーザーが新しいスキルで OpenClaw を拡張したいと尋ねた場合、または「利用可能なスキルは何ですか」と尋ねた場合：

  1. 公式レジストリ：https://clawhub.com
  2. コミュニティによる厳選リスト（1,715 以上のスキル、31 のカテゴリ）：https://github.com/VoltAgent/awesome-openclaw-skills
  3. CLI からインストール：npx clawhub@latest install <skill-slug>
  4. 手動でインストール：スキルのフォルダーを ~/.openclaw/skills/（グローバル）または <project>/skills/（ワークスペース）にコピーします

セキュリティ：サードパーティ製スキルは信頼済みコードとして実行されます。**2026 年初頭、ClawHub で数百件の悪意あるスキルが発見されました。**必ず次の点を守ってください：

  • インストール前に openclaw skills scan <skill-path> を実行します（v2026.2.6 以降）
  • ソースコードを確認します。特に exec、browser、web_fetch ツールを使用するスキルには注意してください
  • バージョンを固定し、信頼できないスキルの自動更新を避けます

スキルの設定スキーマ（読み込み順、スキルごとの env/apiKey、ホットリロード）については、設定リファレンスを参照してください。スキルエコシステムの URL（ClawHub レジストリ、コミュニティリスト）については、セキュリティ強化 — スキルのサプライチェーンを参照してください。

ローカル検査スクリプト

利用できる場合はネイティブ CLI を優先してください：openclaw security audit --deep、openclaw doctor、openclaw config get で信頼できる結果を得られます。以下のスクリプトは、より詳細なヒューリスティック検査を行う場合、または CLI を利用できない場合にのみ使用してください。

これらのスクリプトを、ローカルの OpenClaw インストールに対して実行します。すべてのスクリプトで --state-dir PATH を指定すると、~/.openclaw を上書きできます。スクリプトは、JSON5 設定を grep ベースのヒューリスティックな解析で検査します。結果はベストエフォートです。

セキュリティの包括的な監査
bash scripts/security_audit.sh [--state-dir ~/.openclaw]

検査項目：バージョン／CVE の状況、ファイル権限、ハードコードされた認証情報、ネットワークバインド、DM ポリシー、サンドボックス設定、ツールポリシー、ログの秘匿化、プラグイン、スキルのサプライチェーン（情報流出／リバースシェル／難読化のパターン）、Control UI のセキュリティ（CVE-2026-25253）、リバースプロキシの設定（CVE-2026-24763）、ゲートウェイプロセスの露出、同期フォルダーの検出、セッション内のシークレットスキャン。OWASP Agentic Top 10 と NIST CSF に対応しています。CRITICAL／WARNING／PASS の概要を返します。

設定インスペクター
bash scripts/config_inspector.sh [--section gateway|channels|agents|tools|sessions|logging|all]

openclaw.json を解析し、セクションごとにセキュリティ関連の設定を報告し、色分けされた推奨事項を表示します。

プロンプトとシステム指示のチェッカー
bash scripts/prompt_checker.sh [--workspace PATH]

AGENTS.md、SOUL.md、USER.md、CLAUDE.md などのブートストラップファイルをスキャンし、セキュリティガードレールの不足、過度に許容的な指示、ハードコードされたシークレット、インフラストラクチャの露出、プロンプトインジェクションの脆弱性、アイデンティティ境界の不足を検査します。

セッション文字起こしスキャナー
bash scripts/session_scanner.sh [--agent AGENT_ID] [--max-files 20] [--deep]

.jsonl セッションファイルをスキャンし、漏えいした認証情報（AWS キー、GitHub PAT、API キー、秘密鍵、ボットトークン、Google API キー）を検出します。--deep を指定すると、IP アドレス、Base64 データ、ファイルパス、古いファイルも検査します。

出力例

security_audit.sh（抜粋）：

============================================
  1. Version & Known Vulnerabilities
============================================
[PASS]     Version 2026.2.19 includes CVE-2026-25253/24763/25157 patches
[PASS]     Version includes skill/plugin safety scanner (v2026.2.6+)
...
============================================
  Audit Summary
============================================
  0 CRITICAL
  2 Warnings
  3 Informational
  8 Passed

config_inspector.sh（抜粋）：

=== Gateway Configuration ===
  Mode:      local (default)
  Bind:      loopback (default)
  Port:      18789 (default)
  ✓ Loopback bind (secure default)

session_scanner.sh（抜粋）：

Found 5 session file(s) to scan (max: 20)
--- agents/main/sessions/2026-02-10.jsonl (1.2M) ---
[CRITICAL]   AWS Access Key: 1 match(es)
=== Summary ===
  1 file(s) contain potential secrets (1 total matches)
スクリプトの前提条件とエラー処理

すべてのスクリプトには bash と標準的な Unix ユーティリティ（grep、awk、wc、stat）が必要です。スクリプトが失敗した場合：

  • ~/.openclaw が見つからない：実際の OpenClaw ホームを指定するには --state-dir PATH を渡すか、OPENCLAW_HOME を設定してください。
  • jq がインストールされていない：config_inspector.sh はヒューリスティックな grep ベースの解析を使用するため、jq は不要です。他のスクリプトも jq を使用しません。
  • 権限が拒否された：スクリプトはファイルを読み取るだけです。現在のユーザーが ~/.openclaw/ の読み取り権限を持っていることを確認してください。root として実行しないでください。
  • セッションファイルが見つからない：session_scanner.sh は agents/*/sessions/*.jsonl を検索します。セッションが別の場所に保存されている場合は、--state-dir を渡してください。
  • openclaw.json が空、または見つからない：スクリプトはキーが見つからない場合に警告を報告しますが、クラッシュはしません。設定ファイルがない場合は「すべてデフォルト」として扱われます。
スクリプトを実行するタイミング
ユーザーのリクエストスクリプト
「OpenClaw のセキュリティを確認して」security_audit.sh
「設定は安全？」config_inspector.sh
「エージェントのプロンプトをレビューして」prompt_checker.sh
「シークレットが漏えいしている？」session_scanner.sh --deep
「セキュリティを全面的にレビューして」4 つすべてを順番に実行
「悪意のあるスキルがないか確認して」security_audit.sh（セクション 9）+ openclaw skills scan

リファレンスファイル

ユーザーのタスクに応じて、必要なファイルを参照してください。

  • セキュリティ強化 — 既知の CVE、OWASP Agentic Top 10 との対応、NIST CSF との整合性、スキルのサプライチェーンセキュリティ、許可リスト、サンドボックス、ツールポリシー、認証情報の管理、監査チェックリスト、インシデント対応、プロンプトインジェクション対策。セキュリティ関連の質問に回答する場合、または設定変更を推奨する前に、必ず参照してください。

    • クイック検索：grep -n "CVE\|sandbox\|dmPolicy\|tool.polic\|prompt.inject\|incident" references/security.md

  • 設定リファレンス — すべての設定キー、環境変数、チャネルの設定（WhatsApp／Telegram／Discord／Slack／iMessage／Signal／BlueBubbles など）、セッション管理、モデルプロバイダー、ツール、ログ、OPENCLAW_HOME。

    • クイック検索：grep -n "whatsapp\|telegram\|discord\|slack\|imessage\|signal\|bind\|sandbox\|dmPolic\|session" references/configuration.md

  • クラウドデプロイ — Docker、GCP、AWS Bedrock、Fly.io、Railway、Render、Hetzner、Northflank、Nix、Ansible、macOS VM。ネットワークアーキテクチャ、IAM、ボリューム、Tailscale／SSH を使ったリモートアクセス。

  • マルチエージェントとルーティング — エージェントの分離、ルーティングルール、エージェントごとのサンドボックス／ツール、バインディング、セッションスコープ、サブエージェント、ハートビート、エージェント間通信。

コメント

Markdown 対応