{"id":122,"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-reference\/"},"modified":"2026-03-21T23:29:03","modified_gmt":"2026-03-21T15:29:03","slug":"gateway-configuration-reference","status":"publish","type":"post","link":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/gateway-configuration-reference\/","title":{"rendered":"\u914d\u7f6e\u53c2\u8003"},"content":{"rendered":"
\n

Complete field-by-field reference for ~\/.openclaw\/openclaw.json<\/p>\n<\/blockquote>\n

\u914d\u7f6e\u53c2\u8003<\/h1>\n

~\/.openclaw\/openclaw.json<\/code> \u4e2d\u6240\u6709\u53ef\u7528\u5b57\u6bb5\u3002\u82e5\u9700\u9762\u5411\u4efb\u52a1\u7684\u6982\u89c8\uff0c\u8bf7\u53c2\u89c1 \u914d\u7f6e\u8bf4\u660e<\/a>\u3002<\/p>\n

\u914d\u7f6e\u683c\u5f0f\u4e3a JSON5<\/strong>\uff08\u5141\u8bb8\u6ce8\u91ca\u548c\u5c3e\u968f\u9017\u53f7\uff09\u3002\u6240\u6709\u5b57\u6bb5\u90fd\u662f\u53ef\u9009\u7684\u2014\u2014\u7701\u7565\u65f6\uff0cOpenClaw \u4f1a\u4f7f\u7528\u5b89\u5168\u9ed8\u8ba4\u503c\u3002<\/p>\n

\n

\u6e20\u9053<\/h2>\n

\u53ea\u8981\u67d0\u4e2a\u6e20\u9053\u7684\u914d\u7f6e\u8282\u5b58\u5728\uff0c\u5b83\u5c31\u4f1a\u81ea\u52a8\u542f\u52a8\uff08\u9664\u975e\u8bbe\u7f6e\u4e86 enabled: false<\/code>\uff09\u3002<\/p>\n

\u79c1\u4fe1\u548c\u7fa4\u7ec4\u8bbf\u95ee<\/h3>\n

\u6240\u6709\u6e20\u9053\u90fd\u652f\u6301\u79c1\u4fe1\u7b56\u7565\u548c\u7fa4\u7ec4\u7b56\u7565\uff1a<\/p>\n\n\n\n\n\n\n\n\n
DM policy<\/th>\nBehavior<\/th>\n<\/tr>\n<\/thead>\n
pairing<\/code>\uff08\u9ed8\u8ba4\uff09<\/td>\n\u672a\u77e5\u53d1\u9001\u8005\u4f1a\u6536\u5230\u4e00\u6b21\u6027\u914d\u5bf9\u7801\uff1b\u6240\u6709\u8005\u5fc5\u987b\u6279\u51c6<\/td>\n<\/tr>\n
allowlist<\/code><\/td>\n\u4ec5 allowFrom<\/code> \u4e2d\u7684\u53d1\u9001\u8005\uff08\u6216\u5df2\u914d\u5bf9\u7684\u5141\u8bb8\u5217\u8868\u5b58\u50a8\uff09<\/td>\n<\/tr>\n
open<\/code><\/td>\n\u5141\u8bb8\u6240\u6709\u5165\u7ad9\u79c1\u4fe1\uff08\u8981\u6c42 allowFrom: [\"*\"]<\/code>\uff09<\/td>\n<\/tr>\n
disabled<\/code><\/td>\n\u5ffd\u7565\u6240\u6709\u5165\u7ad9\u79c1\u4fe1<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n\n\n\n\n\n
Group policy<\/th>\nBehavior<\/th>\n<\/tr>\n<\/thead>\n
allowlist<\/code>\uff08\u9ed8\u8ba4\uff09<\/td>\n\u4ec5\u5141\u8bb8\u5339\u914d\u5df2\u914d\u7f6e allowlist \u7684\u7fa4\u7ec4<\/td>\n<\/tr>\n
open<\/code><\/td>\n\u7ed5\u8fc7\u7fa4\u7ec4 allowlist\uff08\u4ecd\u4f1a\u5e94\u7528\u63d0\u53ca\u95e8\u63a7\uff09<\/td>\n<\/tr>\n
disabled<\/code><\/td>\n\u963b\u6b62\u6240\u6709\u7fa4\u7ec4\/\u623f\u95f4\u6d88\u606f<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

\n channels.defaults.groupPolicy<\/code> \u4f1a\u5728\u67d0\u4e2a\u63d0\u4f9b\u5546\u7684 groupPolicy<\/code> \u672a\u8bbe\u7f6e\u65f6\u4f5c\u4e3a\u9ed8\u8ba4\u503c\u3002
\n \u914d\u5bf9\u7801\u4f1a\u5728 1 \u5c0f\u65f6\u540e\u8fc7\u671f\u3002\u5f85\u5904\u7406\u7684\u79c1\u4fe1\u914d\u5bf9\u8bf7\u6c42\u6bcf\u4e2a\u6e20\u9053\u6700\u591a 3 \u4e2a<\/strong>\u3002
\n \u5982\u679c\u67d0\u4e2a\u63d0\u4f9b\u5546\u914d\u7f6e\u5757\u5b8c\u5168\u7f3a\u5931\uff08channels.<provider><\/code> \u4e0d\u5b58\u5728\uff09\uff0c\u8fd0\u884c\u65f6\u7fa4\u7ec4\u7b56\u7565\u4f1a\u56de\u9000\u5230 allowlist<\/code>\uff08\u9ed8\u8ba4\u62d2\u7edd\uff09\uff0c\u5e76\u5728\u542f\u52a8\u65f6\u53d1\u51fa\u8b66\u544a\u3002
\n<\/\u8bf4\u660e><\/p>\n

\u6e20\u9053\u6a21\u578b\u8986\u76d6<\/h3>\n

\u4f7f\u7528 channels.modelByChannel<\/code> \u53ef\u5c06\u7279\u5b9a\u6e20\u9053 ID \u56fa\u5b9a\u5230\u67d0\u4e2a\u6a21\u578b\u3002\u503c\u63a5\u53d7 provider\/model<\/code> \u6216\u5df2\u914d\u7f6e\u7684\u6a21\u578b\u522b\u540d\u3002\u5f53\u4f1a\u8bdd\u5c1a\u672a\u5b58\u5728\u6a21\u578b\u8986\u76d6\u65f6\uff08\u4f8b\u5982\u901a\u8fc7 \/model<\/code> \u8bbe\u7f6e\uff09\uff0c\u624d\u4f1a\u5e94\u7528\u6e20\u9053\u6620\u5c04\u3002<\/p>\n

“`json5 theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
\n{
\n \u6e20\u9053s: {
\n modelByChannel: {
\n discord: {
\n “123456789012345678”: “anthropic\/claude-opus-4-6”,
\n },
\n slack: {
\n C1234567890: “openai\/gpt-4.1”,
\n },
\n telegram: {
\n “-1001234567890”: “openai\/gpt-4.1-mini”,
\n “-1001234567890:topic:99”: “anthropic\/claude-sonnet-4-6”,
\n },
\n },
\n },
\n}<\/p>\n

\n### \u6e20\u9053\u9ed8\u8ba4\u503c\u548c\u5fc3\u8df3\n\n\u4f7f\u7528 `channels.defaults` \u4e3a\u591a\u4e2a\u63d0\u4f9b\u5546\u5171\u4eab\u7fa4\u7ec4\u7b56\u7565\u548c\u5fc3\u8df3\u884c\u4e3a\uff1a\n\n```json5  theme={"theme":{"light":"min-light","dark":"min-dark"}}\n{\n  channels: {\n    defaults: {\n      groupPolicy: "allowlist", \/\/ open | allowlist | disabled\n      heartbeat: {\n        showOk: false,\n        showAlerts: true,\n        useIndicator: true,\n      },\n    },\n  },\n}\n<\/code><\/pre>\n