{"id":120,"date":"2026-03-21T22:47:18","date_gmt":"2026-03-21T14:47:18","guid":{"rendered":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/gateway-configuration\/"},"modified":"2026-03-21T23:29:02","modified_gmt":"2026-03-21T15:29:02","slug":"gateway-configuration","status":"publish","type":"post","link":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/gateway-configuration\/","title":{"rendered":"\u914d\u7f6e"},"content":{"rendered":"<h1>\u914d\u7f6e<\/h1>\n<p>OpenClaw \u4f1a\u4ece <code>~\/.openclaw\/openclaw.json<\/code> \u8bfb\u53d6\u53ef\u9009\u7684 <strong>JSON5<\/strong> \u914d\u7f6e\u3002<\/p>\n<p>\u5982\u679c\u8be5\u6587\u4ef6\u7f3a\u5931\uff0cOpenClaw \u4f1a\u4f7f\u7528\u5b89\u5168\u7684\u9ed8\u8ba4\u503c\u3002\u6dfb\u52a0\u914d\u7f6e\u7684\u5e38\u89c1\u539f\u56e0\u5305\u62ec\uff1a<\/p>\n<ul>\n<li>\u8fde\u63a5\u6e20\u9053\u5e76\u63a7\u5236\u8c01\u53ef\u4ee5\u5411 bot \u53d1\u6d88\u606f<\/li>\n<li>\u8bbe\u7f6e\u6a21\u578b\u3001\u5de5\u5177\u3001\u6c99\u7bb1\u9694\u79bb\u6216\u81ea\u52a8\u5316\uff08cron\u3001hooks\uff09<\/li>\n<li>\u8c03\u6574\u4f1a\u8bdd\u3001\u5a92\u4f53\u3001\u7f51\u7edc\u6216 UI<\/li>\n<\/ul>\n<p>\u6240\u6709\u53ef\u7528\u5b57\u6bb5\u8bf7\u53c2\u9605 <a href=\"https:\/\/pa.yingzhi8.cn\/?p=122\">\u5b8c\u6574\u53c2\u8003<\/a>\u3002<\/p>\n<p>\n  <strong>\u521a\u63a5\u89e6\u914d\u7f6e\uff1f<\/strong> \u4ece <code>openclaw onboard<\/code> \u5f00\u59cb\u8fdb\u884c\u4ea4\u4e92\u5f0f\u8bbe\u7f6e\uff0c\u6216\u8005\u67e5\u770b <a href=\"https:\/\/pa.yingzhi8.cn\/?p=121\">\u914d\u7f6e\u8bf4\u660e Examples<\/a> \u6307\u5357\uff0c\u83b7\u53d6\u5b8c\u6574\u7684\u53ef\u590d\u5236\u7c98\u8d34\u914d\u7f6e\u3002\n<\/p>\n<h2>\u6700\u5c0f\u914d\u7f6e<\/h2>\n<p>&#8220;`json5  theme={&#8220;theme&#8221;:{&#8220;light&#8221;:&#8221;min-light&#8221;,&#8221;dark&#8221;:&#8221;min-dark&#8221;}}<br \/>\n\/\/ ~\/.openclaw\/openclaw.json<br \/>\n{<br \/>\n  agents: { defaults: { workspace: &#8220;~\/.openclaw\/workspace&#8221; } },<br \/>\n  \u6e20\u9053s: { whatsapp: { allowFrom: [&#8220;+15555550123&#8221;] } },<br \/>\n}<\/p>\n<pre><code>\n## \u7f16\u8f91\u914d\u7f6e\n\n&lt;Tabs&gt;\n  &lt;Tab title=&quot;Interactive wizard&quot;&gt;\n    ```bash  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\n    openclaw onboard       # \u5b8c\u6574\u8bbe\u7f6e\u5411\u5bfc\n    openclaw configure     # \u914d\u7f6e\u5411\u5bfc\n    ```\n  &lt;\/Tab&gt;\n\n  &lt;Tab title=&quot;CLI (one-liners)&quot;&gt;\n    ```bash  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\n    openclaw config get agents.defaults.workspace\n    openclaw config set agents.defaults.heartbeat.every &quot;2h&quot;\n    openclaw config unset plugins.entries.brave.config.webSearch.apiKey\n    ```\n  &lt;\/Tab&gt;\n\n  &lt;Tab title=&quot;Control UI&quot;&gt;\n    \u6253\u5f00 [http:\/\/127.0.0.1:18789](http:\/\/127.0.0.1:18789) \u5e76\u4f7f\u7528 **Config** \u6807\u7b7e\u9875\u3002\n    Control UI \u4f1a\u6839\u636e\u914d\u7f6e schema \u6e32\u67d3\u8868\u5355\uff0c\u5e76\u63d0\u4f9b **Raw JSON** \u7f16\u8f91\u5668\u4f5c\u4e3a\u540e\u5907\u65b9\u5f0f\u3002\n  &lt;\/Tab&gt;\n\n  &lt;Tab title=&quot;Direct edit&quot;&gt;\n    \u76f4\u63a5\u7f16\u8f91 `~\/.openclaw\/openclaw.json`\u3002Gateway \u7f51\u5173\u4f1a\u76d1\u89c6\u8be5\u6587\u4ef6\u5e76\u81ea\u52a8\u5e94\u7528\u66f4\u6539\uff08\u53c2\u89c1[\u70ed\u91cd\u8f7d](#config-hot-reload)\uff09\u3002\n  &lt;\/Tab&gt;\n&lt;\/Tabs&gt;\n\n## \u4e25\u683c\u6821\u9a8c\n\n&lt;Warning&gt;\n  OpenClaw \u53ea\u63a5\u53d7\u5b8c\u5168\u7b26\u5408 schema \u7684\u914d\u7f6e\u3002\u672a\u77e5\u952e\u3001\u7c7b\u578b\u683c\u5f0f\u9519\u8bef\u6216\u65e0\u6548\u503c\u90fd\u4f1a\u5bfc\u81f4 Gateway \u7f51\u5173**\u62d2\u7edd\u542f\u52a8**\u3002\u552f\u4e00\u7684\u6839\u7ea7\u4f8b\u5916\u662f `$schema`\uff08\u5b57\u7b26\u4e32\uff09\uff0c\u8fd9\u6837\u7f16\u8f91\u5668\u5c31\u53ef\u4ee5\u9644\u52a0 JSON Schema \u5143\u6570\u636e\u3002\n&lt;\/Warning&gt;\n\n\u5f53\u6821\u9a8c\u5931\u8d25\u65f6\uff1a\n\n* Gateway \u7f51\u5173\u4e0d\u4f1a\u542f\u52a8\n* \u53ea\u6709\u8bca\u65ad\u547d\u4ee4\u53ef\u7528\uff08`openclaw doctor`\u3001`openclaw logs`\u3001`openclaw health`\u3001`openclaw status`\uff09\n* \u8fd0\u884c `openclaw doctor` \u4ee5\u67e5\u770b\u5177\u4f53\u95ee\u9898\n* \u8fd0\u884c `openclaw doctor --fix`\uff08\u6216 `--yes`\uff09\u4ee5\u5e94\u7528\u4fee\u590d\n\n## \u5e38\u89c1\u4efb\u52a1\n\n&lt;AccordionGroup&gt;\n  &lt;Accordion title=&quot;\u8bbe\u7f6e\u4e00\u4e2a\u6e20\u9053\uff08WhatsApp\u3001Telegram\u3001Discord \u7b49\uff09&quot;&gt;\n    \u6bcf\u4e2a\u6e20\u9053\u5728 `channels.&lt;provider&gt;` \u4e0b\u90fd\u6709\u5404\u81ea\u7684\u914d\u7f6e\u90e8\u5206\u3002\u8bbe\u7f6e\u6b65\u9aa4\u8bf7\u53c2\u9605\u5bf9\u5e94\u7684\u6e20\u9053\u9875\u9762\uff1a\n\n    * [WhatsApp](\/channels\/whatsapp) \u2014 `channels.whatsapp`\n    * [Telegram](\/channels\/telegram) \u2014 `channels.telegram`\n    * [Discord](\/channels\/discord) \u2014 `channels.discord`\n    * [Slack](\/channels\/slack) \u2014 `channels.slack`\n    * [Signal](\/channels\/signal) \u2014 `channels.signal`\n    * [iMessage](\/channels\/imessage) \u2014 `channels.imessage`\n    * [Google Chat](\/channels\/googlechat) \u2014 `channels.googlechat`\n    * [Mattermost](\/channels\/mattermost) \u2014 `channels.mattermost`\n    * [MS Teams](\/channels\/msteams) \u2014 `channels.msteams`\n\n    \u6240\u6709\u6e20\u9053\u90fd\u5171\u4eab\u540c\u4e00\u79cd\u79c1\u4fe1\u7b56\u7565\u6a21\u5f0f\uff1a\n\n    ```json5  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\n    {\n      channels: {\n        telegram: {\n          enabled: true,\n          botToken: &quot;123:abc&quot;,\n          dmPolicy: &quot;pairing&quot;,   \/\/ pairing | allowlist | open | disabled\n          allowFrom: [&quot;tg:123&quot;], \/\/ \u4ec5\u7528\u4e8e allowlist\/open\n        },\n      },\n    }\n    ```\n  &lt;\/Accordion&gt;\n\n  &lt;Accordion title=&quot;\u9009\u62e9\u5e76\u914d\u7f6e\u6a21\u578b&quot;&gt;\n    \u8bbe\u7f6e\u4e3b\u6a21\u578b\u548c\u53ef\u9009\u56de\u9000\u6a21\u578b\uff1a\n\n    ```json5  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\n    {\n      agents: {\n        defaults: {\n          model: {\n            primary: &quot;anthropic\/claude-sonnet-4-5&quot;,\n            fallbacks: [&quot;openai\/gpt-5.2&quot;],\n          },\n          models: {\n            &quot;anthropic\/claude-sonnet-4-5&quot;: { alias: &quot;Sonnet&quot; },\n            &quot;openai\/gpt-5.2&quot;: { alias: &quot;GPT&quot; },\n          },\n        },\n      },\n    }\n    ```\n\n    * `agents.defaults.models` \u5b9a\u4e49\u6a21\u578b\u76ee\u5f55\uff0c\u5e76\u5145\u5f53 `\/model` \u7684\u5141\u8bb8\u5217\u8868\u3002\n    * \u6a21\u578b\u5f15\u7528\u4f7f\u7528 `provider\/model` \u683c\u5f0f\uff08\u4f8b\u5982 `anthropic\/claude-opus-4-6`\uff09\u3002\n    * `agents.defaults.imageMaxDimensionPx` \u63a7\u5236\u8f6c\u5f55\/\u5de5\u5177\u56fe\u50cf\u7684\u7f29\u653e\u4e0b\u9650\uff08\u9ed8\u8ba4 `1200`\uff09\uff1b\u5728\u622a\u56fe\u8f83\u591a\u7684\u8fd0\u884c\u4e2d\uff0c\u8f83\u4f4e\u7684\u503c\u901a\u5e38\u4f1a\u51cf\u5c11\u89c6\u89c9 token \u4f7f\u7528\u91cf\u3002\n    * \u5173\u4e8e\u5728\u804a\u5929\u4e2d\u5207\u6362\u6a21\u578b\uff0c\u8bf7\u53c2\u9605 [Models CLI](\/concepts\/models)\uff1b\u5173\u4e8e\u51ed\u8bc1\u8f6e\u6362\u548c\u56de\u9000\u884c\u4e3a\uff0c\u8bf7\u53c2\u9605 [Model Failover](\/concepts\/model-failover)\u3002\n    * \u5173\u4e8e\u81ea\u5b9a\u4e49\/\u81ea\u6258\u7ba1\u63d0\u4f9b\u5546\uff0c\u8bf7\u53c2\u9605\u53c2\u8003\u4e2d\u7684 [Custom providers](\/gateway\/configuration-reference#custom-providers-and-base-urls)\u3002\n  &lt;\/Accordion&gt;\n\n  &lt;Accordion title=&quot;\u63a7\u5236\u8c01\u53ef\u4ee5\u5411 bot \u53d1\u6d88\u606f&quot;&gt;\n    \u79c1\u4fe1\u8bbf\u95ee\u901a\u8fc7\u6bcf\u4e2a\u6e20\u9053\u7684 `dmPolicy` \u63a7\u5236\uff1a\n\n    * `&quot;pairing&quot;`\uff08\u9ed8\u8ba4\uff09\uff1a\u672a\u77e5\u53d1\u9001\u8005\u4f1a\u6536\u5230\u4e00\u6b21\u6027\u914d\u5bf9\u7801\u4ee5\u4f9b\u6279\u51c6\n    * `&quot;allowlist&quot;`\uff1a\u4ec5\u5141\u8bb8 `allowFrom`\uff08\u6216\u5df2\u914d\u5bf9\u5141\u8bb8\u5b58\u50a8\uff09\u4e2d\u7684\u53d1\u9001\u8005\n    * `&quot;open&quot;`\uff1a\u5141\u8bb8\u6240\u6709\u5165\u7ad9\u79c1\u4fe1\uff08\u9700\u8981 `allowFrom: [&quot;*&quot;]`\uff09\n    * `&quot;disabled&quot;`\uff1a\u5ffd\u7565\u6240\u6709\u79c1\u4fe1\n\n    \u5bf9\u4e8e\u7fa4\u7ec4\uff0c\u8bf7\u4f7f\u7528 `groupPolicy` + `groupAllowFrom` \u6216\u7279\u5b9a\u6e20\u9053\u7684\u5141\u8bb8\u5217\u8868\u3002\n\n    \u6709\u5173\u6bcf\u4e2a\u6e20\u9053\u7684\u8be6\u7ec6\u4fe1\u606f\uff0c\u8bf7\u53c2\u9605 [\u5b8c\u6574\u53c2\u8003](\/gateway\/configuration-reference#dm-and-group-access)\u3002\n  &lt;\/Accordion&gt;\n\n  &lt;Accordion title=&quot;\u8bbe\u7f6e\u7fa4\u804a\u63d0\u53ca\u95e8\u63a7&quot;&gt;\n    \u7fa4\u7ec4\u6d88\u606f\u9ed8\u8ba4\u8bbe\u7f6e\u4e3a**\u9700\u8981\u63d0\u53ca**\u3002\u53ef\u6309\u667a\u80fd\u4f53\u914d\u7f6e\u6a21\u5f0f\uff1a\n\n    ```json5  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\n    {\n      agents: {\n        list: [\n          {\n            id: &quot;main&quot;,\n            groupChat: {\n              mentionPatterns: [&quot;@openclaw&quot;, &quot;openclaw&quot;],\n            },\n          },\n        ],\n      },\n      channels: {\n        whatsapp: {\n          groups: { &quot;*&quot;: { requireMention: true } },\n        },\n      },\n    }\n    ```\n\n    * **\u5143\u6570\u636e\u63d0\u53ca**\uff1a\u539f\u751f @ \u63d0\u53ca\uff08WhatsApp \u70b9\u6309\u63d0\u53ca\u3001Telegram @bot \u7b49\uff09\n    * **\u6587\u672c\u6a21\u5f0f**\uff1a`mentionPatterns` \u4e2d\u7684\u5b89\u5168\u6b63\u5219\u6a21\u5f0f\n    * \u5173\u4e8e\u6bcf\u4e2a\u6e20\u9053\u7684\u8986\u76d6\u548c\u81ea\u804a\u6a21\u5f0f\uff0c\u8bf7\u53c2\u9605 [\u5b8c\u6574\u53c2\u8003](\/gateway\/configuration-reference#group-chat-mention-gating)\u3002\n  &lt;\/Accordion&gt;\n\n  &lt;Accordion title=&quot;\u8c03\u6574 Gateway \u7f51\u5173\u6e20\u9053\u5065\u5eb7\u76d1\u63a7&quot;&gt;\n    \u63a7\u5236 Gateway \u7f51\u5173\u5bf9\u770b\u8d77\u6765\u5931\u6d3b\u7684\u6e20\u9053\u6267\u884c\u91cd\u542f\u7684\u79ef\u6781\u7a0b\u5ea6\uff1a\n\n    ```json5  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\n    {\n      gateway: {\n        channelHealthCheckMinutes: 5,\n        channelStaleEventThresholdMinutes: 30,\n        channelMaxRestartsPerHour: 10,\n      },\n      channels: {\n        telegram: {\n          healthMonitor: { enabled: false },\n          accounts: {\n            alerts: {\n              healthMonitor: { enabled: true },\n            },\n          },\n        },\n      },\n    }\n    ```\n\n    * \u8bbe\u7f6e `gateway.channelHealthCheckMinutes: 0` \u53ef\u5168\u5c40\u7981\u7528\u5065\u5eb7\u76d1\u63a7\u91cd\u542f\u3002\n    * `channelStaleEventThresholdMinutes` \u5e94\u5927\u4e8e\u6216\u7b49\u4e8e\u68c0\u67e5\u95f4\u9694\u3002\n    * \u4f7f\u7528 `channels.&lt;provider&gt;.healthMonitor.enabled` \u6216 `channels.&lt;provider&gt;.accounts.&lt;id&gt;.healthMonitor.enabled`\uff0c\u53ef\u4e3a\u5355\u4e2a\u6e20\u9053\u6216\u8d26\u53f7\u7981\u7528\u81ea\u52a8\u91cd\u542f\uff0c\u800c\u65e0\u9700\u7981\u7528\u5168\u5c40\u76d1\u63a7\u3002\n    * \u6709\u5173\u8fd0\u7ef4\u8c03\u8bd5\uff0c\u8bf7\u53c2\u9605 [Health Checks](\/gateway\/health)\uff1b\u6240\u6709\u5b57\u6bb5\u8bf7\u53c2\u9605 [\u5b8c\u6574\u53c2\u8003](\/gateway\/configuration-reference#gateway)\u3002\n  &lt;\/Accordion&gt;\n\n  &lt;Accordion title=&quot;\u914d\u7f6e\u4f1a\u8bdd\u548c\u91cd\u7f6e&quot;&gt;\n    \u4f1a\u8bdd\u63a7\u5236\u5bf9\u8bdd\u7684\u8fde\u7eed\u6027\u548c\u9694\u79bb\u6027\uff1a\n\n    ```json5  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\n    {\n      session: {\n        dmScope: &quot;per-channel-peer&quot;,  \/\/ \u63a8\u8350\u7528\u4e8e\u591a\u7528\u6237\n        threadBindings: {\n          enabled: true,\n          idleHours: 24,\n          maxAgeHours: 0,\n        },\n        reset: {\n          mode: &quot;daily&quot;,\n          atHour: 4,\n          idleMinutes: 120,\n        },\n      },\n    }\n    ```\n\n    * `dmScope`\uff1a`main`\uff08\u5171\u4eab\uff09| `per-peer` | `per-channel-peer` | `per-account-channel-peer`\n    * `threadBindings`\uff1a\u7ebf\u7a0b\u7ed1\u5b9a\u4f1a\u8bdd\u8def\u7531\u7684\u5168\u5c40\u9ed8\u8ba4\u503c\uff08Discord \u652f\u6301 `\/focus`\u3001`\/unfocus`\u3001`\/agents`\u3001`\/session idle` \u548c `\/session max-age`\uff09\u3002\n    * \u5173\u4e8e\u4f5c\u7528\u57df\u3001\u8eab\u4efd\u94fe\u63a5\u548c\u53d1\u9001\u7b56\u7565\uff0c\u8bf7\u53c2\u9605 [Session Management](\/concepts\/session)\u3002\n    * \u6240\u6709\u5b57\u6bb5\u8bf7\u53c2\u9605 [\u5b8c\u6574\u53c2\u8003](\/gateway\/configuration-reference#session)\u3002\n  &lt;\/Accordion&gt;\n\n  &lt;Accordion title=&quot;\u542f\u7528\u6c99\u7bb1\u9694\u79bb&quot;&gt;\n    \u5728\u9694\u79bb\u7684 Docker \u5bb9\u5668\u4e2d\u8fd0\u884c\u667a\u80fd\u4f53\u4f1a\u8bdd\uff1a\n\n    ```json5  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\n    {\n      agents: {\n        defaults: {\n          sandbox: {\n            mode: &quot;non-main&quot;,  \/\/ off | non-main | all\n            scope: &quot;agent&quot;,    \/\/ session | agent | shared\n          },\n        },\n      },\n    }\n    ```\n\n    \u5148\u6784\u5efa\u955c\u50cf\uff1a`scripts\/sandbox-setup.sh`\n\n    \u5b8c\u6574\u6307\u5357\u8bf7\u53c2\u9605 [Sandboxing](\/gateway\/sandboxing)\uff0c\u6240\u6709\u9009\u9879\u8bf7\u53c2\u9605 [\u5b8c\u6574\u53c2\u8003](\/gateway\/configuration-reference#sandbox)\u3002\n  &lt;\/Accordion&gt;\n\n  &lt;Accordion title=&quot;\u4e3a\u5b98\u65b9 iOS \u6784\u5efa\u542f\u7528\u57fa\u4e8e relay \u7684\u63a8\u9001&quot;&gt;\n    \u57fa\u4e8e relay \u7684\u63a8\u9001\u5728 `openclaw.json` \u4e2d\u914d\u7f6e\u3002\n\n    \u5728 Gateway \u7f51\u5173\u914d\u7f6e\u4e2d\u8bbe\u7f6e\uff1a\n\n    ```json5  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\n    {\n      gateway: {\n        push: {\n          apns: {\n            relay: {\n              baseUrl: &quot;https:\/\/relay.example.com&quot;,\n              \/\/ \u53ef\u9009\u3002\u9ed8\u8ba4\u503c\uff1a10000\n              timeoutMs: 10000,\n            },\n          },\n        },\n      },\n    }\n    ```\n\n    \u7b49\u4ef7 CLI\uff1a\n\n    ```bash  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\n    openclaw config set gateway.push.apns.relay.baseUrl https:\/\/relay.example.com\n    ```\n\n    \u8fd9\u4f1a\u5e26\u6765\u4ee5\u4e0b\u6548\u679c\uff1a\n\n    * \u8ba9 Gateway \u7f51\u5173\u901a\u8fc7\u5916\u90e8 relay \u53d1\u9001 `push.test`\u3001\u5524\u9192\u63d0\u793a\u548c\u91cd\u8fde\u5524\u9192\u3002\n    * \u4f7f\u7528\u7531\u5df2\u914d\u5bf9 iOS \u5e94\u7528\u8f6c\u53d1\u7684\u3001\u4ee5\u6ce8\u518c\u4e3a\u8303\u56f4\u7684\u53d1\u9001\u6388\u6743\u3002Gateway \u7f51\u5173\u4e0d\u9700\u8981\u90e8\u7f72\u8303\u56f4\u7684 relay token\u3002\n    * \u5c06\u6bcf\u4e2a\u57fa\u4e8e relay \u7684\u6ce8\u518c\u7ed1\u5b9a\u5230 iOS \u5e94\u7528\u914d\u5bf9\u7684 Gateway \u7f51\u5173\u8eab\u4efd\uff0c\u56e0\u6b64\u5176\u4ed6 Gateway \u7f51\u5173\u65e0\u6cd5\u590d\u7528\u5df2\u5b58\u50a8\u7684\u6ce8\u518c\u3002\n    * \u4fdd\u6301\u672c\u5730\/\u624b\u52a8 iOS \u6784\u5efa\u7ee7\u7eed\u4f7f\u7528\u76f4\u63a5 APNs\u3002\u57fa\u4e8e relay \u7684\u53d1\u9001\u4ec5\u9002\u7528\u4e8e\u901a\u8fc7 relay \u6ce8\u518c\u7684\u5b98\u65b9\u5206\u53d1\u6784\u5efa\u3002\n    * \u5fc5\u987b\u4e0e\u5b98\u65b9\/TestFlight iOS \u6784\u5efa\u4e2d\u56fa\u5316\u7684 relay \u57fa\u7840 URL \u4e00\u81f4\uff0c\u8fd9\u6837\u6ce8\u518c\u548c\u53d1\u9001\u6d41\u91cf\u624d\u80fd\u5230\u8fbe\u540c\u4e00\u4e2a relay \u90e8\u7f72\u3002\n\n    \u7aef\u5230\u7aef\u6d41\u7a0b\uff1a\n\n    1. \u5b89\u88c5\u4e00\u4e2a\u4f7f\u7528\u76f8\u540c relay \u57fa\u7840 URL \u7f16\u8bd1\u7684\u5b98\u65b9\/TestFlight iOS \u6784\u5efa\u3002\n    2. \u5728 Gateway \u7f51\u5173\u4e0a\u914d\u7f6e `gateway.push.apns.relay.baseUrl`\u3002\n    3. \u5c06 iOS \u5e94\u7528\u4e0e Gateway \u7f51\u5173\u914d\u5bf9\uff0c\u5e76\u8ba9\u8282\u70b9\u4f1a\u8bdd\u548c\u64cd\u4f5c\u5458\u4f1a\u8bdd\u90fd\u8fde\u63a5\u3002\n    4. iOS \u5e94\u7528\u83b7\u53d6 Gateway \u7f51\u5173\u8eab\u4efd\uff0c\u4f7f\u7528 App Attest \u52a0\u4e0a\u5e94\u7528\u56de\u6267\u5411 relay \u6ce8\u518c\uff0c\u7136\u540e\u5c06\u57fa\u4e8e relay \u7684 `push.apns.register` \u8d1f\u8f7d\u53d1\u5e03\u5230\u5df2\u914d\u5bf9\u7684 Gateway \u7f51\u5173\u3002\n    5. Gateway \u7f51\u5173\u5b58\u50a8 relay handle \u548c\u53d1\u9001\u6388\u6743\uff0c\u7136\u540e\u5c06\u5b83\u4eec\u7528\u4e8e `push.test`\u3001\u5524\u9192\u63d0\u793a\u548c\u91cd\u8fde\u5524\u9192\u3002\n\n    \u8fd0\u7ef4\u8bf4\u660e\uff1a\n\n    * \u5982\u679c\u4f60\u5c06 iOS \u5e94\u7528\u5207\u6362\u5230\u53e6\u4e00\u4e2a Gateway \u7f51\u5173\uff0c\u8bf7\u91cd\u65b0\u8fde\u63a5\u5e94\u7528\uff0c\u4ee5\u4fbf\u5b83\u53d1\u5e03\u7ed1\u5b9a\u5230\u8be5 Gateway \u7f51\u5173\u7684\u65b0 relay \u6ce8\u518c\u3002\n    * \u5982\u679c\u4f60\u53d1\u5e03\u4e86\u4e00\u4e2a\u6307\u5411\u4e0d\u540c relay \u90e8\u7f72\u7684\u65b0 iOS \u6784\u5efa\uff0c\u5e94\u7528\u4f1a\u5237\u65b0\u5176\u7f13\u5b58\u7684 relay \u6ce8\u518c\uff0c\u800c\u4e0d\u662f\u590d\u7528\u65e7\u7684 relay \u6765\u6e90\u3002\n\n    \u517c\u5bb9\u6027\u8bf4\u660e\uff1a\n\n    * `OPENCLAW_APNS_RELAY_BASE_URL` \u548c `OPENCLAW_APNS_RELAY_TIMEOUT_MS` \u4ecd\u53ef\u4f5c\u4e3a\u4e34\u65f6\u73af\u5883\u53d8\u91cf\u8986\u76d6\u4f7f\u7528\u3002\n    * `OPENCLAW_APNS_RELAY_ALLOW_HTTP=true` \u4ecd\u662f\u4ec5\u9650 loopback \u7684\u5f00\u53d1\u9003\u751f\u53e3\uff1b\u4e0d\u8981\u5728\u914d\u7f6e\u4e2d\u6301\u4e45\u5316 HTTP relay URL\u3002\n\n    \u5173\u4e8e\u7aef\u5230\u7aef\u6d41\u7a0b\uff0c\u8bf7\u53c2\u9605 [iOS App](\/platforms\/ios#relay-backed-push-for-official-builds)\uff1b\u5173\u4e8e relay \u5b89\u5168\u6a21\u578b\uff0c\u8bf7\u53c2\u9605 [Authentication and trust flow](\/platforms\/ios#authentication-and-trust-flow)\u3002\n  &lt;\/Accordion&gt;\n\n  &lt;Accordion title=&quot;\u8bbe\u7f6e heartbeat\uff08\u5468\u671f\u6027\u62a5\u5230\uff09&quot;&gt;\n    ```json5  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\n    {\n      agents: {\n        defaults: {\n          heartbeat: {\n            every: &quot;30m&quot;,\n            target: &quot;last&quot;,\n          },\n        },\n      },\n    }\n    ```\n\n    * `every`\uff1a\u65f6\u957f\u5b57\u7b26\u4e32\uff08`30m`\u3001`2h`\uff09\u3002\u8bbe\u7f6e\u4e3a `0m` \u53ef\u7981\u7528\u3002\n    * `target`\uff1a`last` | `whatsapp` | `telegram` | `discord` | `none`\n    * `directPolicy`\uff1a\u7528\u4e8e\u79c1\u4fe1\u98ce\u683c heartbeat \u76ee\u6807\u65f6\uff0c\u8bbe\u4e3a `allow`\uff08\u9ed8\u8ba4\uff09\u6216 `block`\n    * \u5b8c\u6574\u6307\u5357\u8bf7\u53c2\u9605 [Heartbeat](\/gateway\/heartbeat)\u3002\n  &lt;\/Accordion&gt;\n\n  &lt;Accordion title=&quot;\u914d\u7f6e cron \u4f5c\u4e1a&quot;&gt;\n    ```json5  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\n    {\n      cron: {\n        enabled: true,\n        maxConcurrentRuns: 2,\n        sessionRetention: &quot;24h&quot;,\n        runLog: {\n          maxBytes: &quot;2mb&quot;,\n          keepLines: 2000,\n        },\n      },\n    }\n    ```\n\n    * `sessionRetention`\uff1a\u4ece `sessions.json` \u4e2d\u6e05\u7406\u5df2\u5b8c\u6210\u7684\u9694\u79bb\u8fd0\u884c\u4f1a\u8bdd\uff08\u9ed8\u8ba4 `24h`\uff1b\u8bbe\u7f6e\u4e3a `false` \u53ef\u7981\u7528\uff09\u3002\n    * `runLog`\uff1a\u6309\u5927\u5c0f\u548c\u4fdd\u7559\u884c\u6570\u6e05\u7406 `cron\/runs\/&lt;jobId&gt;.jsonl`\u3002\n    * \u529f\u80fd\u6982\u89c8\u548c CLI \u793a\u4f8b\u8bf7\u53c2\u9605 [Cron jobs](\/automation\/cron-jobs)\u3002\n  &lt;\/Accordion&gt;\n\n  &lt;Accordion title=&quot;\u8bbe\u7f6e webhooks\uff08hooks\uff09&quot;&gt;\n    \u5728 Gateway \u7f51\u5173\u4e0a\u542f\u7528 HTTP webhook \u7aef\u70b9\uff1a\n\n    ```json5  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\n    {\n      hooks: {\n        enabled: true,\n        token: &quot;shared-secret&quot;,\n        path: &quot;\/hooks&quot;,\n        defaultSessionKey: &quot;hook:ingress&quot;,\n        allowRequestSessionKey: false,\n        allowedSessionKeyPrefixes: [&quot;hook:&quot;],\n        mappings: [\n          {\n            match: { path: &quot;gmail&quot; },\n            action: &quot;agent&quot;,\n            agentId: &quot;main&quot;,\n            deliver: true,\n          },\n        ],\n      },\n    }\n    ```\n\n    \u5b89\u5168\u8bf4\u660e\uff1a\n\n    * \u5c06\u6240\u6709 hook\/webhook \u8d1f\u8f7d\u5185\u5bb9\u90fd\u89c6\u4e3a\u4e0d\u53d7\u4fe1\u4efb\u8f93\u5165\u3002\n    * \u4fdd\u6301\u4e0d\u5b89\u5168\u5185\u5bb9\u7ed5\u8fc7\u6807\u5fd7\u5904\u4e8e\u7981\u7528\u72b6\u6001\uff08`hooks.gmail.allowUnsafeExternalContent`\u3001`hooks.mappings[].allowUnsafeExternalContent`\uff09\uff0c\u9664\u975e\u662f\u5728\u8fdb\u884c\u4e25\u683c\u9650\u5b9a\u7684\u8c03\u8bd5\u3002\n    * \u5bf9\u4e8e\u7531 hook \u9a71\u52a8\u7684\u667a\u80fd\u4f53\uff0c\u4f18\u5148\u4f7f\u7528\u5f3a\u5927\u7684\u73b0\u4ee3\u6a21\u578b\u5c42\u7ea7\u548c\u4e25\u683c\u7684\u5de5\u5177\u7b56\u7565\uff08\u4f8b\u5982\u5c3d\u53ef\u80fd\u4ec5\u5141\u8bb8\u6d88\u606f\u4f20\u9012\u5e76\u542f\u7528\u6c99\u7bb1\u9694\u79bb\uff09\u3002\n\n    \u6240\u6709\u6620\u5c04\u9009\u9879\u548c Gmail \u96c6\u6210\u8bf7\u53c2\u9605 [\u5b8c\u6574\u53c2\u8003](\/gateway\/configuration-reference#hooks)\u3002\n  &lt;\/Accordion&gt;\n\n  &lt;Accordion title=&quot;\u914d\u7f6e\u591a\u667a\u80fd\u4f53\u8def\u7531&quot;&gt;\n    \u8fd0\u884c\u591a\u4e2a\u5f7c\u6b64\u9694\u79bb\u7684\u667a\u80fd\u4f53\uff0c\u5e76\u4f7f\u7528\u72ec\u7acb\u7684\u5de5\u4f5c\u533a\u548c\u4f1a\u8bdd\uff1a\n\n    ```json5  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\n    {\n      agents: {\n        list: [\n          { id: &quot;home&quot;, default: true, workspace: &quot;~\/.openclaw\/workspace-home&quot; },\n          { id: &quot;work&quot;, workspace: &quot;~\/.openclaw\/workspace-work&quot; },\n        ],\n      },\n      bindings: [\n        { agentId: &quot;home&quot;, match: { channel: &quot;whatsapp&quot;, accountId: &quot;personal&quot; } },\n        { agentId: &quot;work&quot;, match: { channel: &quot;whatsapp&quot;, accountId: &quot;biz&quot; } },\n      ],\n    }\n    ```\n\n    \u5173\u4e8e\u7ed1\u5b9a\u89c4\u5219\u548c\u6bcf\u4e2a\u667a\u80fd\u4f53\u7684\u8bbf\u95ee\u914d\u7f6e\u6587\u4ef6\uff0c\u8bf7\u53c2\u9605 [Multi-Agent](\/concepts\/multi-agent) \u548c [\u5b8c\u6574\u53c2\u8003](\/gateway\/configuration-reference#multi-agent-routing)\u3002\n  &lt;\/Accordion&gt;\n\n  &lt;Accordion title=&quot;\u5c06\u914d\u7f6e\u62c6\u5206\u5230\u591a\u4e2a\u6587\u4ef6\u4e2d\uff08$include\uff09&quot;&gt;\n    \u4f7f\u7528 `$include` \u7ec4\u7ec7\u5927\u578b\u914d\u7f6e\uff1a\n\n    ```json5  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\n    \/\/ ~\/.openclaw\/openclaw.json\n    {\n      gateway: { port: 18789 },\n      agents: { $include: &quot;.\/agents.json5&quot; },\n      broadcast: {\n        $include: [&quot;.\/clients\/a.json5&quot;, &quot;.\/clients\/b.json5&quot;],\n      },\n    }\n    ```\n\n    * **\u5355\u4e2a\u6587\u4ef6**\uff1a\u66ff\u6362\u6240\u5728\u5bf9\u8c61\n    * **\u6587\u4ef6\u6570\u7ec4**\uff1a\u6309\u987a\u5e8f\u6df1\u5ea6\u5408\u5e76\uff08\u540e\u8005\u4f18\u5148\uff09\n    * **\u540c\u7ea7\u952e**\uff1a\u5728 include \u4e4b\u540e\u5408\u5e76\uff08\u8986\u76d6\u5df2\u5305\u542b\u7684\u503c\uff09\n    * **\u5d4c\u5957 include**\uff1a\u652f\u6301\uff0c\u6700\u591a 10 \u5c42\u6df1\n    * **\u76f8\u5bf9\u8def\u5f84**\uff1a\u76f8\u5bf9\u4e8e\u5305\u542b\u5b83\u7684\u6587\u4ef6\u89e3\u6790\n    * **\u9519\u8bef\u5904\u7406**\uff1a\u5bf9\u4e8e\u7f3a\u5931\u6587\u4ef6\u3001\u89e3\u6790\u9519\u8bef\u548c\u5faa\u73af include\uff0c\u4f1a\u63d0\u4f9b\u6e05\u6670\u9519\u8bef\n  &lt;\/Accordion&gt;\n&lt;\/AccordionGroup&gt;\n\n## \u914d\u7f6e\u70ed\u91cd\u8f7d\n\nGateway \u7f51\u5173\u4f1a\u76d1\u89c6 `~\/.openclaw\/openclaw.json` \u5e76\u81ea\u52a8\u5e94\u7528\u66f4\u6539 \u2014\u2014 \u5bf9\u4e8e\u5927\u591a\u6570\u8bbe\u7f6e\uff0c\u65e0\u9700\u624b\u52a8\u91cd\u542f\u3002\n\n### \u91cd\u8f7d\u6a21\u5f0f\n\n| \u6a21\u5f0f               | \u884c\u4e3a                             |\n| ---------------- | ------------------------------ |\n| **`hybrid`**\uff08\u9ed8\u8ba4\uff09 | \u7acb\u5373\u70ed\u5e94\u7528\u5b89\u5168\u66f4\u6539\u3002\u5bf9\u5173\u952e\u66f4\u6539\u4f1a\u81ea\u52a8\u91cd\u542f\u3002          |\n| **`hot`**        | \u4ec5\u70ed\u5e94\u7528\u5b89\u5168\u66f4\u6539\u3002\u9700\u8981\u91cd\u542f\u65f6\u4f1a\u8bb0\u5f55\u8b66\u544a \u2014\u2014 \u7531\u4f60\u81ea\u884c\u5904\u7406\u3002 |\n| **`restart`**    | \u4efb\u4f55\u914d\u7f6e\u66f4\u6539\u90fd\u4f1a\u91cd\u542f Gateway \u7f51\u5173\uff0c\u65e0\u8bba\u662f\u5426\u5b89\u5168\u3002  |\n| **`off`**        | \u7981\u7528\u6587\u4ef6\u76d1\u89c6\u3002\u66f4\u6539\u4f1a\u5728\u4e0b\u4e00\u6b21\u624b\u52a8\u91cd\u542f\u65f6\u751f\u6548\u3002         |\n\n```json5  theme={&quot;theme&quot;:{&quot;light&quot;:&quot;min-light&quot;,&quot;dark&quot;:&quot;min-dark&quot;}}\n{\n  gateway: {\n    reload: { mode: &quot;hybrid&quot;, debounceMs: 300 },\n  },\n}\n<\/code><\/pre>\n<h3>\u54ea\u4e9b\u53ef\u4ee5\u70ed\u5e94\u7528\uff0c\u54ea\u4e9b\u9700\u8981\u91cd\u542f<\/h3>\n<p>\u5927\u591a\u6570\u5b57\u6bb5\u90fd\u53ef\u4ee5\u65e0\u505c\u673a\u70ed\u5e94\u7528\u3002\u5728 <code>hybrid<\/code> \u6a21\u5f0f\u4e0b\uff0c\u9700\u8981\u91cd\u542f\u7684\u66f4\u6539\u4f1a\u81ea\u52a8\u5904\u7406\u3002<\/p>\n<table>\n<thead>\n<tr>\n<th>\u7c7b\u522b<\/th>\n<th>\u5b57\u6bb5<\/th>\n<th>\u9700\u8981\u91cd\u542f\uff1f<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>\u6e20\u9053<\/td>\n<td><code>channels.*<\/code>\u3001<code>web<\/code>\uff08WhatsApp\uff09\u2014 \u6240\u6709\u5185\u7f6e\u548c\u6269\u5c55\u6e20\u9053<\/td>\n<td>\u5426<\/td>\n<\/tr>\n<tr>\n<td>\u667a\u80fd\u4f53\u548c\u6a21\u578b<\/td>\n<td><code>agent<\/code>\u3001<code>agents<\/code>\u3001<code>models<\/code>\u3001<code>routing<\/code><\/td>\n<td>\u5426<\/td>\n<\/tr>\n<tr>\n<td>\u81ea\u52a8\u5316<\/td>\n<td><code>hooks<\/code>\u3001<code>cron<\/code>\u3001<code>agent.heartbeat<\/code><\/td>\n<td>\u5426<\/td>\n<\/tr>\n<tr>\n<td>\u4f1a\u8bdd\u548c\u6d88\u606f<\/td>\n<td><code>session<\/code>\u3001<code>messages<\/code><\/td>\n<td>\u5426<\/td>\n<\/tr>\n<tr>\n<td>\u5de5\u5177\u548c\u5a92\u4f53<\/td>\n<td><code>tools<\/code>\u3001<code>browser<\/code>\u3001<code>skills<\/code>\u3001<code>audio<\/code>\u3001<code>talk<\/code><\/td>\n<td>\u5426<\/td>\n<\/tr>\n<tr>\n<td>UI \u548c\u6742\u9879<\/td>\n<td><code>ui<\/code>\u3001<code>logging<\/code>\u3001<code>identity<\/code>\u3001<code>bindings<\/code><\/td>\n<td>\u5426<\/td>\n<\/tr>\n<tr>\n<td>Gateway \u7f51\u5173 \u7f51\u5173\u670d\u52a1\u5668<\/td>\n<td><code>gateway.*<\/code>\uff08port\u3001bind\u3001auth\u3001tailscale\u3001TLS\u3001HTTP\uff09<\/td>\n<td><strong>\u662f<\/strong><\/td>\n<\/tr>\n<tr>\n<td>\u57fa\u7840\u8bbe\u65bd<\/td>\n<td><code>discovery<\/code>\u3001<code>canvasHost<\/code>\u3001<code>plugins<\/code><\/td>\n<td><strong>\u662f<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>\n  <code>gateway.reload<\/code> \u548c <code>gateway.remote<\/code> \u662f\u4f8b\u5916 \u2014\u2014 \u66f4\u6539\u5b83\u4eec<strong>\u4e0d\u4f1a<\/strong>\u89e6\u53d1\u91cd\u542f\u3002<br \/>\n<\/\u8bf4\u660e><\/p>\n<h2>\u914d\u7f6e RPC\uff08\u7a0b\u5e8f\u5316\u66f4\u65b0\uff09<\/h2>\n<p>\n  \u63a7\u5236\u5e73\u9762\u5199\u5165 RPC\uff08<code>config.apply<\/code>\u3001<code>config.patch<\/code>\u3001<code>update.run<\/code>\uff09\u6309\u6bcf\u4e2a <code>deviceId+clientIp<\/code> \u9650\u5236\u4e3a<strong>\u6bcf 60 \u79d2 3 \u4e2a\u8bf7\u6c42<\/strong>\u3002\u5f53\u89e6\u53d1\u9650\u5236\u65f6\uff0cRPC \u4f1a\u8fd4\u56de <code>UNAVAILABLE<\/code> \u548c <code>retryAfterMs<\/code>\u3002<br \/>\n<\/\u8bf4\u660e><\/p>\n<p>    \u6821\u9a8c + \u5199\u5165\u5b8c\u6574\u914d\u7f6e\uff0c\u5e76\u5728\u4e00\u6b65\u4e2d\u91cd\u542f Gateway \u7f51\u5173 \u7f51\u5173\u3002<\/p>\n<pre><code>&lt;Warning&gt;\n  `config.apply` \u4f1a\u66ff\u6362**\u6574\u4e2a\u914d\u7f6e**\u3002\u90e8\u5206\u66f4\u65b0\u8bf7\u4f7f\u7528 `config.patch`\uff0c\u5355\u4e2a\u952e\u8bf7\u4f7f\u7528 `openclaw config set`\u3002\n&lt;\/Warning&gt;\n\n\u53c2\u6570\uff1a\n\n* `raw`\uff08string\uff09\u2014 \u6574\u4e2a\u914d\u7f6e\u7684 JSON5 \u8d1f\u8f7d\n* `baseHash`\uff08\u53ef\u9009\uff09\u2014 \u6765\u81ea `config.get` \u7684\u914d\u7f6e hash\uff08\u914d\u7f6e\u5df2\u5b58\u5728\u65f6\u5fc5\u9700\uff09\n* `sessionKey`\uff08\u53ef\u9009\uff09\u2014 \u91cd\u542f\u540e\u5524\u9192 ping \u4f7f\u7528\u7684\u4f1a\u8bdd\u952e\n* `note`\uff08\u53ef\u9009\uff09\u2014 \u91cd\u542f\u54e8\u5175\u7684\u8bf4\u660e\n* `restartDelayMs`\uff08\u53ef\u9009\uff09\u2014 \u91cd\u542f\u524d\u5ef6\u8fdf\uff08\u9ed8\u8ba4 2000\uff09\n\n\u5f53\u5df2\u6709\u91cd\u542f\u5904\u4e8e\u5f85\u5904\u7406\/\u8fdb\u884c\u4e2d\u65f6\uff0c\u91cd\u542f\u8bf7\u6c42\u4f1a\u88ab\u5408\u5e76\uff0c\u5e76\u4e14\u4e24\u6b21\u91cd\u542f\u5468\u671f\u4e4b\u95f4\u4f1a\u5e94\u7528 30 \u79d2\u51b7\u5374\u3002\n\n```bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\nopenclaw gateway call config.get --params '{}'  # \u6355\u83b7 payload.hash\nopenclaw gateway call config.apply --params '{\n  \"raw\": \"{ agents: { defaults: { workspace: \"~\/.openclaw\/workspace\" } } }\",\n  \"baseHash\": \"&lt;hash&gt;\",\n  \"sessionKey\": \"agent:main:whatsapp:direct:+15555550123\"\n}'\n```\n<\/code><\/pre>\n<\/p>\n<p>\n    \u5c06\u90e8\u5206\u66f4\u65b0\u5408\u5e76\u5230\u73b0\u6709\u914d\u7f6e\u4e2d\uff08JSON merge patch \u8bed\u4e49\uff09\uff1a<\/p>\n<pre><code>* \u5bf9\u8c61\u9012\u5f52\u5408\u5e76\n* `null` \u5220\u9664\u952e\n* \u6570\u7ec4\u6574\u4f53\u66ff\u6362\n\n\u53c2\u6570\uff1a\n\n* `raw`\uff08string\uff09\u2014 \u4ec5\u5305\u542b\u8981\u66f4\u6539\u952e\u7684 JSON5\n* `baseHash`\uff08\u5fc5\u9700\uff09\u2014 \u6765\u81ea `config.get` \u7684\u914d\u7f6e hash\n* `sessionKey`\u3001`note`\u3001`restartDelayMs` \u2014 \u4e0e `config.apply` \u76f8\u540c\n\n\u91cd\u542f\u884c\u4e3a\u4e0e `config.apply` \u4e00\u81f4\uff1a\u5408\u5e76\u5f85\u5904\u7406\u91cd\u542f\uff0c\u5e76\u5728\u4e24\u6b21\u91cd\u542f\u5468\u671f\u4e4b\u95f4\u5e94\u7528 30 \u79d2\u51b7\u5374\u3002\n\n```bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\nopenclaw gateway call config.patch --params '{\n  \"raw\": \"{ channels: { telegram: { groups: { \"*\": { requireMention: false } } } } }\",\n  \"baseHash\": \"&lt;hash&gt;\"\n}'\n```\n<\/code><\/pre>\n<\/p>\n<h2>\u73af\u5883\u53d8\u91cf<\/h2>\n<p>OpenClaw \u4f1a\u4ece\u7236\u8fdb\u7a0b\u8bfb\u53d6\u73af\u5883\u53d8\u91cf\uff0c\u53e6\u5916\u8fd8\u4f1a\u8bfb\u53d6\uff1a<\/p>\n<ul>\n<li>\u5f53\u524d\u5de5\u4f5c\u76ee\u5f55\u4e2d\u7684 <code>.env<\/code>\uff08\u5982\u679c\u5b58\u5728\uff09<\/li>\n<li><code>~\/.openclaw\/.env<\/code>\uff08\u5168\u5c40\u56de\u9000\uff09<\/li>\n<\/ul>\n<p>\u8fd9\u4e24\u4e2a\u6587\u4ef6\u90fd\u4e0d\u4f1a\u8986\u76d6\u73b0\u6709\u73af\u5883\u53d8\u91cf\u3002\u4f60\u4e5f\u53ef\u4ee5\u5728\u914d\u7f6e\u4e2d\u8bbe\u7f6e\u5185\u8054\u73af\u5883\u53d8\u91cf\uff1a<\/p>\n<p><code>json5  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}<br \/>\n{<br \/>\n  env: {<br \/>\n    OPENROUTER_API_KEY: \"sk-or-...\",<br \/>\n    vars: { GROQ_API_KEY: \"gsk-...\" },<br \/>\n  },<br \/>\n}<\/code><\/p>\n<p>\n  \u5982\u679c\u542f\u7528\uff0c\u5e76\u4e14\u9884\u671f\u952e\u540d\u5c1a\u672a\u8bbe\u7f6e\uff0cOpenClaw \u4f1a\u8fd0\u884c\u4f60\u7684\u767b\u5f55 shell\uff0c\u5e76\u4e14\u53ea\u5bfc\u5165\u7f3a\u5931\u7684\u952e\uff1a<\/p>\n<p><code>json5  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}<br \/>\n  {<br \/>\n    env: {<br \/>\n      shellEnv: { enabled: true, timeoutMs: 15000 },<br \/>\n    },<br \/>\n  }<\/code><\/p>\n<p>\u73af\u5883\u53d8\u91cf\u7b49\u4ef7\u9879\uff1a<code>OPENCLAW_LOAD_SHELL_ENV=1<\/code>\n<\/p>\n<p>\n  \u4f60\u53ef\u4ee5\u5728\u4efb\u4f55\u914d\u7f6e\u5b57\u7b26\u4e32\u503c\u4e2d\u4f7f\u7528 <code>${VAR_NAME}<\/code> \u5f15\u7528\u73af\u5883\u53d8\u91cf\uff1a<\/p>\n<p><code>json5  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}<br \/>\n  {<br \/>\n    gateway: { auth: { token: \"${OPENCLAW_GATEWAY_TOKEN}\" } },<br \/>\n    models: { providers: { custom: { apiKey: \"${CUSTOM_API_KEY}\" } } },<br \/>\n  }<\/code><\/p>\n<p>\u89c4\u5219\uff1a<\/p>\n<ul>\n<li>\u4ec5\u5339\u914d\u5927\u5199\u540d\u79f0\uff1a<code>[A-Z_][A-Z0-9_]*<\/code><\/li>\n<li>\u7f3a\u5931\/\u4e3a\u7a7a\u7684\u53d8\u91cf\u4f1a\u5728\u52a0\u8f7d\u65f6\u629b\u51fa\u9519\u8bef<\/li>\n<li>\u4f7f\u7528 <code>$${VAR}<\/code> \u8fdb\u884c\u8f6c\u4e49\uff0c\u4ee5\u8f93\u51fa\u5b57\u9762\u503c<\/li>\n<li>\u5728 <code>$include<\/code> \u6587\u4ef6\u4e2d\u4e5f\u53ef\u7528<\/li>\n<li>\u5185\u8054\u66ff\u6362\uff1a<code>\"${BASE}\/v1\"<\/code> \u2192 <code>\"https:\/\/api.example.com\/v1\"<\/code>\n<\/li>\n<\/ul>\n<p>\n  \u5bf9\u4e8e\u652f\u6301 SecretRef \u5bf9\u8c61\u7684\u5b57\u6bb5\uff0c\u4f60\u53ef\u4ee5\u4f7f\u7528\uff1a<\/p>\n<p><code>json5  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}<br \/>\n  {<br \/>\n    models: {<br \/>\n      providers: {<br \/>\n        openai: { apiKey: { source: \"env\", provider: \"default\", id: \"OPENAI_API_KEY\" } },<br \/>\n      },<br \/>\n    },<br \/>\n    skills: {<br \/>\n      entries: {<br \/>\n        \"nano-banana-pro\": {<br \/>\n          apiKey: {<br \/>\n            source: \"file\",<br \/>\n            provider: \"filemain\",<br \/>\n            id: \"\/skills\/entries\/nano-banana-pro\/apiKey\",<br \/>\n          },<br \/>\n        },<br \/>\n      },<br \/>\n    },<br \/>\n    channels: {<br \/>\n      googlechat: {<br \/>\n        serviceAccountRef: {<br \/>\n          source: \"exec\",<br \/>\n          provider: \"vault\",<br \/>\n          id: \"channels\/googlechat\/serviceAccount\",<br \/>\n        },<br \/>\n      },<br \/>\n    },<br \/>\n  }<\/code><\/p>\n<p>SecretRef \u8be6\u60c5\uff08\u5305\u62ec <code>env<\/code>\/<code>file<\/code>\/<code>exec<\/code> \u7684 <code>secrets.providers<\/code>\uff09\u8bf7\u53c2\u9605 <a href=\"https:\/\/pa.yingzhi8.cn\/?p=611\">Secrets Management<\/a>\u3002<br \/>\n  \u652f\u6301\u7684\u51ed\u8bc1\u8def\u5f84\u5217\u5728 <a href=\"https:\/\/pa.yingzhi8.cn\/?p=635\">SecretRef Credential Surface<\/a> \u4e2d\u3002\n<\/p>\n<p>\u6709\u5173\u5b8c\u6574\u4f18\u5148\u7ea7\u548c\u6765\u6e90\uff0c\u8bf7\u53c2\u9605 <a href=\"https:\/\/pa.yingzhi8.cn\/?p=146\">Environment<\/a>\u3002<\/p>\n<h2>\u5b8c\u6574\u53c2\u8003<\/h2>\n<p>\u6709\u5173\u9010\u5b57\u6bb5\u7684\u5b8c\u6574\u53c2\u8003\uff0c\u8bf7\u53c2\u9605 <strong><a href=\"https:\/\/pa.yingzhi8.cn\/?p=122\">\u914d\u7f6e\u8bf4\u660e Reference<\/a><\/strong>\u3002<\/p>\n<hr \/>\n<p><em>\u76f8\u5173\u5185\u5bb9\uff1a<a href=\"https:\/\/pa.yingzhi8.cn\/?p=121\">\u914d\u7f6e\u8bf4\u660e Examples<\/a> \u00b7 <a href=\"https:\/\/pa.yingzhi8.cn\/?p=122\">\u914d\u7f6e\u8bf4\u660e Reference<\/a> \u00b7 <a href=\"https:\/\/pa.yingzhi8.cn\/?p=124\">Doctor<\/a><\/em><\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u914d\u7f6e OpenClaw \u4f1a\u4ece ~\/.openclaw\/openclaw.json \u8bfb\u53d6\u53ef\u9009\u7684 JSON5 \u914d\u7f6e [&hellip;]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-120","post","type-post","status-publish","format-standard","hentry","category-docs"],"_links":{"self":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/120","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/comments?post=120"}],"version-history":[{"count":2,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/120\/revisions"}],"predecessor-version":[{"id":833,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/120\/revisions\/833"}],"wp:attachment":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/media?parent=120"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/categories?post=120"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/tags?post=120"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}