本页内容
本页内容
网关
配置 — 代理
位于 agents.*、multiAgent.*、session.*、messages.* 和 talk.* 下的代理作用域配置键。关于通道、工具、网关运行时以及其他顶级键,请参见 配置参考。
创建多代理集群时,OpenClaw 会写入 agents.ownership: "explicit"。此类集群没有默认代理:通道和环境服务需要绑定,或需要使用特定界面的 agentId 目标。升级期间,Doctor 会具体化旧版所有者;单代理配置无需此标记。
在全新安装时,交互式入门会询问第一个代理的名称并使用 main 作为建议值。自动加入将保留历史 main 默认值,除非您通过 openclaw onboard --non-interactive --agent-name <name> ...。唯一指定代理使用与 main 相同的默认工作区和共享身份验证存储;入门引导还会在完成之前将旧版 agent:main:* 会话历史记录迁移到该唯一所有者。
main是普通代理id。在指定代理拥有安装后重用它,因此旧数据永远不会被默默采用:legacy-session-migration-required 意味着 openclaw doctor --fix 必须完成或隔离旧的 agent:main:* 声明,而 shared-auth-store-owned-by-main 意味着 Doctor 必须首先将共享身份验证存储重新定位到 state/openclaw.sqlite。两次修复后,新的 main 会像任何其他代理一样获得新的代理范围会话和身份验证存储。
每页涵盖的内容
- Configuration — 代理工作区和引导程序 — 工作区、cwd、存储库根、技能、引导程序注入、上下文预算、图像和时区。
- 配置 - 代理模型 -
agents.defaults.model、后备链、每个用途的模型插槽和模型选择范围。 - Configuration — 代理运行时和 CLI 后端 — 提供程序和模型的运行时策略、CLI 后端选择和 GPT-5 个性。
- 配置 — 代理心跳、压缩和流 — 心跳运行、系统代理、压缩、上下文修剪、块流和键入指示器。
- Configuration — 代理沙箱 —
agents.defaults.sandbox块:映像、工作区模式、安装和网络策略。 - 配置 — 每个代理条目和多代理路由 —
agents.entries覆盖、multiAgent绑定、绑定匹配字段和访问配置文件。 - 配置 — 代理会话 —
session.*范围、身份链接、重置策略、共享和保留。 - 配置 — 消息和对话 —
messages.*传送、前缀、确认反应、排队、TTS 和talk.*默认值。
各部分移动的地方
此页面用于发布的每个标题都在此处保留其锚点,因此现有链接(例如 /gateway/config-agents#agents.defaults.model)仍然可以解析。每个条目都指向现在保存内容的页面。
- 代理默认
agents.defaults.workspaceagents.defaults.cwdagents.defaults.repoRootagents.defaults.skillsagents.defaults.skipBootstrapagents.defaults.skipOptionalBootstrapFilesagents.defaults.contextInjectionagents.defaults.bootstrapMaxCharsagents.defaults.bootstrapTotalMaxChars- 每代理引导程序配置文件覆盖
- Bootstrap 截断通知
- 上下文预算所有权图
agents.defaults.startupContextagents.defaults.contextLimitsagents.entries.*.contextLimitsskills.limits.maxSkillsPromptCharsagents.entries.*.skillsLimits.maxSkillsPromptCharsagents.defaults.imageMaxDimensionPxagents.defaults.imageQualityagents.defaults.userTimezoneagents.defaults.modelagents.defaults.modelSelectionScopeagents.defaults.modelSelectionScope- 运行时策略
- CLI 后端选择
- OpenAI GPT-5 个性
agents.defaults.heartbeatagents.defaults.systemAgentagents.defaults.compactionagents.defaults.contextPruning- 缓存-ttl模式行为
- 块流
- 打字指示器
agents.defaults.sandboxagents.defaults.sandbox- 沙箱详情
agents.entries(每个代理覆盖)agents.entries(每个代理覆盖)- 多代理路由
- 绑定匹配字段
- 每代理访问配置文件
- 完全访问(无沙箱)
- 只读工具 + 工作区
- 无文件系统访问(仅消息传递)
- 会话
- 会话字段详细信息
- 消息
- 响应前缀
- 确认反应
- Queue
- 入站去抖
- 其他消息键
- TTS(文本转语音)
- Talk