openclaw.json

OpenClaw 的配置文件默认位于用户主目录下，藏得还挺深：

~/.openclaw/openclaw.json

在 Windows 系统上，完整路径通常是：

C:\Users\你的用户名\.openclaw\openclaw.json

💡 你也可以通过环境变量 OPENCLAW_CONFIG_PATH 自定义配置文件路径。想藏得更隐蔽？随你便～

1.2 配置的加载顺序 OpenClaw 加载配置时遵循特定优先级，理解这个顺序能帮你避免很多坑。这就像打游戏时的装备优先级，优先级高的先生效：

进程环境变量

• 最高优先级，启动时已存在的变量（大佬地位） 当前目录的 .env 文件
• 工作目录下的 .env 文件 全局 .env 文件
• ~/.openclaw/.env 配置文件的 env 块
• openclaw.json 中的 env 配置 登录 Shell 导入
• 可选，需显式启用（备胎中的备胎） ⚠️ 核心规则：永不覆盖已有值。优先级高的先加载，低的只能填补空缺。就像占座，先来后到！

1.3 修改后需要做什么 修改配置文件后，必须重启 Gateway 才能生效。别想着热重载，人家不认：

重启 Gateway

openclaw gateway restart

💡 修改配置前建议先备份，万一改错了能快速回滚！别问我是怎么知道的…😅

2 配置结构全景图 2.1 14个常用模块 openclaw.json 包含 14 个常用的配置模块，每个模块负责不同功能。看着多，其实就那回事：

还有很多，这里不一一列举，有需要的可以去官网扒扒。 模块名 作用 修改频率 agents 代理默认配置（模型、并发数等） 低 auth 认证配置文件和密钥管理 低 browser 浏览器控制配置 低 channels 消息渠道（WhatsApp/Telegram 等） 中 commands 命令配置 低 gateway 网关核心配置（端口、绑定等） 低 hooks 钩子自动化配置 中 messages 消息处理规则 低 meta 元数据（版本、时间戳） 自动 models 模型提供商配置 中 plugins 插件系统配置 中 skills 技能管理配置 中 tools 工具启用开关 低 wizard 向导配置记录 自动 2.2 层级关系思维导图

openclaw.json
├── agents          # 代理配置
│   └── defaults    # 默认设置
├── auth            # 认证管理
│   ├── order       # 认证顺序
│   └── profiles    # 认证配置文件
├── browser         # 浏览器配置
├── channels        # 渠道配置
│   └── feishu      # 飞书示例
├── commands        # 命令配置
├── gateway         # 网关核心
│   ├── auth        # 网关认证
│   ├── bind        # 绑定地址
│   ├── port        # 端口号
│   └── tailscale   # Tailscale 配置
├── hooks           # 钩子系统
│   └── internal    # 内部钩子
├── messages        # 消息配置
├── meta            # 元数据
├── models          # 模型配置
│   └── providers   # 模型提供商
├── plugins         # 插件系统
│   ├── entries     # 插件条目
│   └── load        # 加载路径
├── skills          # 技能管理
│   ├── entries     # 技能条目
│   └── install     # 安装配置
├── tools           # 工具开关
│   └── web         # Web 工具
└── wizard          # 向导记录