配置文件与模型

OpenClaw 的 openclaw.json（JSON5）配置位置与编辑方式，模型引用 provider/model、模型 CLI、故障转移与自定义服务商。

配置文件

OpenClaw 从 ~/.openclaw/openclaw.json 读取可选的 JSON5 配置（支持注释和尾逗号），文件缺失时用安全默认值。配置路径必须是普通文件；OpenClaw 自己的写入以原子方式（rename）替换它，所以符号链接的 openclaw.json 会被替换其目标，避免这种布局。常见需要配置的事：连接渠道并控制谁能给机器人发消息；设置模型、工具、沙箱或自动化（cron、hooks）；调整会话、媒体、网络或界面。两桶规则：根级兄弟键放基础设施和跨智能体默认值，agents.defaults 放智能体循环行为；agents.entries 下的条目可在 schema 支持处覆盖两者。最小配置：

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

编辑方式：交互向导（openclaw onboard 完整引导、openclaw configure 配置向导）、CLI 单行命令、直接编辑文件（默认热重载）。智能体和自动化改配置前应用 config.schema.lookup 查字段级文档。新手从 openclaw onboard 开始，或看 Configuration Examples 的完整可复制配置，各字段与默认值见 Configuration reference。

模型

模型引用写成 provider/model，选择的是服务商和模型，而不是底层智能体运行时。openai/* 前缀本身不会选中 Codex 运行时；订阅版 Copilot 引用（github-copilot/*）可显式选择外部 GitHub Copilot 智能体运行时插件，但永远不会被 auto 选中。OpenAI API Key 与 ChatGPT/Codex 订阅凭证仍是不同的凭证，运行时选择不决定计费。/model 在聊天里切换模型；openclaw models 系列命令管理。模型故障转移：按认证配置（auth profile）轮换、冷却，并在模型之间回退。自定义服务商与本地运行时：通过 models.providers 配置自定义端点、OpenAI/Anthropic 兼容代理和本地运行时；官方服务商插件有各自的设置页。Settings → Models 里也可以在控制台界面配置服务商与密钥。服务商与模型清单随时变化，以官方为准。