OpenClaw从入门到应用——CLI：Config

通过OpenClaw实现副业收入：《OpenClaw赚钱实录：从“养龙虾“到可持续变现的实践指南》

openclaw config

配置辅助工具：通过路径获取/设置/取消设置/验证值，并打印当前活动的配置文件。不带子命令运行时将打开配置向导（等同于openclaw configure）。

补充说明：该命令是 OpenClaw 系统运维与调试的核心入口之一，建议在修改配置前先备份原始配置文件，并在每次变更后执行validate子命令以确保语法与语义正确性，避免网关启动失败。

Examples

openclaw configfileopenclaw config get browser.executablePath openclaw configsetbrowser.executablePath"/usr/bin/google-chrome"openclaw configsetagents.defaults.heartbeat.every"2h"openclaw configsetagents.list[0].tools.exec.node"node-id-or-name"openclaw configunsettools.web.search.apiKey openclaw config validate openclaw config validate--json

Paths

路径支持点表示法或括号表示法：

openclaw config get agents.defaults.workspace openclaw config get agents.list[0].id

使用代理列表索引来定位特定代理：

openclaw config get agents.list openclaw configsetagents.list[1].tools.exec.node"node-id-or-name"

补充说明：当路径中包含特殊字符、空格或数字开头的键名时，建议优先使用括号表示法（如agents.list["my-agent"]），以避免解析歧义；同时，数组索引从 0 开始，超出范围的索引将返回空值或报错，请结合get agents.list先确认实际长度。

Values

值在可能的情况下会被解析为 JSON5；否则将被视为字符串。使用--strict-json可强制要求按 JSON5 进行解析。--json作为遗留别名仍受支持。

openclaw configsetagents.defaults.heartbeat.every"0m"openclaw configsetgateway.port19001--strict-json openclaw configsetchannels.whatsapp.groups'["*"]'--strict-json

补充说明：JSON5 允许注释、尾随逗号、单引号字符串等宽松语法，适合人工编辑；但在自动化脚本或 CI/CD 流水线中，建议始终启用--strict-json以确保值的类型和结构符合预期，防止因隐式字符串转换导致运行时行为异常。

Subcommands

• config file：打印当前活动的配置文件路径（从环境变量 OPENCLAW_CONFIG_PATH 或默认位置解析）。编辑后需重启网关使更改生效。

补充说明：若未设置 OPENCLAW_CONFIG_PATH，系统将依次查找~/.openclaw/config.json5、./openclaw.config.json5等默认路径；建议在多环境部署时显式指定该变量，以避免误加载错误配置。

Validate

在不启动网关的情况下，根据当前活动的模式（schema）验证现有配置。

openclaw config validate openclaw config validate--json

补充说明：验证过程会检查必填字段、数据类型、枚举值约束及自定义校验规则；输出--json格式便于集成到监控告警或部署前检查流程中，推荐将其纳入发布门禁以提前拦截配置错误。