OpenClaw Config Helper - 設定変更安全アシスタント

⚠️ 強制ルール

OpenClaw の設定を変更する前に、必ず以下の手順を完了してください。さもないと、システムがクラッシュしたり、機能が異常になったりする可能性があります！

このスキルを使用する場合

• ユーザーが OpenClaw の設定（openclaw.json、agents 設定、channels 設定など）の変更を要求した場合
• ユーザーが Telegram、WhatsApp などのチャネル設定の追加/変更を要求した場合
• ユーザーが bindings、models、agents.list などの変更を要求した場合
• gateway action=config.patch または gateway action=config.apply を含む操作

トリガーワード

• "設定を変更"
• "openclaw の設定を少し変更"
• "binding を追加"
• "telegram/whatsapp を設定"
• "groupPolicy を変更"
• "agent を追加"

強制フロー（必ず順番に実行）

ステップ 1: Schema の確認

# 完全な設定 schema を取得
gateway action=config.schema

チェックポイント：

• 変更するフィールドのタイプ（string/number/array/object）を確認
• フィールドが必須かどうかを確認
• フィールドの許容値（enum）を確認
• ネスト構造を確認

ステップ 2: 公式ドキュメントの確認（schema が十分に明確でない場合）

# web_fetch を使用して公式ドキュメントを取得
web_fetch: https://docs.openclaw.ai/channels/telegram
web_fetch: https://docs.openclaw.ai/channels/whatsapp
web_fetch: https://docs.openclaw.ai/gateway/configuration-reference

または検索を使用：

cd ~/clawd/skills/tavily && ./scripts/tavily.sh search "OpenClaw <設定項目> 設定"

ステップ 3: 変更案の提示と確認

ユーザーに以下を提示：

1. 現在の設定（該当する場合）
2. 計画された変更（具体的な JSON スニペット）
3. 変更の理由
4. 起こりうる影響

ユーザーの確認を待ってから変更を実行してください！

ステップ 4: 変更の実行

# config.patch を使用して部分的な変更を行う（推奨）
gateway action=config.patch raw='{"変更するパス": "値"}'

# または config.apply を使用して完全な置換を行う（慎重に使用）
gateway action=config.apply raw='{"完全な設定": "..."}'

ステップ 5: 変更の検証

# 設定が有効になっているか確認
gateway action=config.get

# Gateway の状態を確認
openclaw status

よくある設定エラーの事例

事例 1: Telegram groupAllowFrom エラー (2026-02-22)

エラー：グループ ID を groupAllowFrom に配置

// ❌ エラー
"groupAllowFrom": [-1003531486855, YOUR_GROUP_CHAT_ID]  // これはグループ ID であり、ユーザー ID ではありません！

// ✅ 正しい
"groupAllowFrom": ["YOUR_TELEGRAM_ID"]  // ユーザー ID
"groups": {
  "-1003531486855": {"groupPolicy": "open", "requireMention": true}
}

教訓：groupAllowFrom は送信者のホワイトリスト（ユーザー ID）、groups はグループのホワイトリスト（グループ ID）

事例 2: binding の欠落により bot が応答しない

エラー：メイン bot (default account) がどの agent にもバインドされていない

// ❌ default → main のバインドが欠落
"bindings": [
  {"agentId": "ops", "match": {"accountId": "xiaoops"}},
  // ... 他の bot、ただし default はない
]

// ✅ 必ず追加
"bindings": [
  {"agentId": "main", "match": {"channel": "telegram", "accountId": "default"}},
  // ... 他の
]

事例 3: pass: 形式の apiKey はサポートされていません

エラー：OpenClaw は pass: 形式の apiKey 参照をサポートしていません

// ❌ エラー
"apiKey": "pass:api/xingsuancode"  // 文字列として直接送信されます

// ✅ 正しい
"apiKey": "sk-f873092ea177b75b..."  // 実際のキーをハードコードする必要があります

クイックリファレンス

チェックリスト

設定を変更する前に、以下を確認してください。

• [ ] config.schema を確認してフィールドタイプを確認した
• [ ] 公式ドキュメントを確認して使用法を確認した
• [ ] 変更案をユーザーに提示し、確認を得た
• [ ] config.apply ではなく config.patch を使用する（必要な場合を除く）
• [ ] 変更後に設定が有効になっていることを検証する

覚えておいてください

設定を安易に変更しないでください！まずドキュメントを確認し、次に設定を変更してください！