多代理架构与通信

基于 OpenClaw 平台构建的多代理生态系统,包含主代理、研究代理、工作代理、英语教师等多个专职 Agent,通过 Mattermost Bot 和 Cron 任务实现独立运作。

概述

多代理架构是围绕 OpenClaw 平台构建的 AI 代理生态系统。从最初的单一主代理 Dora,逐步扩展为包含 Research、Work Assistant、Miss E 等多个专职代理的矩阵。每个代理拥有独立的工作区、记忆库、上下文窗口和 Cron 定时任务,通过 Mattermost Bot 账号与用户交互。

架构设计遵循”专注+隔离+并行”原则:研究代理的论文笔记不会与工时提醒混杂,英语教学的上下文不会挤占开发讨论空间。系统还经历了从 Agent Teams 理论研究到实际落地的完整过程,包括 MetaGPT、AutoGen、CrewAI 等框架的对比分析。

代理间通信目前主要依赖用户中转或 sessions_spawn API,但存在工作区继承(cwd 继承调用方)的已知限制。最实用的方式是通过 Mattermost 直接给目标 bot 发消息。

关键点

  • 上下文隔离:每个代理拥有独立的 128k context window,互不干扰
  • 独立工作区:每个代理有独立的 ~/.openclaw/workspace-{agent}/ 目录
  • 自驱动机制:通过 Cron 定时任务实现自主工作,不依赖用户触发
  • Agent Factory Skill:标准化代理创建流程,10步完成新代理初始化
  • 通信限制sessions_spawn 的 cwd 会继承调用方,需通过 Mattermost 直发消息实现真正的工作区隔离
  • 研究代理架构优化:包含 heartbeat 工作循环、任务队列 (tasks.json)、标准研究工作流(提问→文献→假设→POC→结论→报告)

技术细节

代理矩阵

| 代理            | Bot              | 模型                  | 用途     |
| --------------- | ---------------- | --------------------- | -------- |
| main (Dora)     | @dora            | claude-opus-4.6       | 日常助手 |
| research        | @researcher      | claude-sonnet-4.6     | 独立研究 |
| work            | @work-assistant  | gpt-5.4               | 日常工作 |
| misse           | @misse           | FW-GLM-5              | 英语教学 |
| research-craft  | @research-craft  | claude-opus-4.6     | ClawCraft 开发 🏰 |
| research-portal | @research-portal | gpt-5.4 (prism)       | 门户研究 |

研究代理工作区结构

workspace-research/
├── AGENTS.md           # 工作流 + 任务拣选规则
├── SOUL.md             # 人格:严谨研究员
├── HEARTBEAT.md        # 自驱动检查清单
├── memory/             # 跨项目知识
├── projects/
│   └── project-a/
│       ├── README.md   # 项目状态(每次工作后更新)
│       ├── tasks.json  # 任务队列
│       ├── notes/      # 调研笔记
│       ├── poc/        # POC代码(git管理)
│       └── output/     # 产出报告
└── skills/

Cron 任务配置

# Research 工作循环:每天4次
UTC 01:00, 05:00, 09:00, 13:00 (= CST 09, 13, 17, 21)

# Research 日报:每天一次
UTC 13:00 (= CST 21:00)

# Miss E 备课:每天一次
UTC 10:00 (= CST 18:00)

代理间通信方式

  1. sessions_spawn — 从一个代理派任务给另一个(但 cwd 继承调用方)
  2. Mattermost 消息 — 通过 bot 账号互发消息(推荐方式)
  3. 用户中转 — 用户作为中间人传递信息

Agent Teams 研究结论

  • 推荐架构:流水线 + 动态编排(PM → 架构师 → 工程师 → QA)
  • 关键实践:结构化交付物(强类型 Schema)、质量闸门(Lint/编译/测试)
  • 框架对比:MetaGPT(最接近真实流程)、AutoGen(最灵活)、CrewAI(轻量易用)

时间线

  • 2026-03-02: 初始代理配置:main + javis + javis-code
  • 2026-03-02: AI Agent Teams 深度调研完成(MetaGPT/AutoGen/CrewAI 对比)
  • 2026-03-11: 创建 Research 代理,配置独立工作区和 Cron 自驱动
  • 2026-03-11: 创建 Work Assistant 代理,绑定 @work-assistant bot
  • 2026-03-11: 创建 Miss E 独立代理,完善英语教学系统
  • 2026-03-11: 固化 Agent Factory Skill,标准化创建流程
  • 2026-03-11: 工时提醒和 Azure DevOps 任务迁移到 Work Agent
  • 2026-03-18: 删除闲置的 javis 和 javis-code 代理
  • 2026-03-18: 完成模型均匀分配,10个 agent 分配到4个 provider

相关页面

Nexora 多代理扩展

以下信息来源于 nexora 的 Mattermost DM 聊天记录(2026-03-31)。

Nexora Platform 将多代理架构延伸到了 DevOps 领域,形成了独立的 6 Bot 矩阵:

Bot角色职责
@nexora 🦞运维管家(总调度)服务监控、基础设施、任务分发
@nexora-fe 🎨前端开发React/Vue/CSS、UI 组件
@nexora-be ⚙️后端开发API、数据库、后端架构
@nexora-qa 🧪测试自动化测试、Bug 跟踪
@nexora-docs 📝文档API 文档、知识库
@nexora-alert 🔔告警通知监控告警、CI 结果推送

与 Prism 项目的 5 Bot 团队(PM/Arch/Data/UI/Docs)类似,Nexora 采用了按职能分工的子代理模式,由 @nexora 作为总调度分发任务。每个 Bot 需要独立工作区和人设配置。

架构差异:Prism Bot 团队聚焦于单一项目(Agentic BI Hackathon),而 Nexora Bot 矩阵是面向平台级的持续运维和开发支持。

Prism PM 工作区隔离

以下信息来源于 bnef 的 Mattermost DM 聊天记录(2026-03-13)。

BNEF Bot(prism-pm)配置了 5 个 Agent 的独立工作区,确保每个 Agent 在自己的空间干活不互相踩文件:

AgentWorkspaceAgentDir
prism-pm~/.openclaw/workspaceworkspace/agents/prism-pm
prism-archworkspace-prism-archworkspace-prism-arch/.openclaw
prism-dataworkspace-prism-dataworkspace-prism-data/.openclaw
prism-uiworkspace-prism-uiworkspace-prism-ui/.openclaw
prism-docsworkspace-prism-docsworkspace-prism-docs/.openclaw

每个工作区包含完整结构:SOUL.md、IDENTITY.md、AGENTS.md、MEMORY.md、TOOLS.md、USER.md、tasks/active.json、src/、docs/、data/。

Subagent 通信机制

PM 不直接写代码/文档,只做调度。跨 Agent 协作时通过 subagent 机制派发任务(不在群里互相 @ 以避免死循环)。prism-pm 的 subagents.allowAgents 配置为 ["prism-arch", "prism-data", "prism-ui", "prism-docs"],其他 Agent 只能回调 prism-pm。