OpenClaw 配置文件 openclaw.json：结构、位置与环境变量
OpenClaw 的一切行为——渠道、模型、工具、心跳、安全策略——最终都落在一个 JSON 配置文件上。理解它的结构，后面所有分组文档里的配置片段就都有了落脚点。
文件在哪
默认路径是用户目录下的 openclaw 文件夹里的 openclaw.json（例如 Windows 的 C:\Users\你\.openclaw\openclaw.json）。状态目录、配置路径都可以用环境变量重定向：
- OPENCLAW_HOME ——重定义内部路径解析的主目录
- OPENCLAW_STATE_DIR ——覆盖状态目录
- OPENCLAW_CONFIG_PATH ——覆盖配置文件路径
服务账户或想把状态放数据盘的部署会用到这几个变量。
配置长什么样
顶层按功能域分块，常见的有：agents（智能体与心跳）、channels（各聊天渠道）、gateway（网关绑定、端口、验证）、session（会话隔离）、tools（工具策略）、skills（技能条目）。官方文档的所有示例都是 JSON5 风格（允许注释与尾逗号），实际文件写成标准 JSON 也完全可以。
改配置的正确姿势
- 手改文件后需要重启网关或等配置重载生效；用 openclaw gateway restart 最稳。
- 引导式修改用 openclaw configure，它会写回同一个文件。
- 部分旧配置键会被新版本停用，跑一次 openclaw doctor --fix 能自动清理并迁移（比如停用的渠道键、遗留的旧格式允许列表）。
两个最容易改错的点
- 渠道白名单格式：Telegram 的用户 ID 必须是数字，群组 ID 是负数且要放在 groups 块而不是发送者白名单里——放错位置是新手报错重灾区（见 群聊规则）。
- 密钥别进提示词：技能的环境变量注入只在宿主机进程生效，密钥不要写进会出现在提示词与日志里的地方；敏感信息优先用环境变量或密钥文件。
改坏了怎么办
openclaw doctor 会校验配置并给出修复建议；再不行，从备份恢复（改配置前先复制一份是社区共识）。官方文档特别提醒：能改到这个文件的人就等于拥有操作员权限，别把它放进共享目录。