--- read_when: - OpenClaw を初めてセットアップする - 一般的な設定パターンを探す - 特定の設定セクションへの移動 summary: '設定の概要: 一般的なタスク、クイックセットアップ、完全なリファレンスへのリンク' title: 設定 x-i18n: generated_at: "2026-07-02T08:00:04Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: a0044dd771effee8e11d5dfd99e6f14f105089328dcca23f5794ddff4995bca7 source_path: gateway/configuration.md workflow: 16 --- OpenClaw は、任意の **JSON5** 設定を `~/.openclaw/openclaw.json` から読み取ります。 アクティブな設定パスは通常ファイルである必要があります。シンボリックリンクされた `openclaw.json` レイアウトは、OpenClaw が所有する書き込みではサポートされません。アトミックな書き込みにより、 シンボリックリンクを保持する代わりにパスが置き換えられる場合があります。設定を 既定の状態ディレクトリ外に置く場合は、`OPENCLAW_CONFIG_PATH` が実体ファイルを直接指すようにしてください。 ファイルが存在しない場合、OpenClaw は安全な既定値を使用します。設定を追加する一般的な理由: - チャンネルを接続し、誰がボットにメッセージを送れるかを制御する - モデル、ツール、サンドボックス化、または自動化（cron、フック）を設定する - セッション、メディア、ネットワーク、または UI を調整する 利用可能なすべてのフィールドについては、[完全なリファレンス](/ja-JP/gateway/configuration-reference)を参照してください。 エージェントと自動化は、設定を編集する前に、正確なフィールド単位の ドキュメントとして `config.schema.lookup` を使用してください。このページはタスク指向のガイダンスに使用し、 より広いフィールドマップと既定値については [設定リファレンス](/ja-JP/gateway/configuration-reference)を使用してください。 **設定が初めてですか？** 対話型セットアップには `openclaw onboard` から始めるか、完全なコピー＆ペースト用設定については [設定例](/ja-JP/gateway/configuration-examples)ガイドを確認してください。 ## 最小設定 ```json5 // ~/.openclaw/openclaw.json { agents: { defaults: { workspace: "~/.openclaw/workspace" } }, channels: { whatsapp: { allowFrom: ["+15555550123"] } }, } ``` ## 設定の編集 ```bash openclaw onboard # full onboarding flow openclaw configure # config wizard ``` ```bash openclaw config get agents.defaults.workspace openclaw config set agents.defaults.heartbeat.every "2h" openclaw config unset plugins.entries.brave.config.webSearch.apiKey ``` [http://127.0.0.1:18789](http://127.0.0.1:18789) を開き、**Config** タブを使用します。 Control UI は、ライブ設定スキーマからフォームをレンダリングします。利用可能な場合はフィールドの `title` / `description` ドキュメントメタデータに加え、Plugin とチャンネルのスキーマも含み、 退避手段として **Raw JSON** エディタを提供します。ドリルダウン UI やその他のツール向けに、Gateway は `config.schema.lookup` も公開しており、 パススコープのスキーマノード 1 つと直下の子サマリーを取得できます。 `~/.openclaw/openclaw.json` を直接編集します。Gateway はファイルを監視し、変更を自動的に適用します（[ホットリロード](#config-hot-reload)を参照）。 ## 厳密な検証 OpenClaw はスキーマに完全に一致する設定のみを受け入れます。不明なキー、不正な型、または無効な値があると、Gateway は**起動を拒否**します。ルートレベルで唯一の例外は `$schema`（文字列）で、エディタが JSON Schema メタデータを付与できるようにするためのものです。 `openclaw config schema` は、Control UI と検証で使用される正規の JSON Schema を出力します。 `config.schema.lookup` は、ドリルダウンツール向けに、パススコープのノード 1 つと 子サマリーを取得します。フィールドの `title`/`description` ドキュメントメタデータは、 ネストされたオブジェクト、ワイルドカード（`*`）、配列アイテム（`[]`）、および `anyOf`/ `oneOf`/`allOf` ブランチに引き継がれます。ランタイムの Plugin とチャンネルのスキーマは、 マニフェストレジストリが読み込まれるとマージされます。 検証に失敗した場合: - Gateway は起動しません - 診断コマンドのみ動作します（`openclaw doctor`、`openclaw logs`、`openclaw health`、`openclaw status`） - 正確な問題を確認するには `openclaw doctor` を実行します - 修復を適用するには `openclaw doctor --fix`（または `--yes`）を実行します Gateway は起動に成功するたびに信頼済みの最後の正常なコピーを保持しますが、 起動とホットリロードではそれを自動的に復元しません。`openclaw.json` が 検証に失敗した場合（Plugin ローカルの検証を含む）、Gateway の起動は失敗するか、 リロードがスキップされ、現在のランタイムは最後に受け入れられた設定を保持します。 プレフィックス付きまたは壊れた設定を修復するか、最後の正常なコピーを復元するには、 `openclaw doctor --fix`（または `--yes`）を実行します。候補に `***` などの 秘匿済みシークレットプレースホルダーが含まれる場合、最後の正常なコピーへの昇格はスキップされます。 ## よくあるタスク 各チャンネルには `channels.` の下に独自の設定セクションがあります。セットアップ手順については、専用のチャンネルページを参照してください: - [WhatsApp](/ja-JP/channels/whatsapp) - `channels.whatsapp` - [Telegram](/ja-JP/channels/telegram) - `channels.telegram` - [Discord](/ja-JP/channels/discord) - `channels.discord` - [Feishu](/ja-JP/channels/feishu) - `channels.feishu` - [Google Chat](/ja-JP/channels/googlechat) - `channels.googlechat` - [Microsoft Teams](/ja-JP/channels/msteams) - `channels.msteams` - [Slack](/ja-JP/channels/slack) - `channels.slack` - [Signal](/ja-JP/channels/signal) - `channels.signal` - [iMessage](/ja-JP/channels/imessage) - `channels.imessage` - [Mattermost](/ja-JP/channels/mattermost) - `channels.mattermost` すべてのチャンネルは同じ DM ポリシーパターンを共有します: ```json5 { channels: { telegram: { enabled: true, botToken: "123:abc", dmPolicy: "pairing", // pairing | allowlist | open | disabled allowFrom: ["tg:123"], // only for allowlist/open }, }, } ``` プライマリモデルと任意のフォールバックを設定します: ```json5 { agents: { defaults: { model: { primary: "anthropic/claude-sonnet-4-6", fallbacks: ["openai/gpt-5.4"], }, models: { "anthropic/claude-sonnet-4-6": { alias: "Sonnet" }, "openai/gpt-5.4": { alias: "GPT" }, }, }, }, } ``` - `agents.defaults.models` はモデルカタログを定義し、`/model` の許可リストとして機能します。`provider/*` エントリは、動的モデル検出を引き続き使用しながら、`/model`、`/models`、モデルピッカーを選択されたプロバイダーに絞り込みます。 - 既存のモデルを削除せずに許可リストエントリを追加するには、`openclaw config set agents.defaults.models '' --strict-json --merge` を使用します。エントリを削除する通常の置換は、`--replace` を渡さない限り拒否されます。 - モデル参照は `provider/model` 形式を使用します（例: `anthropic/claude-opus-4-6`）。 - `agents.defaults.imageMaxDimensionPx` は、トランスクリプト/ツール画像の縮小を制御します（既定値 `1200`）。値を低くすると、通常はスクリーンショットが多い実行で vision-token の使用量が減ります。 - チャットでモデルを切り替える方法については [Models CLI](/ja-JP/concepts/models) を、認証ローテーションとフォールバック動作については [モデルフェイルオーバー](/ja-JP/concepts/model-failover) を参照してください。 - カスタム/セルフホストのプロバイダーについては、リファレンスの [カスタムプロバイダー](/ja-JP/gateway/config-tools#custom-providers-and-base-urls) を参照してください。 DM アクセスは `dmPolicy` を通じてチャンネルごとに制御されます: - `"pairing"`（既定）: 不明な送信者は承認用の一回限りのペアリングコードを受け取る - `"allowlist"`: `allowFrom`（またはペアリング済み許可ストア）内の送信者のみ - `"open"`: すべての受信 DM を許可する（`allowFrom: ["*"]` が必要） - `"disabled"`: すべての DM を無視する グループでは、`groupPolicy` + `groupAllowFrom` またはチャンネル固有の許可リストを使用します。 チャンネルごとの詳細については、[完全なリファレンス](/ja-JP/gateway/config-channels#dm-and-group-access)を参照してください。 グループメッセージは既定で**メンションを要求**します。エージェントごとにトリガーパターンを設定します。通常のグループ/チャンネル返信は自動的に投稿されます。エージェントが発言タイミングを判断すべき共有ルームでは、message-tool パスを明示的に有効にします: ```json5 { messages: { visibleReplies: "automatic", // set "message_tool" to require message-tool sends everywhere groupChat: { visibleReplies: "message_tool", // opt-in; visible output requires message(action=send) unmentionedInbound: "room_event", // unmentioned always-on group chatter is quiet context }, }, agents: { list: [ { id: "main", groupChat: { mentionPatterns: ["@openclaw", "openclaw"], }, }, ], }, channels: { whatsapp: { groups: { "*": { requireMention: true } }, }, }, } ``` - **メタデータメンション**: ネイティブ @メンション（WhatsApp のタップしてメンション、Telegram @bot など） - **テキストパターン**: `mentionPatterns` 内の安全な正規表現パターン - **表示される返信**: `messages.visibleReplies` はグローバルに message-tool 送信を要求できます。`messages.groupChat.visibleReplies` はグループ/チャンネルに対してそれを上書きします。 - 表示返信モード、チャンネルごとの上書き、セルフチャットモードについては、[完全なリファレンス](/ja-JP/gateway/config-channels#group-chat-mention-gating)を参照してください。 共有ベースラインには `agents.defaults.skills` を使用し、その後、特定の エージェントを `agents.list[].skills` で上書きします: ```json5 { agents: { defaults: { skills: ["github", "weather"], }, list: [ { id: "writer" }, // inherits github, weather { id: "docs", skills: ["docs-search"] }, // replaces defaults { id: "locked-down", skills: [] }, // no skills ], }, } ``` - 既定で Skills を制限しない場合は、`agents.defaults.skills` を省略します。 - 既定値を継承するには、`agents.list[].skills` を省略します。 - Skills なしにするには、`agents.list[].skills: []` を設定します。 - [Skills](/ja-JP/tools/skills)、[Skills 設定](/ja-JP/tools/skills-config)、および [設定リファレンス](/ja-JP/gateway/config-agents#agents-defaults-skills)を参照してください。 古くなったように見えるチャンネルを Gateway がどの程度積極的に再起動するかを制御します: ```json5 { gateway: { channelHealthCheckMinutes: 5, channelStaleEventThresholdMinutes: 30, channelMaxRestartsPerHour: 10, }, channels: { telegram: { healthMonitor: { enabled: false }, accounts: { alerts: { healthMonitor: { enabled: true }, }, }, }, }, } ``` - ヘルス監視による再起動をグローバルに無効化するには、`gateway.channelHealthCheckMinutes: 0` を設定します。 - `channelStaleEventThresholdMinutes` はチェック間隔以上にする必要があります。 - グローバル監視を無効にせず、1 つのチャンネルまたはアカウントの自動再起動を無効化するには、`channels..healthMonitor.enabled` または `channels..accounts..healthMonitor.enabled` を使用します。 - 運用時のデバッグについては [ヘルスチェック](/ja-JP/gateway/health) を、すべてのフィールドについては [完全なリファレンス](/ja-JP/gateway/configuration-reference#gateway) を参照してください。 負荷が高いホストや低性能ホストで、ローカルクライアントが認証前の WebSocket ハンドシェイクを完了する時間を 長くします: ```json5 { gateway: { handshakeTimeoutMs: 30000, }, } ``` - 既定値は `15000` ミリ秒です。 - `OPENCLAW_HANDSHAKE_TIMEOUT_MS` は、単発のサービスまたはシェルの上書きとして引き続き優先されます。 - まず起動時やイベントループの停止を修正することを優先してください。このノブは、正常だがウォームアップ中に遅いホスト向けです。 セッションは会話の継続性と分離を制御します: ```json5 { session: { dmScope: "per-channel-peer", // recommended for multi-user threadBindings: { enabled: true, idleHours: 24, maxAgeHours: 0, }, reset: { mode: "daily", atHour: 4, idleMinutes: 120, }, }, } ``` - `dmScope`: `main`（共有） | `per-peer` | `per-channel-peer` | `per-account-channel-peer` - `threadBindings`: スレッドに紐づくセッションルーティングのグローバルデフォルト（Discord は `/focus`、`/unfocus`、`/agents`、`/session idle`、`/session max-age` をサポートします）。 - スコープ、IDリンク、送信ポリシーについては [セッション管理](/ja-JP/concepts/session) を参照してください。 - すべてのフィールドについては [完全なリファレンス](/ja-JP/gateway/config-agents#session) を参照してください。 エージェントセッションを分離されたサンドボックスランタイムで実行します。 ```json5 { agents: { defaults: { sandbox: { mode: "non-main", // off | non-main | all scope: "agent", // session | agent | shared }, }, }, } ``` まずイメージをビルドします。ソースチェックアウトからは `scripts/sandbox-setup.sh` を実行し、npm インストールからは [サンドボックス化 § イメージとセットアップ](/ja-JP/gateway/sandboxing#images-and-setup) のインライン `docker build` コマンドを参照してください。 完全なガイドについては [サンドボックス化](/ja-JP/gateway/sandboxing)、すべてのオプションについては [完全なリファレンス](/ja-JP/gateway/config-agents#agentsdefaultssandbox) を参照してください。 公開 App Store ビルド向けのリレー経由プッシュは、ホストされた OpenClaw リレー `https://ios-push-relay.openclaw.ai` を使用します。 カスタムリレーデプロイには、リレー URL が Gateway のリレー URL と一致する、意図的に分離された iOS ビルド/デプロイ経路が必要です。カスタムリレービルドを使用している場合は、Gateway 設定でこれを指定します。 ```json5 { gateway: { push: { apns: { relay: { baseUrl: "https://relay.example.com", // Optional. Default: 10000 timeoutMs: 10000, }, }, }, }, } ``` CLI での同等操作: ```bash openclaw config set gateway.push.apns.relay.baseUrl https://relay.example.com ``` これが行うこと: - Gateway が `push.test`、ウェイク促進、再接続ウェイクを外部リレー経由で送信できるようにします。 - ペアリング済み iOS アプリによって転送される、登録スコープの送信許可を使用します。Gateway にデプロイ全体のリレートークンは不要です。 - 各リレー経由登録を、iOS アプリがペアリングした Gateway ID に紐づけるため、別の Gateway が保存済み登録を再利用することはできません。 - ローカル/手動 iOS ビルドは直接 APNs のままにします。リレー経由送信は、リレーを通じて登録された公式配布ビルドにのみ適用されます。 - iOS ビルドに組み込まれたリレーベース URL と一致している必要があり、登録トラフィックと送信トラフィックが同じリレーデプロイに到達します。 エンドツーエンドフロー: 1. 公式 iOS アプリをインストールします。 2. 任意: 意図的に分離されたカスタムリレービルドを使用する場合にのみ、Gateway で `gateway.push.apns.relay.baseUrl` を設定します。 3. iOS アプリを Gateway とペアリングし、node セッションとオペレーターセッションの両方を接続させます。 4. iOS アプリは Gateway ID を取得し、App Attest とアプリレシートを使ってリレーに登録してから、リレー経由の `push.apns.register` ペイロードをペアリング済み Gateway に公開します。 5. Gateway はリレーハンドルと送信許可を保存し、それらを `push.test`、ウェイク促進、再接続ウェイクに使用します。 運用上の注意: - iOS アプリを別の Gateway に切り替える場合は、その Gateway に紐づく新しいリレー登録をアプリが公開できるよう、アプリを再接続してください。 - 別のリレーデプロイを指す新しい iOS ビルドを出荷する場合、アプリは古いリレーオリジンを再利用せず、キャッシュ済みリレー登録を更新します。 互換性に関する注意: - `OPENCLAW_APNS_RELAY_BASE_URL` と `OPENCLAW_APNS_RELAY_TIMEOUT_MS` は、一時的な環境変数オーバーライドとして引き続き機能します。 - カスタム Gateway リレー URL は、iOS ビルドに組み込まれたリレーベース URL と一致している必要があります。公開 App Store リリースレーンは、カスタム iOS リレー URL オーバーライドを拒否します。 - `OPENCLAW_APNS_RELAY_ALLOW_HTTP=true` は local loopback 専用の開発用エスケープハッチのままです。HTTP リレー URL を設定に永続化しないでください。 エンドツーエンドフローについては [iOS アプリ](/ja-JP/platforms/ios#relay-backed-push-for-official-builds)、リレーのセキュリティモデルについては [認証と信頼フロー](/ja-JP/platforms/ios#authentication-and-trust-flow) を参照してください。 ```json5 { agents: { defaults: { heartbeat: { every: "30m", target: "last", }, }, }, } ``` - `every`: 期間文字列（`30m`、`2h`）。無効にするには `0m` を設定します。 - `target`: `last` | `none` | ``（例: `discord`、`matrix`、`telegram`、または `whatsapp`） - `directPolicy`: DM 形式の Heartbeat ターゲットに対して `allow`（デフォルト）または `block` - 完全なガイドについては [Heartbeat](/ja-JP/gateway/heartbeat) を参照してください。 ```json5 { cron: { enabled: true, maxConcurrentRuns: 8, // default; cron dispatch + isolated cron agent-turn execution sessionRetention: "24h", runLog: { maxBytes: "2mb", keepLines: 2000, }, }, } ``` - `sessionRetention`: 完了した分離実行セッションを `sessions.json` から削除します（デフォルトは `24h`。無効にするには `false` を設定）。 - `runLog`: ジョブごとに保持される Cron 実行履歴行を削除します。`maxBytes` は、古いファイルベースの実行ログ向けに引き続き受け入れられます。 - 機能概要と CLI 例については [Cron ジョブ](/ja-JP/automation/cron-jobs) を参照してください。 Gateway で HTTP Webhook エンドポイントを有効にします。 ```json5 { hooks: { enabled: true, token: "shared-secret", path: "/hooks", defaultSessionKey: "hook:ingress", allowRequestSessionKey: false, allowedSessionKeyPrefixes: ["hook:"], mappings: [ { match: { path: "gmail" }, action: "agent", agentId: "main", deliver: true, }, ], }, } ``` セキュリティ上の注意: - すべてのフック/Webhook ペイロード内容を信頼できない入力として扱ってください。 - 専用の `hooks.token` を使用してください。有効な Gateway 認証シークレット（`gateway.auth.token` / `OPENCLAW_GATEWAY_TOKEN` または `gateway.auth.password` / `OPENCLAW_GATEWAY_PASSWORD`）を再利用しないでください。 - フック認証はヘッダーのみです（`Authorization: Bearer ...` または `x-openclaw-token`）。クエリ文字列トークンは拒否されます。 - `hooks.path` を `/` にすることはできません。Webhook の受信は `/hooks` のような専用サブパスに保持してください。 - 厳密にスコープされたデバッグを行う場合を除き、安全でないコンテンツのバイパスフラグ（`hooks.gmail.allowUnsafeExternalContent`、`hooks.mappings[].allowUnsafeExternalContent`）は無効のままにしてください。 - `hooks.allowRequestSessionKey` を有効にする場合は、呼び出し元が選択するセッションキーを制限するために `hooks.allowedSessionKeyPrefixes` も設定してください。 - フック駆動エージェントでは、強力な最新モデル階層と厳格なツールポリシーを優先してください（例: 可能な場合はメッセージングのみとサンドボックス化）。 すべてのマッピングオプションと Gmail 連携については [完全なリファレンス](/ja-JP/gateway/configuration-reference#hooks) を参照してください。 個別のワークスペースとセッションを持つ複数の分離エージェントを実行します。 ```json5 { agents: { list: [ { id: "home", default: true, workspace: "~/.openclaw/workspace-home" }, { id: "work", workspace: "~/.openclaw/workspace-work" }, ], }, bindings: [ { agentId: "home", match: { channel: "whatsapp", accountId: "personal" } }, { agentId: "work", match: { channel: "whatsapp", accountId: "biz" } }, ], } ``` バインドルールとエージェントごとのアクセスプロファイルについては [マルチエージェント](/ja-JP/concepts/multi-agent) と [完全なリファレンス](/ja-JP/gateway/config-agents#multi-agent-routing) を参照してください。 大きな設定を整理するには `$include` を使用します。 ```json5 // ~/.openclaw/openclaw.json { gateway: { port: 18789 }, agents: { $include: "./agents.json5" }, broadcast: { $include: ["./clients/a.json5", "./clients/b.json5"], }, } ``` - **単一ファイル**: 含む側のオブジェクトを置き換えます - **ファイル配列**: 順番にディープマージされます（後のものが優先） - **兄弟キー**: include 後にマージされます（include された値を上書き） - **ネストされた include**: 最大 10 階層までサポートされます - **相対パス**: include しているファイルを基準に解決されます - **パス形式**: include パスには null バイトを含めてはならず、解決前後の両方で 4096 文字未満でなければなりません - **OpenClaw が所有する書き込み**: 書き込みが、`plugins: { $include: "./plugins.json5" }` のような単一ファイル include に支えられた 1 つのトップレベルセクションのみを変更する場合、OpenClaw はその include されたファイルを更新し、`openclaw.json` はそのままにします - **サポートされない書き込みスルー**: ルート include、include 配列、兄弟上書きを伴う include は、設定をフラット化する代わりに、OpenClaw が所有する書き込みに対して fail closed します - **閉じ込め**: `$include` パスは `openclaw.json` を保持するディレクトリ配下に解決される必要があります。マシン間またはユーザー間でツリーを共有するには、include が参照できる追加ディレクトリのパスリスト（POSIX では `:`、Windows では `;`）を `OPENCLAW_INCLUDE_ROOTS` に設定します。シンボリックリンクは解決されて再チェックされるため、字句上は設定ディレクトリ内にあるパスでも、実際のターゲットが許可されたすべてのルートから外れている場合は拒否されます。 - **エラー処理**: ファイル欠落、パースエラー、循環 include、無効なパス形式、過大な長さに対して明確なエラーを出します ## 設定のホットリロード Gateway は `~/.openclaw/openclaw.json` を監視し、変更を自動的に適用します。ほとんどの設定では手動再起動は不要です。 直接のファイル編集は、検証に通るまで信頼されません。ウォッチャーはエディターの一時書き込み/リネームの揺れが落ち着くのを待ち、最終ファイルを読み取り、無効な外部編集を `openclaw.json` を書き換えずに拒否します。OpenClaw が所有する設定書き込みは、書き込み前に同じスキーマゲートを使用します。`gateway.mode` の削除やファイルサイズを半分未満に縮小するような破壊的な上書きは拒否され、確認用に `.rejected.*` として保存されます。 `config reload skipped (invalid config)` が表示される場合、または起動時に `Invalid config` が報告される場合は、設定を確認し、`openclaw config validate` を実行してから、修復のために `openclaw doctor --fix` を実行してください。チェックリストについては [Gateway トラブルシューティング](/ja-JP/gateway/troubleshooting#gateway-rejected-invalid-config) を参照してください。 ### リロードモード | モード | 動作 | | ---------------------- | --------------------------------------------------------------------------------------- | | **`hybrid`**（デフォルト） | 安全な変更を即座にホット適用します。重要な変更では自動的に再起動します。 | | **`hot`** | 安全な変更のみをホット適用します。再起動が必要な場合は警告をログに出します。対応は手動です。 | | **`restart`** | 安全かどうかに関係なく、設定変更時に Gateway を再起動します。 | | **`off`** | ファイル監視を無効にします。変更は次回の手動再起動時に有効になります。 | ```json5 { gateway: { reload: { mode: "hybrid", debounceMs: 300 }, }, } ``` ### ホット適用されるものと再起動が必要なもの ほとんどのフィールドはダウンタイムなしでホット適用されます。`hybrid` モードでは、再起動が必要な変更は自動的に処理されます。 | カテゴリ | フィールド | 再起動が必要？ | | ------------------- | ----------------------------------------------------------------- | --------------- | | チャンネル | `channels.*`, `web` (WhatsApp) - すべての組み込みチャンネルと Plugin チャンネル | いいえ | | エージェントとモデル | `agent`, `agents`, `models`, `routing` | いいえ | | 自動化 | `hooks`, `cron`, `agent.heartbeat` | いいえ | | セッションとメッセージ | `session`, `messages` | いいえ | | ツールとメディア | `tools`, `browser`, `skills`, `mcp`, `audio`, `talk` | いいえ | | UI とその他 | `ui`, `logging`, `identity`, `bindings` | いいえ | | Gateway サーバー | `gateway.*` (port, bind, auth, tailscale, TLS, HTTP) | **はい** | | インフラストラクチャ | `discovery`, `plugins` | **はい** | `gateway.reload` と `gateway.remote` は例外です。これらを変更しても再起動はトリガーされ**ません**。 ### リロード計画 `$include` を通じて参照されるソースファイルを編集すると、OpenClaw は フラット化されたメモリ内ビューではなく、ソースで記述されたレイアウトから リロードを計画します。これにより、`plugins: { $include: "./plugins.json5" }` のように 単一のトップレベルセクションが独自のインクルードファイルにある場合でも、 ホットリロードの判断（ホット適用か再起動か）が予測しやすくなります。 ソースレイアウトが曖昧な場合、リロード計画は安全側に倒れて失敗します。 ## Config RPC（プログラムによる更新） Gateway API 経由で設定を書き込むツールでは、次のフローを推奨します。 - `config.schema.lookup` で 1 つのサブツリーを調べる（浅いスキーマノード + 子の 要約） - `config.get` で現在のスナップショットと `hash` を取得する - `config.patch` で部分更新する（JSON マージパッチ: オブジェクトはマージされ、`null` は削除され、配列は、エントリが削除される場合に `replacePaths` で明示的に確認されたときのみ置換される） - 設定全体を置き換える意図がある場合のみ `config.apply` を使う - 明示的な自己更新と再起動には `update.run` を使う。再起動後のセッションで 1 回のフォローアップターンを実行する必要がある場合は `continuationMessage` を含める - `update.status` で最新の更新再起動センチネルを調べ、再起動後に実行中のバージョンを確認する エージェントは、正確なフィールドレベルのドキュメントと制約の最初の参照先として `config.schema.lookup` を扱うべきです。より広い設定マップ、デフォルト、または専用の サブシステムリファレンスへのリンクが必要な場合は、[設定リファレンス](/ja-JP/gateway/configuration-reference) を使ってください。 コントロールプレーンの書き込み（`config.apply`, `config.patch`, `update.run`）は、 `deviceId+clientIp` ごとに 60 秒あたり 3 リクエストにレート制限されます。再起動 リクエストは統合され、その後、再起動サイクル間に 30 秒のクールダウンが適用されます。 `update.status` は読み取り専用ですが、再起動センチネルに 更新ステップの要約やコマンド出力の末尾が含まれる可能性があるため、管理者スコープです。 部分パッチの例: ```bash openclaw gateway call config.get --params '{}' # capture payload.hash openclaw gateway call config.patch --params '{ "raw": "{ channels: { telegram: { groups: { \"*\": { requireMention: false } } } } }", "baseHash": "" }' ``` `config.apply` と `config.patch` はどちらも `raw`, `baseHash`, `sessionKey`, `note`, `restartDelayMs` を受け取ります。設定がすでに存在する場合、`baseHash` は 両方のメソッドで必須です。 `config.patch` は、配列置換が意図的である設定パスの配列 `replacePaths` も受け取ります。 パッチが既存の配列をより少ないエントリで置換または削除しようとする場合、その正確なパスが `replacePaths` に含まれていない限り、Gateway は書き込みを拒否します。配列エントリ配下の ネストされた配列には、`agents.list[].skills` のように `[]` を使います。これにより、 切り詰められた `config.get` スナップショットがルーティングや許可リストの配列を 暗黙に上書きすることを防ぎます。完全な設定を置き換える意図がある場合は `config.apply` を使ってください。 ## 環境変数 OpenClaw は親プロセスに加えて、次から環境変数を読み取ります。 - 現在の作業ディレクトリの `.env`（存在する場合） - `~/.openclaw/.env`（グローバルフォールバック） どちらのファイルも既存の環境変数を上書きしません。設定内でインライン環境変数を設定することもできます。 ```json5 { env: { OPENROUTER_API_KEY: "sk-or-...", vars: { GROQ_API_KEY: "gsk-..." }, }, } ``` 有効化され、期待されるキーが設定されていない場合、OpenClaw はログインシェルを実行し、不足しているキーのみをインポートします。 ```json5 { env: { shellEnv: { enabled: true, timeoutMs: 15000 }, }, } ``` 環境変数での同等指定: `OPENCLAW_LOAD_SHELL_ENV=1` 任意の設定文字列値で `${VAR_NAME}` を使って環境変数を参照します。 ```json5 { gateway: { auth: { token: "${OPENCLAW_GATEWAY_TOKEN}" } }, models: { providers: { custom: { apiKey: "${CUSTOM_API_KEY}" } } }, } ``` ルール: - 一致するのは大文字の名前のみ: `[A-Z_][A-Z0-9_]*` - 未設定または空の変数は読み込み時にエラーを投げる - リテラル出力には `$${VAR}` でエスケープする - `$include` ファイル内でも動作する - インライン置換: `"${BASE}/v1"` → `"https://api.example.com/v1"` SecretRef オブジェクトをサポートするフィールドでは、次を使用できます。 ```json5 { models: { providers: { openai: { apiKey: { source: "env", provider: "default", id: "OPENAI_API_KEY" } }, }, }, skills: { entries: { "image-lab": { apiKey: { source: "file", provider: "filemain", id: "/skills/entries/image-lab/apiKey", }, }, }, }, channels: { googlechat: { serviceAccountRef: { source: "exec", provider: "vault", id: "channels/googlechat/serviceAccount", }, }, }, } ``` SecretRef の詳細（`env`/`file`/`exec` 用の `secrets.providers` を含む）は [シークレット管理](/ja-JP/gateway/secrets) にあります。 サポートされる認証情報パスは [SecretRef 認証情報サーフェス](/ja-JP/reference/secretref-credential-surface) に一覧されています。 完全な優先順位とソースについては、[環境](/ja-JP/help/environment) を参照してください。 ## 完全なリファレンス フィールドごとの完全なリファレンスについては、**[設定リファレンス](/ja-JP/gateway/configuration-reference)** を参照してください。 --- _関連: [設定例](/ja-JP/gateway/configuration-examples) · [設定リファレンス](/ja-JP/gateway/configuration-reference) · [Doctor](/ja-JP/gateway/doctor)_ ## 関連 - [設定リファレンス](/ja-JP/gateway/configuration-reference) - [設定例](/ja-JP/gateway/configuration-examples) - [Gateway ランブック](/ja-JP/gateway)