配置文件概述OpenClaw 使用 JSON / JSON5 格式的配置文件来管理系统所有组件的设置。配置文件采用分层结构，支持灵活的配置覆盖和环境变量注入。主要特性JSON5 支持：支持注释、尾随逗号、单引号等扩展语法环境变量：可通过 env 字段或者.env文件注入环境变量配置合并：支持多配置文件合并（主配置 + 环境配置）热重载：部分配置支持运行时重载（需重启网关）文件格式与位置主配置文件代码语言：javascriptAI代码解释# 主配置文件路径 ~/.openclaw/openclaw.json # 配置文件备份 ~/.openclaw/openclaw.json.bak配置文件格式OpenClaw 支持标准的 JSON 和 JSON5 格式代码语言：javascriptAI代码解释// JSON5 示例（支持注释） { // 模型配置 models: { // 提供商列表 providers: { openai: { apiKey: "${OPENAI_API_KEY}", // 环境变量引用 }, }, }, // 代理配置 agents: { defaults: { model: { primary: "openai/gpt-4o", }, }, }, }环境变量引用代码语言：javascriptAI代码解释{ env: { // 设置环境变量 "OPENAI_API_KEY": "sk-xxx", }, models: { providers: { openai: { // 引用环境变量 apiKey: "${OPENAI_API_KEY}", }, }, }, }配置文件结构总览代码语言：javascriptAI代码解释{ "meta": {}, // 元数据 "wizard": {}, // 向导记录 "auth": {}, // 认证配置 "models": {}, // 模型配置 "agents": {}, // 代理配置 "channels": {}, // 频道配置 "gateway": {}, // 网关配置 "memory": {}, // 内存配置 "plugins": {}, // 插件配置 "commands": {}, // 命令配置 "messages": {}, // 消息配置 "env": {}, // 环境变量（可选） "tools": {}, // 工具配置（可选） "bindings": [], // 代理绑定（可选） }meta - 元数据记录配置文件的元数据信息，由系统自动维护。参数说明参数类型默认值说明lastTouchedVersionstring-最后修改配置的 OpenClaw 版本lastTouchedAtstring-最后修改时间 (ISO 8601)配置示例代码语言：javascriptAI代码解释{ "meta": { "lastTouchedVersion": "2026.3.11", "lastTouchedAt": "2026-03-13T01:42:30.878Z" } }wizard - 向导记录记录配置向导的运行状态。参数说明参数类型默认值说明lastRunAtstring-最后运行向导的时间lastRunVersionstring-运行向导时的版本lastRunCommandstring-最后运行的命令lastRunModestring-运行模式 (local/remote)配置示例代码语言：javascriptAI代码解释{ "wizard": { "lastRunAt": "2026-02-25T12:06:39.761Z", "lastRunVersion": "2026.2.24", "lastRunCommand": "configure", "lastRunMode": "local" } }auth - 认证配置管理模型提供商的认证信息。参数说明参数类型默认值说明profilesobject{}认证配置集合认证配置对象代码语言：javascriptAI代码解释{ "auth": { "profiles": { "provider:profile": { "provider": "openai", // 提供商名称 "mode": "api_key", // 认证模式 "apiKey": "sk-xxx", // API密钥 "baseUrl": "https://api.openai.com/v1" // API基础URL } } } }配置示例代码语言：javascriptAI代码解释{ "auth": { "profiles": { "minimax-cn:default": { "provider": "minimax-cn", "mode": "api_key" }, "openai:default": { "provider": "openai", "mode": "api_key" } } } }models - 模型配置配置模型提供商和可用模型。参数说明参数类型默认值说明modestring“merge”配置模式 (merge/r