配置参考

~/.openclaw/openclaw.json 的字段级参考：键、默认值以及指向更深层子系统页面的链接。如需面向任务的设置指南，请参阅配置。频道和插件所拥有的命令目录以及深度记忆调节项位于各自的页面，不在此处。

配置格式为 JSON5（允许注释和尾随逗号）。所有字段均为可选；省略时 OpenClaw 会使用安全默认值。

代码才是最终依据，优先于本页：

• openclaw config schema 输出用于校验和 Control UI 的实时 JSON Schema，并合并了内置/插件/频道的元数据。
• 在编辑配置前，智能体应调用 gateway 工具动作 config.schema.lookup 获取一个精确的路径作用域 schema 节点。
• pnpm config:docs:check / pnpm config:docs:gen 会根据当前 schema 表面验证本文档的基线哈希。

Schema 的 uiHints 还会为每个路径携带一个已解析的 advanced 布尔值。Control UI 用它先在各个部分显示常见字段，再折叠高级字段；搜索仍会覆盖两个层级。层级元数据仅用于展示。添加键时，在叶节点上声明其层级，或让它继承最近的祖先声明。没有声明祖先的路径默认为高级。

专用深度参考：

• 内存配置参考：涵盖 memory.search.*、memory.citations，以及 plugins.entries.memory-core.config.dreaming 下的 dreaming 配置。
• 斜杠命令：涵盖当前内置 + 随附的命令目录。
• 所属频道/插件页面：用于频道特定的命令表面。

本参考集中的页面¶

• 配置 — 运行时基础 — 运行时配置：工作树根目录、模型路由、发现、更新、ACP 和向导。
• 配置 — MCP、技能与插件 — 扩展配置：MCP 服务器、技能、插件条目和画布组件展示器。
• 配置 — 浏览器、UI 和桌面 — 浏览器自动化、Control UI 展示，以及桌面或配对节点配置。
• 配置 — 网关 — 网关配置：绑定、认证、角色、Control UI、终端、远程、节点、TLS 和重载。
• 配置 — 云工作环境 — cloudWorkers 下的云工作器配置，包括 Crabbox 和静态 SSH 开发。
• 配置 — 钩子 — 钩子配置：HTTP 契约、智能体负载、会话策略、映射、重试和 Gmail。
• 配置 — 环境、密钥与包含 — 环境变量、密钥提供者、认证存储和 $include 配置拆分。
• 配置 — 审计、日志、诊断与遥测 — 可观测性配置：审计、日志、诊断和遥测键。
• 配置 — 自动化与媒体模板变量 — cron 下的自动化配置，以及媒体模型模板变量表面。
• 配置 — 智能体 — 智能体默认值、多智能体路由、会话、消息和 talk。
• 配置 — 频道 — 每频道访问控制、配对和频道键。
• 配置 — 工具 — 工具启用和自定义工具提供者。

频道¶

每个频道的配置键位于配置 - 频道：channels.* 用于 Slack、Discord、Telegram、WhatsApp、Matrix、iMessage 和其他频道插件（认证、访问控制、多账户、提及门控）。

智能体默认值、多智能体、会话和消息¶

请参阅配置 - 智能体了解以下内容：

• agents.defaults.*（工作区、模型、思考、心跳、记忆、媒体、技能、沙箱）
• multiAgent.*（多智能体路由和绑定）
• session.*（会话生命周期、压缩、清理）
• messages.*（消息投递、TTS、Markdown 渲染）
• talk.*（Talk 模式）
• talk.consultThinkingLevel：对 Control UI Talk 实时咨询背后的完整 OpenClaw 智能体运行进行思考层级覆盖。
• talk.consultFastMode：用于 Control UI Talk 实时咨询的一次性快速模式覆盖。
• talk.speechLocale：可选的 BCP 47 区域设置 ID，用于 Android、iOS 和 macOS 上的 Talk 语音识别，以及 iOS 系统语音回退。
• talk.silenceTimeoutMs：未设置时，Talk 在发送转录之前会保持平台默认的暂停窗口（700 ms on macOS and Android, 900 ms on iOS）。
• talk.realtime.consultRouting：针对已最终确定的实时 Talk 转录的 Gateway 中继回退；这些转录会跳过 openclaw_agent_consult。

worktreeRoot¶

已移至配置 — 运行时基础。

工具与自定义提供者¶

工具策略、实验性开关、基于提供者的工具配置，以及自定义提供者 / 基础 URL 设置位于配置 - 工具与自定义提供者。

模型¶

已移至配置 — 运行时基础。

MCP¶

已移至配置 — MCP、技能与插件。

技能¶

已移至配置 — MCP、技能与插件。

插件¶

已移至配置 — MCP、技能与插件。章节：Codex harness 插件配置。

浏览器¶

已移至配置 — 浏览器、UI 和桌面。

UI¶

已移至配置 — 浏览器、UI 和桌面。

桌面¶

已移至配置 — 浏览器、UI 和桌面。章节：配对节点的桌面。

网关¶

已移至配置 — 网关。章节：OpenAI 兼容端点、多实例隔离、gateway.tls、gateway.reload。

云工作器环境¶

已移至 配置 — 云工作器环境。章节：Crabbox 配置文件、静态 SSH 开发配置文件。

钩子¶

已移至 配置 — 钩子。章节：钩子 HTTP 契约、钩子智能体负载、钩子会话与智能体策略、映射详情、钩子重试与扇出、Gmail 集成。

Canvas 小部件呈现器¶

已移至 配置 — MCP、技能与插件。

发现¶

已移至 配置 — 运行时基础。章节：mDNS (Bonjour)、广域网 (DNS-SD)。

环境¶

已移至 配置 — 环境、机密与包含。章节：env（内联环境变量）、环境变量替换。

机密¶

已移至 配置 — 环境、机密与包含。章节：secrets.egressProxy、SecretRef、支持的凭据范围、Secret 提供程序配置。

认证存储¶

已移至 配置 — 环境、机密与包含。

审计¶

已移至 配置 — 审计、日志、诊断与遥测。

日志¶

已移至 配置 — 审计、日志、诊断与遥测。

诊断¶

已移至 配置 — 审计、日志、诊断与遥测。

遥测¶

已移至 配置 — 审计、日志、诊断与遥测。

更新¶

已移至 配置 — 运行时基础。

ACP¶

已移至 配置 — 运行时基础。

向导¶

已移至 配置 — 运行时基础。

身份¶

参见 智能体默认值 下的 agents.entries 身份字段。

Bridge（旧版，已移除）¶

已移至 配置 — 运行时基础。

自动化（cron）¶

已移至 配置 — 自动化与媒体模板变量。章节：cron.failureAlert。

媒体模型模板变量¶

已移至 配置 — 自动化与媒体模板变量。

配置包含（$include）¶

已移至 配置 — 环境、机密与包含。

相关¶

• 配置
• 配置示例
• Doctor
• Cloud Workers — 这些工作器设置所对应的功能
• openclaw configure — 用于编辑这些设置的交互式提示，无需手动编辑文件