openclaw config
用于在 openclaw.json 中进行非交互式编辑的配置辅助工具：按路径获取/设置/取消设置/查看文件/schema/验证
值，并打印当前生效的配置文件。无子命令运行时会打开配置向导（与 openclaw configure 相同）。
根选项：
--section <section>：当你在没有子命令的情况下运行openclaw config时，可重复的引导式设置分区过滤器
workspacemodelwebgatewaydaemonchannelspluginsskillshealth
示例
config schema
将为 openclaw.json 生成的 JSON schema 作为 JSON 打印到 stdout。
其包含内容：
- 当前根配置 schema，以及一个用于编辑器工具的根
$schema字符串字段 - Control UI 使用的字段
title和description文档元数据 - 当存在匹配的字段文档时，嵌套对象、通配符（
*）和数组项（[]）节点会继承相同的title/description元数据 - 当存在匹配的字段文档时，
anyOf/oneOf/allOf分支也会继承相同的文档元数据 - 在运行时清单可加载时，尽力提供实时插件 + 渠道 schema 元数据
- 即使当前配置无效，也会提供一个干净的回退 schema
config.schema.lookup返回一个已标准化的配置路径及其浅层 schema 节点（title、description、type、enum、const、常见边界）， 匹配的 UI 提示元数据，以及直接子节点摘要。可将其用于 Control UI 或自定义客户端中的按路径逐层钻取。
路径
路径使用点表示法或括号表示法：值
值会尽可能按 JSON5 解析；否则会被视为字符串。 使用--strict-json 可强制要求按 JSON5 解析。--json 仍然作为旧版别名受支持。
config get <path> --json 会将原始值以 JSON 形式输出，而不是终端格式化文本。
config set 模式
openclaw config set 支持四种赋值方式：
- 值模式：
openclaw config set <path> <value> - SecretRef 构建器模式：
- 提供商构建器模式（仅限
secrets.providers.<alias>路径）：
- 批量模式（
--batch-json或--batch-file）：
- 在不支持运行时可变更的表面上，SecretRef 赋值会被拒绝（例如
hooks.token、commands.ownerDisplaySecret、Discord 线程绑定 webhook token，以及 WhatsApp 凭证 JSON）。请参阅 SecretRef Credential Surface。
--batch-json / --batch-file）作为事实来源。
--strict-json / --json 不会改变批量解析行为。
JSON 路径/值模式对 SecretRef 和提供商也仍然受支持：
提供商构建器标志
提供商构建器目标路径必须使用secrets.providers.<alias>。
通用标志：
--provider-source <env|file|exec>--provider-timeout-ms <ms>（file、exec）
--provider-source env）：
--provider-allowlist <ENV_VAR>（可重复）
--provider-source file）：
--provider-path <path>（必填）--provider-mode <singleValue|json>--provider-max-bytes <bytes>
--provider-source exec）：
--provider-command <path>（必填）--provider-arg <arg>（可重复）--provider-no-output-timeout-ms <ms>--provider-max-output-bytes <bytes>--provider-json-only--provider-env <KEY=VALUE>（可重复）--provider-pass-env <ENV_VAR>（可重复）--provider-trusted-dir <path>（可重复）--provider-allow-insecure-path--provider-allow-symlink-command
Dry run
使用--dry-run 在不写入 openclaw.json 的情况下验证变更。
- 构建器模式：对已变更的 ref/提供商执行 SecretRef 可解析性检查。
- JSON 模式（
--strict-json、--json或批量模式）：执行 schema 验证以及 SecretRef 可解析性检查。 - 对已知不支持 SecretRef 的目标表面，也会执行策略验证。
- 策略检查会针对变更后的完整配置进行评估，因此写入父对象（例如将
hooks设置为对象）无法绕过对不支持表面的验证。 - 为避免命令副作用，dry run 期间默认跳过 exec SecretRef 检查。
- 如需启用 exec SecretRef 检查，请将
--allow-exec与--dry-run一起使用（这可能会执行提供商命令）。 --allow-exec仅用于 dry run；若未配合--dry-run使用则会报错。
--dry-run --json 会输出机器可读的报告：
ok：dry run 是否通过operations：已评估的赋值数量checks：是否运行了 schema / 可解析性检查checks.resolvabilityComplete：可解析性检查是否完整运行（跳过 exec ref 时为 false）refsChecked：dry run 期间实际已解析的 ref 数量skippedExecRefs：因未设置--allow-exec而跳过的 exec ref 数量errors：当ok=false时的结构化 schema / 可解析性失败信息
JSON 输出结构
config schema validation failed：你的变更后配置结构无效；请修正路径/值或提供商/ref 对象结构。Config policy validation failed: unsupported SecretRef usage：请将该凭证移回纯文本/字符串输入，并仅在受支持的表面上使用 SecretRef。SecretRef assignment(s) could not be resolved：当前被引用的提供商/ref 无法解析（缺少环境变量、文件指针无效、exec 提供商失败，或提供商/来源不匹配）。Dry run note: skipped <n> exec SecretRef resolvability check(s)：dry run 跳过了 exec ref；如果你需要验证 exec 可解析性，请使用--allow-exec重新运行。- 对于批量模式，请修复失败的条目，然后在写入前重新运行
--dry-run。
子命令
config file：打印当前生效的配置文件路径（从OPENCLAW_CONFIG_PATH或默认位置解析）。