本页内容

本页内容

网关

配置参考

~/.openclaw/openclaw.json 的字段级参考:键、默认值以及指向更深层次子系统页面的链接。有关面向任务的设置指南,请参阅 Configuration。通道和插件拥有的命令目录和深度内存旋钮位于它们自己的页面上,而不是在这里。

配置格式为 JSON5(允许注释+尾随逗号)。所有字段都是可选的; OpenClaw 省略时使用安全默认值。

代码真相胜过此页:

  • openclaw config schema 打印用于验证的实时 JSON 架构和 Control UI,并合并 bundled/plugin/channel 元数据。
  • 在编辑配置之前,Agents 应为一个精确的路径范围架构节点调用 gateway 工具操作 config.schema.lookup。
  • pnpm config:docs:check / pnpm config:docs:gen 根据当前架构表面验证此文档的基线哈希。

模式 uiHints 还为每个路径携带解析的 advanced 布尔值。 Control UI 使用它首先显示常见字段并折叠每个部分的高级字段;搜索仍然跨越两个层次。层元数据仅供展示。添加键时,在叶子上声明其层或让它继承最近的祖先声明。默认情况下,没有声明祖先的路径会前进。

专用深度参考:


本参考集中的页面


渠道

每通道配置密钥位于 Configuration - 通道:channels.* 用于 Slack、Discord、Telegram、WhatsApp、Matrix、 iMessage,以及其他通道插件(身份验证、访问控制、多帐户、提及门控)。

Agent 默认值、多代理、会话和消息

请参阅 配置 - 代理 以了解:

  • agents.defaults.*(工作空间、模型、思维、心跳、记忆、媒体、技能、沙箱)
  • multiAgent.*(多代理路由和绑定)
  • session.*(会话生命周期、压缩、修剪)
  • messages.*(消息传递、TTS、markdown渲染)
  • talk.*(通话模式)
    • talk.consultThinkingLevel:在 Control UI Talk 实时咨询后面运行的完整 OpenClaw 代理的思维级别覆盖
    • talk.consultFastMode:Control UI Talk 实时咨询的一次性快速模式覆盖
    • talk.speechLocale:可选的 BCP 47 区域设置 ID,用于 Android、iOS 和 macOS 上的对话语音识别,以及用于 iOS 系统语音回退
    • talk.silenceTimeoutMs:未设置时,Talk 在发送文字记录之前保留平台默认暂停窗口 (700 ms on macOS and Android, 900 ms on iOS)
    • talk.realtime.consultRouting:跳过 openclaw_agent_consult 的最终实时通话记录的网关中继回退

worktreeRoot

工作树存储 (worktreeRoot)、文件系统加速 (worktreeAcceleration) 和实时结帐上限 (worktreeMaxCount) 记录在 Configuration — 运行时基础知识 中。

工具和自定义提供程序

工具策略、实验切换、提供程序支持的工具配置和自定义提供程序/基本 URL 设置位于 Configuration - 工具和自定义提供程序 中。

agents.entries.<id>.tools.github.allowInSandbox 是一个可选布尔值,默认为 false。将其设置在代理的托管 GitHub 身份上,以将该身份公开给代理自己的 Docker 或 Podman 沙箱,包括角色所需的沙箱。该配置文件以只读方式安装在 /openclaw/github 处;有效的共享范围拒绝注入。全局 tools.github 不接受此设置,并且安全审核会对每个选择加入的代理发出警告。有关设置、凭证公开和后端要求,请参阅 GitHub Identity。

模型

移至 配置 — 运行时基础知识 。

MCP

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

技能

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

插件

移至 配置 — MCP、技能和插件。部分:Codex harness插件配置。

桌面

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

UI

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

台式机

移至 配置 — 浏览器、UI 和桌面 。部分:配对节点桌面。

网关

移至 配置 — 网关。部分:OpenAI- 兼容端点、多实例隔离、gateway.tls、gateway.reload。

云工作器环境

移至 配置 — 云工作人员环境。部分:Crabbox 配置文件、静态 SSH 开发配置文件。

钩子

移至 配置 — hooks。部分:Hook HTTP 合同、Hook 代理负载、Hook 会话和代理策略、映射详细信息、Hook 重试和扇出、Gmail 集成。

Canvas 小部件演示器

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

发现

移至 配置 — 运行时基础知识 。部分:mDNS (Bonjour)、广域 (DNS-SD)。

环境

移至 配置 — 环境、机密,并包含 。部分:env(内联环境变量)、环境变量替换。

密钥

移至 配置 — 环境、机密,并包括 。部分:secrets.egressProxy、SecretRef、支持的凭证表面、秘密提供程序配置。

认证存储

移至 配置 — 环境、机密,并包含 。

审计

移至 配置 — 审核、日志记录、诊断和遥测。

日志

移至 配置 — 审核、日志记录、诊断和遥测。

诊断

移至 配置 — 审核、日志记录、诊断和遥测。

遥测

移至 配置 — 审核、日志记录、诊断和遥测。

更新

移至 配置 — 运行时基础知识 。

ACP

移至 配置 — 运行时基础知识 。

向导

移至 配置 — 运行时基础知识 。

身份

请参阅智能体默认设置下 agents.entries 的身份字段。


桥接(旧版,已移除)

移至 配置 — 运行时基础知识 。

自动化(cron)

移至 配置 — 自动化和媒体模板变量。部分:cron.failureAlert。

媒体模型模板变量

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

配置包含($include)

移至 配置 — 环境、机密,并包含 。

相关内容

本页有帮助吗?