告别 JSON 地狱:高效管理 OpenClaw 配置的艺术

对于 OpenClaw 新手而言，最令人生畏的往往不是复杂的 AI 逻辑，而是那个名为 openclaw.json 的配置文件。一个小小的逗号缺失或括号不匹配，都可能导致服务崩溃。

作为 OpenClaw 的资深玩家，我强烈建议：尽量通过命令行（CLI）工具来操作。 并在操作中严格遵守“备份-查看-修改-复核”的专业流程。

零、安全第一：备份与 JSON5 知识

1. 强制备份：带时间戳的历史记录

在进行任何修改前，请执行以下命令进行备份。使用时间戳可以让你保留多个备份副本，防止新的错误覆盖了旧的正确配置。

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup.$(date +%Y%m%d_%H%M%S)

2. 为什么是 JSON5？

OpenClaw 采用了 JSON5 标准，它是 JSON 的超集，旨在让人类更容易编写：

• 支持注释：使用 // 记录配置用途，也能注释代码。
• 允许末尾逗号：列表最后一项加逗号不再报错。
• 更宽容：支持单引号，Key 可以不加引号。

一、核心工作流：黄金三步走

为了确保万无一失，请务必养成以下操作习惯：

1. Get (查看)：确认当前参数路径和数值。
2. Set/Unset (操作)：执行修改、增加或删除命令。
3. Verify (复核)：再次查看，确认结果符合预期。

二、基础实战：修改、增加与删除

场景 1：基础修改与复核（修改现有字段）

# 1. 修改前：查看当前参数  openclaw config get tools.profile# 2. 执行修改：将coding改成 full  openclaw config set tools.profile full# 3. 修改后：确认生效  openclaw config get tools.profile

场景 2：飞书配置进阶（修改字段 + 增加新字段）

在飞书设置中，需要将 groupPolicy 从 open 改为 allowlist，并增加一个允许的群 ID 列表。

💡 小贴士：飞书群 ID 获取方式：建立聊天群 -> 右上角：设置 -> 底下的“会话 ID”（oc_ 开头）。

# 1. 查看当前飞书配置  openclaw config get channels.feishu# 2. 修改现有参数：从 open 改为 allowlist  openclaw config set channels.feishu.groupPolicy allowlist# 3. 增加新参数：注入 groupAllowFrom 数组字段（使用 --json 参数）  openclaw config set --json channels.feishu.groupAllowFrom '[    "oc_e4dfb35658c81ce5100add124c3592a8",    "oc_9f23c45769d92df621Bee02350c4603d"  ];'# 4. 最终复核：确保修改和新增字段都已就位  openclaw config get channels.feishu

场景 3：删除配置项 (Unset)

当你不再需要某个功能模块，或者想重置配置时：

# 1. 删除前：确认配置存在  openclaw config get meta# 2. 执行删除  openclaw config unset meta# 3. 删除后：确认输出为 null  openclaw config get meta

三、高阶实战：新增顶级字段（以 Browser CDP 为例）

在默认配置中，browser 顶级字段通常不存在。使用 CLI 注入可以完美避免手动修改时找不准位置的尴尬。

3.1 批量注入与前后对比

步骤 1：确认该字段是否存在（Before）

openclaw config get browser

步骤 2：使用 CLI 强制注入新配置

openclaw config set --batch-json '[{    "path": "browser",    "value": {      "enabled": true,      "attachOnly": true,      "defaultProfile": "user",      "profiles": {        "user": {          "cdpUrl": "http://127.0.0.1:9222",          "color": "#0078D4"        }      }    }  }]'

步骤 3：查看注入结果（After）并对比

openclaw config get browser

四、运维百宝箱：位置、校验与体检

4.1 定位配置文件

openclaw config file  /home/user/.openclaw/openclaw.json

4.2 配置合法性校验 (Validate)

openclaw config validate

五、总结：资深玩家的守则

1. 先备份，后动手：带时间戳的 cp 命令是你的最后一道防线。
2. 新手严禁手动“开荒”：对于默认不存在的字段，必须通过 config set 自动生成层级。
3. 有对比，才放心：通过修改前后的 get 结果对比确认每一个字段的变动。
4. 校验是最后一步：执行 openclaw config validate 确保配置文件依然健康。
5. 优先使用 CLI：它会自动处理 JSON 层级和格式，确保文件永远合法且符合规范。

零、 安全第一：备份与 JSON5 知识