这一页只做一件事：让你安全地改配置，并且改完能快速验证是否生效。核心原则是“小步修改 + 立刻验证”。
本章完成标准
你读完后应该能定位主配置、环境变量与工作目录，并用 CLI 安全修改关键配置项。
先记住 4 个核心路径
- 主配置：
~/.openclaw/openclaw.json - 全局环境变量：
~/.openclaw/.env - 默认工作区：
~/.openclaw/workspace - 日志目录：通常在
/tmp/openclaw/下滚动写入
openclaw.json 使用 JSON5 语法，不是严格 JSON。
步骤一：先查看当前配置，不急着改
openclaw config
openclaw config get gateway
openclaw config get channels
openclaw config get models先确认当前值，再做最小改动，能显著降低误改概率。
步骤二：用 CLI 做最小修改
openclaw config set gateway.auth.token "${OPENCLAW_GATEWAY_TOKEN}"
openclaw config set channels.feishu.enabled true
openclaw config unset channels.discord建议一次只改 1-2 个字段，避免连锁错误。
步骤三：环境变量统一放 .env
密钥和敏感信息优先放 .env，不要写进教程截图或仓库文件。配置中按变量名引用。
# ~/.openclaw/.env
OPENCLAW_GATEWAY_TOKEN=your_gateway_token
MOONSHOT_API_KEY=your_api_key步骤四：修改后立刻验证
openclaw status
openclaw gateway status
openclaw logs --follow如果状态异常，优先回滚最近一次改动，不要继续叠加新修改。
最常见配置误区
- 一次改很多项，无法定位是哪一项导致异常。
- 把 token/key 写进版本库或公开文档。
- 直接手改 JSON5 语法出错后不做校验。
- 改完不重开会话，误判为“配置无效”。