配置参考
针对 ~/.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 配置。 - 斜杠命令,用于当前内置 + 捆绑命令目录。
- 所属通道/插件页面,用于通道特定的命令界面。
本参考集中的页面¶
- 配置 — 运行时基础 — 运行时配置:worktree 根目录、模型路由、发现、更新、ACP 和向导。
- 配置 — MCP、技能和插件 — 扩展配置:MCP 服务器、技能、插件条目,以及 canvas 组件展示器。
- 配置 — 浏览器、UI 和桌面 — 浏览器自动化、Control UI 展示,以及桌面或配对节点配置。
- 配置 — gateway — gateway 配置:绑定、认证、角色、Control UI、终端、远程、节点、TLS 和重载。
- 配置 — 云 worker 环境 —
cloudWorkers下的云 worker 配置,包括 Crabbox 和静态 SSH 开发。 - 存储位置 —
storage.locations下的命名存储目标、初始化和加密。 - 配置 — hooks — hook 配置:HTTP 契约、agent 负载、会话策略、映射、重试和 Gmail。
- 配置 — 环境变量、密钥和包含 — 环境变量、密钥提供程序、auth 存储,以及
$include配置拆分。 - 配置 — 审计、日志、诊断和遥测 — 可观测性配置:audit、logging、diagnostics 和 telemetry 键。
- 配置 — 自动化和媒体模板变量 —
cron下的自动化配置,以及媒体模型模板变量表面。 - 配置 — agents — agent 默认值、多 agent 路由、会话、消息和 talk。
- 配置 — channels — 按通道的访问控制、配对和通道键。
- 配置 — tools — 工具启用和自定义工具提供程序。
通道¶
按通道的配置键位于 配置 - 通道:channels.* 用于 Slack、Discord、Telegram、WhatsApp、Matrix、iMessage 和其他通道插件(auth、访问控制、多账号、提及门控)。
Agent 默认值、多 agent、会话和消息¶
请参阅 配置 - agents:
agents.defaults.*(workspace、model、thinking、heartbeat、memory、media、skills、sandbox)multiAgent.*(多 agent 路由和绑定)session.*(会话生命周期、压缩、修剪)messages.*(消息投递、TTS、markdown 渲染)talk.*(Talk 模式)talk.consultThinkingLevel:Control UI Talk 实时咨询背后完整 OpenClaw agent 运行的思考级别覆盖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:Gateway 中继回退,用于跳过openclaw_agent_consult的已定稿实时 Talk 转录文本
worktreeRoot¶
Worktree 存储(worktreeRoot)、文件系统加速(worktreeAcceleration)和实时检出上限(worktreeMaxCount)记录在 配置 — 运行时基础 中。
工具和自定义提供程序¶
工具策略、实验开关、由提供程序支持的工具配置,以及自定义 提供程序 / base-URL 设置位于 配置 - 工具和自定义提供程序。
agents.entries.<id>.tools.github.allowInSandbox 是可选布尔值,
默认为 false。将其设置在 agent 的受管 GitHub 身份上,以将该身份暴露给
agent 自己的 Docker 或 Podman 沙箱,包括角色必需的沙箱。该 profile 以只读方式挂载到 /openclaw/github;
有效共享范围拒绝注入。此设置不被全局 tools.github 接受,并且安全审计会为每个已选入的 agent 发出警告。
请参阅 GitHub 身份 了解
设置、凭据暴露和后端要求。
模型¶
已移至 配置 — 运行时基础。
MCP¶
已移至 配置 — MCP、技能和插件。
技能¶
已移至 配置 — MCP、技能和插件。
插件¶
已移至 配置——MCP、技能与插件。章节:Codex harness 插件配置。
浏览器¶
已移至 配置——浏览器、UI 与桌面。
UI¶
已移至 配置——浏览器、UI 与桌面。
桌面¶
已移至 配置——浏览器、UI 与桌面。章节:配对节点桌面。
网关¶
已移至 配置——网关。章节:OpenAI 兼容端点、多实例隔离、gateway.tls、gateway.reload。
云 Worker 环境¶
已移至 配置——云 Worker 环境。章节:Crabbox 配置文件、静态 SSH 开发配置文件。
钩子¶
已移至 配置——钩子。章节:Hook HTTP 合约、Hook agent 负载、Hook 会话与 agent 策略、映射详细信息、Hook 重试与扇出、Gmail 集成。
Canvas 小组件呈现器¶
已移至 配置——MCP、技能与插件。
发现¶
已移至 配置——运行时基础。章节:mDNS(Bonjour)、广域网(DNS-SD)。
环境¶
已移至 配置——环境、密钥与包含。章节:env(内联环境变量)、环境变量替换。
密钥¶
已移至 配置——环境、密钥与包含。章节:secrets.egressProxy、SecretRef、支持的凭证表面、密钥提供者配置。
认证存储¶
已移至 配置——环境、密钥与包含。
审计¶
已移至 配置——审计、日志、诊断与遥测。
日志¶
已移至 配置——审计、日志、诊断与遥测。
诊断¶
已移至 配置——审计、日志、诊断与遥测。
遥测¶
已移至 配置——审计、日志、诊断与遥测。
更新¶
已移至 配置——运行时基础。
ACP¶
已移至 配置——运行时基础。
向导¶
已移至 配置——运行时基础。
身份¶
请参阅 Agent 默认值 下的 agents.entries 身份字段。
桥接(旧版,已移除)¶
已移至 配置——运行时基础。
自动化(cron)¶
已移至 配置——自动化与媒体模板变量。章节:cron.failureAlert。
媒体模型模板变量¶
已移至 配置——自动化与媒体模板变量。
配置包含($include)¶
已移至 配置——环境、密钥与包含。
相关¶
- 配置
- 配置示例
- Doctor
- Cloud Workers ——这些 worker 设置所配置的功能
openclaw configure——交互式提示,无需手动编辑文件即可修改这些设置
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw