Gateway 配置

OpenClaw 从 ~/.openclaw/openclaw.json 读取可选 JSON5 配置。文件不存在时会采用安全默认值；只有当你要限制触发范围、调整工作区、修改 Gateway 认证或定制工具策略时，才需要显式写配置。

Gateway 运维 Gateway 排障帮助中心

配置原则

Strict Schema

严格校验

未知键、类型错误或无效值会让 Gateway 直接拒绝启动。排障时优先执行 openclaw doctor。

推荐起点

先用默认值

大多数新手不需要一开始就写整份配置。先通过向导生成安全默认值，再按需要修改局部字段。

RPC Update

config.apply / config.patch

config.apply 会替换整份配置；只想改部分键时，用 config.patch 或 openclaw config set 更稳。

Composable

$include 拆分配置

当配置变复杂时，可以用 $include 拆成多个文件按顺序深度合并。

高频片段

最小配置

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } }
}

完整替换配置（RPC）

先读取 hash，再用 apply 提交整份 JSON5 配置并触发重启。

openclaw gateway call config.get --params '{}'
openclaw gateway call config.apply --params '{
  "raw": "{\n  agents: { defaults: { workspace: \"~/.openclaw/workspace\" } }\n}\n",
  "baseHash": "<hash-from-config.get>",
  "restartDelayMs": 1000
}'

部分更新（RPC）

只改局部键，不覆盖其余配置。

openclaw gateway call config.patch --params '{
  "raw": "{\n  channels: { telegram: { groups: { \"*\": { requireMention: false } } } }\n}\n",
  "baseHash": "<hash-from-config.get>",
  "restartDelayMs": 1000
}'

最常修改的字段

channels.*.allowFrom：限制谁可以触发机器人。

channels.*.groups 与 agents.list[].groupChat：控制群组白名单与提及策略。

agents.defaults.workspace 与 agents.list[].workspace：控制工作区位置。

gateway.auth.token：即使在 loopback 上也建议保留。

tools.allow / tools.deny / tools.profile：控制智能体可用工具范围。