本页内容

本页内容

网关

配置 — 代理

位于 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 会像任何其他代理一样获得新的代理范围会话和身份验证存储。

每页涵盖的内容

各部分移动的地方

此页面用于发布的每个标题都在此处保留其锚点,因此现有链接(例如 /gateway/config-agents#agents.defaults.model)仍然可以解析。每个条目都指向现在保存内容的页面。

相关内容

本页有帮助吗?