TaoAI·发现最好的AI工具
openclaw agents:多智能体的工作区、角色模板与绑定关系
AI教程新发布

openclaw agents:多智能体的工作区、角色模板与绑定关系

agents 子命令管的是隔离:每个智能体有自己的工作区、认证与路由。用角色模板起一个新智能体,用 bind 决定哪个渠道账号归它,比手工改配置更不容易把权限弄串。

作者:TaoAI 编辑部 · 发布于 · 引用规范见来源与引用规范

一个智能体等于三样东西

在 OpenClaw 里,一个智能体不是一条模型配置,而是工作区加认证再加路由的组合。工作区决定它读哪些文件、写哪些产物;认证决定它能用哪个提供商账号;路由决定哪些渠道消息归它处理。openclaw agents 这组命令就是把这三样东西一起管理的入口,不带子命令时等价于列出所有智能体。

创建:交互模式与非交互模式的区别

创建一个智能体可以走向导,也可以一次给全参数。带工作区、模型、目录、绑定与非交互标志中的任意一个,就会走非交互路径;非交互模式要求给出名称,且在没有指定角色时必须给出工作区。只加 JSON 输出并不会跳过向导,此时提示与状态写到标准错误,标准输出只在完成后给一份摘要。

这里有一条运行时约束值得先记住:基础的非交互创建会使用正在运行的本地网关,绑定到它的状态所有者;方法不支持、回复丢失或认证失败时,命令不会退回本地写入,以免出现两处状态不一致。而交互式设置、指定角色、指定智能体目录、以及绑定操作,都要求本地网关先停掉,因为这些流程在工作区、凭证与配置的落定过程中要独占状态。正确做法是通过服务管理方停掉网关,等它真正退出,再重跑同一条命令。

还有一个失败形态:请求的绑定已经属于另一个智能体。非交互创建会保留新智能体与不冲突的绑定,但以状态 1 退出,并在摘要里点名冲突项;正确的后续动作是用绑定与解绑命令处理,而不是删掉重建。名称 main 也只是普通智能体 ID,如果安装已经归别的智能体所有,重建它可能需要先跑修复命令处理遗留的会话或共享认证归属。

角色模板省掉了「先做身份仪式」这一步

指定角色可以在交互与非交互模式下使用。内置角色有四个:协调者负责把专家串起来并作为唯一对接人;研究者负责收集证据并交回带引用的研究简报;写作者把简报与素材变成可用草稿;审阅者按需求检查产物并给出可执行的发现。一个角色会预置 AGENTS.md、SOUL.md 与一份完整的 IDENTITY.md,USER.md 仍用标准模板;工作区里已有的文件会被保留,不会被覆盖。

角色带一个实用的小差别:新建的角色工作区会跳过身份引导流程,不再生成引导文件——因为它已经有完整的身份定义,不需要再问一遍。角色的名称、表情与主题会存进智能体配置,内置角色不改动技能。也就是说,用角色起一个智能体,得到的是一套可直接执行的工作方式,而不是一个空壳等你填。

绑定:路由是按渠道账号分的

绑定把渠道的某个账号指给某个智能体,形式是渠道名加可选的账号 ID,可以重复传多个。创建之后随时能加绑与解绑,也可以用带绑定明细的列表命令查看完整路由规则,而不是只看每个智能体的计数摘要。路由在运行时会按点对点与账号的优先级判断,所以同一个渠道下不同账号可以落到不同智能体。

有一个容易误解的细节:绑定记录里省略或留空的账号 ID,指的是字面上的默认账号,与渠道给命令用的首选账号无关。在多账号环境里排错时,先确认这条绑定到底指向哪个账号,比反复改智能体配置更快。

身份字段的优先级与降级状态

身份信息的来源有两处:配置里的字段优先,没配的字段回落到工作区里的身份文件;头像值不受支持或本地图片读不出来时,也回落到工作区头像。想从工作区的身份文件反向写入配置,或者单独指定头像,都有对应子命令。

列表里还会出现一种状态:某个智能体的数据库实际属于另一个智能体,它会被标记为降级,并给出拒绝原因与修复指引。这时网关仍可以继续服务健康的智能体,只要修好文件再重启即可。默认智能体的标记也存在配置里,没有指定时所有条目都报非默认;控制界面里的设为默认动作写的是同一个配置项。理解了这些边界,多智能体部署才不会在「谁能收到哪条消息」上反复打转。