玩转OpenClaw：主配置文件参数详解指南手册

配置文件概述

OpenClaw 使用 JSON / JSON5 格式的配置文件来管理系统所有组件的设置。配置文件采用分层结构，支持灵活的配置覆盖和环境变量注入。

主要特性

• JSON5 支持：支持注释、尾随逗号、单引号等扩展语法
• 环境变量：可通过 env 字段或者.env文件注入环境变量
• 配置合并：支持多配置文件合并（主配置 + 环境配置）
• 热重载：部分配置支持运行时重载（需重启网关）

文件格式与位置

主配置文件

代码语言：javascript

AI代码解释

# 主配置文件路径 ~/.openclaw/openclaw.json # 配置文件备份 ~/.openclaw/openclaw.json.bak

配置文件格式

OpenClaw 支持标准的 JSON 和 JSON5 格式

代码语言：javascript

AI代码解释

// JSON5 示例（支持注释） { // 模型配置 models: { // 提供商列表 providers: { openai: { apiKey: "${OPENAI_API_KEY}", // 环境变量引用 }, }, }, // 代理配置 agents: { defaults: { model: { primary: "openai/gpt-4o", }, }, }, }

环境变量引用

代码语言：javascript

AI代码解释

{ env: { // 设置环境变量 "OPENAI_API_KEY": "sk-xxx", }, models: { providers: { openai: { // 引用环境变量 apiKey: "${OPENAI_API_KEY}", }, }, }, }

配置文件结构总览

代码语言：javascript

AI代码解释

{ "meta": {}, // 元数据 "wizard": {}, // 向导记录 "auth": {}, // 认证配置 "models": {}, // 模型配置 "agents": {}, // 代理配置 "channels": {}, // 频道配置 "gateway": {}, // 网关配置 "memory": {}, // 内存配置 "plugins": {}, // 插件配置 "commands": {}, // 命令配置 "messages": {}, // 消息配置 "env": {}, // 环境变量（可选） "tools": {}, // 工具配置（可选） "bindings": [], // 代理绑定（可选） }

meta - 元数据

记录配置文件的元数据信息，由系统自动维护。

参数说明

配置示例

代码语言：javascript

AI代码解释

{ "meta": { "lastTouchedVersion": "2026.3.11", "lastTouchedAt": "2026-03-13T01:42:30.878Z" } }

wizard - 向导记录

记录配置向导的运行状态。

参数说明

配置示例

代码语言：javascript

AI代码解释

{ "wizard": { "lastRunAt": "2026-02-25T12:06:39.761Z", "lastRunVersion": "2026.2.24", "lastRunCommand": "configure", "lastRunMode": "local" } }

auth - 认证配置

管理模型提供商的认证信息。

参数说明

认证配置对象

代码语言：javascript

AI代码解释

{ "auth": { "profiles": { "<provider>:<profile>": { "provider": "openai", // 提供商名称 "mode": "api_key", // 认证模式 "apiKey": "sk-xxx", // API密钥 "baseUrl": "https://api.openai.com/v1" // API基础URL } } } }

配置示例

代码语言：javascript

AI代码解释

{ "auth": { "profiles": { "minimax-cn:default": { "provider": "minimax-cn", "mode": "api_key" }, "openai:default": { "provider": "openai", "mode": "api_key" } } } }

models - 模型配置

配置模型提供商和可用模型。

参数说明