最重要的心法
像经验丰富的系统维护者一样处理配置：先确认字段属于哪一层、是否支持热更新、会影响哪个会话，再决定是 patch 还是整份 apply。
OpenClaw 配置
把 OpenClaw 的配置看成三层：能力定义、运行时行为、渠道与权限。真正稳妥的做法不是“直接改大文件”，而是先看目标字段的 schema，再做最小改动、带验证地重启。
配置改动的推荐顺序
先定位字段
优先查看某个具体路径的 schema，而不是靠猜字段名或复制旧配置。
读取当前值
确认现在到底是什么，避免把线上已经存在的细节覆盖掉。
做最小 patch
能局部改就不要整体 apply，尤其是涉及 agents、channels、capabilities 时。
重启后验证
确认重启成功、目标能力生效、现有会话没有出现副作用。
你通常会遇到的 4 类配置
- agents：默认模型、图像模型、子代理、能力边界。
- channels：Feishu、Telegram、Discord 等接入方式、路由和能力开关。
- gateway / runtime：重启、会话行为、守护进程侧配置。
- capabilities / permissions：是否允许消息按钮、浏览器、节点、文档写入等。
什么时候最容易出错
- 直接猜字段名
- 全量 apply 覆盖局部改动
- 没看 schema 就改枚举值
- 把渠道配置和 agent 配置混在一起
- 改完没验证会话实际行为
排查思路
- 先判断是“字段不存在”、"权限不足"，还是“重启后未生效”。
- 如果是字段问题，先看 schema；如果是权限问题，先看对应 app scopes / capabilities。
- 如果是行为异常，优先检查当前 session 的模型、渠道上下文和 runtime 限制。
安全边界
- 不要把 token、密钥、内部 ID、绝对路径写进对外页面。
- 不要在不确定字段含义时直接 apply 整份配置。
- 生产会话里优先选择可回滚、可解释的小改动。
一句话总结
如果你要改 OpenClaw 配置，最稳的方法永远是：schema.lookup → config.get → config.patch → restart → verify。