tool-openclaw

OpenClaw エキスパート

目標：references/docs/ に含まれるドキュメントのスナップショットを使って、OpenClaw のインストール、設定、運用に関する質問に回答します。

既定の前提：スナップショットを信頼できる情報源とします。コマンドのフラグや設定キーを推測しないでください。

入力／入出力の契約（必須）

読み込み（主な情報源）：

• references/docs/**（https://docs.openclaw.ai/*.md のオフラインミラー）
• references/entrypoints.md（厳選されたマップ）
• references/model-migration-audit.md（プロバイダー／モデル移行向けの短縮版と完全版の監査プロンプト、およびレポート形式）
• references/troubleshooting.md（ルーティング／プレイブック）

書き込み：

• 既定ではなし。
• スナップショットを更新する場合：references/docs/** + references/docs/__SNAPSHOT_INDEX.md + references/docs/llms.txt

手順（必須）

1. 質問を次のいずれかの分野に分類します。

• インストール／オンボーディング
• ゲートウェイ
• チャネル（whatsapp/telegram/discord/mattermost/imessage）
• ノード／ウェブサーフェス
• リモートアクセス（ssh/tailscale）
• 認証／oauth
• モデル移行／プロバイダー切り替え
• サンドボックス化／ツールポリシー

2. 回答する前に、スナップショットを検索します。

• ユーザーのエラー文字列がある場合は、それを検索します。
• エラー文字列がない場合は、具体的なコマンド／設定キーを検索します。
• 関連するページを1～2件開き、正確なコマンド／設定フィールドを抜き出します。

3. 以下のテンプレートを使って回答し、参照したドキュメントを引用します。

4. モデル／プロバイダーの移行について質問された場合：

• 変更を推奨する前に、ローカル環境を調べます
• 現在のモデルパス、認証モード、重要なエージェント／ランタイムのレーンを特定します
• 公開されているペルソナと、バックエンドのランタイムおよびサービスアカウントを区別します
• 移行を単なるモデル ID の問題ではなく、レーンの問題として評価します
• 短縮版プロンプト、完全版プロンプト、レポート形式には references/model-migration-audit.md を使用します
• オペレーター向けプロンプトは短く保ち、このスキルにワークフローを担わせます

安全に関する注意事項（必須）

• シークレット（トークン、API キーなど）を求めたり、復唱したりしないでください。ユーザーが設定やログを共有した場合は、機密情報を伏せるよう依頼します。
• 破壊的な手順（セッション／状態のリセット、プロファイルの削除など）は明示します。実行前に確認を求めてください。
• ドキュメントに明記されていて、トレードオフを説明できる場合を除き、セキュリティの既定値（認証、サンドボックス化）を弱めることは推奨しないでください。

検索ワークフロー（推奨）

まず grep 形式で検索し、スナップショット全体を読まないでください。

例（Markdown に対する正規表現検索）：

• エラー文で検索：

  • パターン：エラー行の正確な文字列（必要に応じて正規表現のメタ文字をエスケープ）
  • パス：references/docs
  • 対象：*.md

• 設定キーで検索：

  • canvasHost
  • allowFrom
  • requireMention
  • session.mainKey

• コマンドで検索：

  • openclaw onboard
  • openclaw gateway
  • openclaw channels login
  • openclaw doctor
  • レガシー：互換性シムとして clawdbot ... が存在する場合があります（ドキュメントを参照）。

ページマップが必要な場合は、まず次を確認します。

• references/docs/__SNAPSHOT_INDEX.md

スナップショットが古い、またはページが不足しているように見える場合は、更新します（references/docs_snapshot.md を参照）。

主な入口（スナップショット）

• references/docs/start/getting-started.md
• references/docs/start/wizard.md
• references/docs/start/wizard-cli-reference.md
• references/docs/gateway/configuration.md
• references/docs/gateway/authentication.md
• references/docs/gateway/cli-backends.md
• references/docs/providers/anthropic.md
• references/docs/providers/openai.md
• references/docs/providers/minimax.md
• references/docs/providers/zai.md
• references/docs/concepts/oauth.md
• references/docs/concepts/agent-workspace.md
• references/docs/gateway/troubleshooting.md
• references/docs/help/troubleshooting.md

出力形式（必須）

次の構成で回答します。

Diagnosis: <1 sentence>

Docs consulted:
- <path 1>
- <path 2>

Steps:
1) <actionable step>
2) <actionable step>

Verify:
- <how to confirm it worked>

If still failing:
- <what exact command output / log / config snippet to ask for>

ドキュメントスナップショットの更新

同梱のドキュメントスナップショットは references/docs/ にあり、次のインデックスで管理されています。

• references/docs/__SNAPSHOT_INDEX.md（人間／エージェント向けのルーティング）
• references/docs/__SNAPSHOT_INDEX.json（機械用インデックス）

スナップショットのインデックスを更新／再構築するには、次のようにします。

cd tool-openclaw
# If you are working inside this repo instead of an installed skill:
# cd skills/tool-openclaw
./scripts/update.sh --mode index

主なモードは次のとおりです。

• --mode seed：プレースホルダー、ヘッダーのない古いページ、古くなったページを更新します（古さの既定のしきい値：14 日）
• --mode full：現在の /llms.txt の対象ページをすべて更新します
• --mode sync：/llms.txt の対象ページを同期し、不足しているプレースホルダーを作成してインデックスを再構築します（ページの取得は行いません）
• --prune（任意）：/llms.txt の対象ページではなくなったローカルページを削除します
• --seed-max-age-days <n>（任意）：シードモードの鮮度を保つ期間を調整します（0 = 常に更新、<0 = 経過日数による更新を無効化）
• --mode index：__SNAPSHOT_INDEX.(md|json) のみを再構築します
• --mode single --url <url>：1 つのページを取得し、references/docs/** に反映します

任意のローカライズ（ベストエフォートで実行し、既定では英語にフォールバックします）。

./scripts/update.sh --mode seed --locale zh-CN

定期的なクリーンアップの推奨実行方法：

./scripts/update.sh --mode sync --prune

ドライラン検証（インデックスファイルを含め、ファイルへの書き込みは行いません）。

./scripts/update.sh --mode full --dry-run --prune

Node.js >= 18 が必要です。

コミュニティスキルの検索

awesome-clawdbot-skills のコミュニティ製 OpenClaw/Clawdbot スキルを検索します。

cd tool-openclaw
# If you are working inside this repo instead of an installed skill:
# cd skills/tool-openclaw
./scripts/search-skills.sh discord      # Search by keyword
./scripts/search-skills.sh pdf document # Multiple keywords
./scripts/search-skills.sh --list       # List categories
./scripts/search-skills.sh --refresh    # Force refresh cache

見つかったスキルをインストールするには、npx clawdhub@latest install <skill-slug> を実行します。

リソース

• スナップショットへの厳選された案内：references/entrypoints.md
• 移行監査のプロンプトとレポートの形式：references/model-migration-audit.md
• トラブルシューティングの手順書：references/troubleshooting.md
• スナップショットのメモと更新：references/docs_snapshot.md