realizemultiagent/使用手册.md

多Agent系统使用手册

快速开始

系统要求

• 操作系统：Windows 10/11（也支持Linux/macOS）
• OpenClaw版本：2026.3.24或更高
• 磁盘空间：至少1GB可用空间
• 内存：建议8GB或以上（每个角色约占用200MB）

安装步骤

1. 确保OpenClaw已安装

   openclaw --version
   # 应显示：OpenClaw 2026.3.24 (cff6dc9)
   

2. 下载系统文件

   • 系统已位于：D:\openclaw-multi-agent\
   • 如需要重新部署，可复制整个目录

3. 一键启动系统

   cd D:\openclaw-multi-agent
   start-all.bat
   

基础操作

启动单个角色

# 启动产品经理
start-pm.bat

# 启动后端工程师
start-backend.bat

# 启动前端工程师
start-frontend.bat

# 启动测试工程师
start-qa.bat

启动所有角色

# 一键启动所有核心角色（4个窗口）
start-all.bat

停止系统

• 简单方式：直接关闭各个命令行窗口
• 批量停止：使用任务管理器结束OpenClaw进程

角色使用指南

1. 产品经理（PM）

启动：start-pm.bat 或 openclaw workspace roles\pm

常用命令：

# 查看所有任务
[PM] 列出所有任务

# 创建新任务
[PM] 创建任务：用户评论功能

# 查看任务详情
[PM] 查看 TASK-2026-0328-001 详情

# 分配任务
[PM] 将任务 TASK-2026-0328-001 分配给后端

2. 后端工程师（BE）

启动：start-backend.bat 或 openclaw workspace roles\dev-backend

常用命令：

# 查看分配的任务
[BE] 查看我的任务

# 开始开发
[BE] 开始开发 TASK-2026-0328-001

# 提交代码
[BE] 提交用户认证模块代码

# 请求代码评审
[BE] 请求CTO评审用户认证模块

3. 前端工程师（FE）

启动：start-frontend.bat 或 openclaw workspace roles\dev-frontend

常用命令：

# 查看设计稿
[FE] 查看用户登录页面设计稿

# 开始前端开发
[FE] 开始开发登录页面

# 联调测试
[FE] 请求后端联调用户登录接口

4. 测试工程师（QA）

启动：start-qa.bat 或 openclaw workspace roles\qa

常用命令：

# 查看待测试任务
[QA] 查看待测试任务

# 开始测试
[QA] 开始测试用户登录模块

# 提交测试报告
[QA] 提交用户登录模块测试报告

# 报告缺陷
[QA] 发现缺陷：登录页面验证码不刷新

项目管理

创建新项目

1. PM创建项目需求

   [PM] 创建新项目：电商平台用户系统
   

2. 编写需求文档

   [PM] 编写电商用户系统需求文档
   

3. 技术评审

   [CTO] 评审电商用户系统技术方案
   

任务管理

查看任务状态

# 查看所有任务
[PM] 任务列表

# 查看进行中任务
[PM] 查看进行中任务

# 查看已完成任务
[PM] 查看已完成任务

任务状态流转

待处理 (todo) → 进行中 (in-progress) → 待测试 (testing) → 已完成 (done)
      ↓               ↓               ↓               ↓
    [PM]           [开发]           [QA]           [PM]

文档管理

所有文档存储在shared/目录下：

文档类型	存储位置	说明
需求文档	shared/specs/	产品需求规格说明书
任务卡片	shared/tasks/	项目任务卡片
设计稿	shared/designs/	UI设计稿、原型图
测试报告	shared/reports/	测试报告、缺陷记录
代码文件	shared/code/	前后端代码
会议纪要	shared/memory/	项目会议记录、决策

协作流程示例

示例：开发用户登录功能

第1步：PM创建需求

# 在PM窗口中
[PM] 创建任务：用户登录功能
# 系统自动创建：shared/tasks/TASK-20260331-001.md

第2步：PM编写需求文档

[PM] 编写用户登录需求文档
# 系统自动创建：shared/specs/user-login-spec.md

第3步：后端开发

# 在后端窗口中
[BE] 查看新任务
[BE] 开始开发用户登录接口
# 编写代码：shared/code/backend/user-auth.js

第4步：前端开发

# 在前端窗口中
[FE] 查看新任务
[FE] 开始开发登录页面
# 编写代码：shared/code/frontend/login.vue

第5步：测试验证

# 在QA窗口中
[QA] 查看待测试任务
[QA] 测试用户登录功能
# 生成报告：shared/reports/test-login-20260331.md

第6步：PM验收

# 在PM窗口中
[PM] 验收用户登录功能
[PM] 更新任务状态为完成

高级功能

消息路由系统

系统支持通过消息前缀自动路由：

前缀	路由到	示例
[PM]	产品经理	[PM] 创建新需求
[BE]	后端工程师	[BE] 实现接口
[FE]	前端工程师	[FE] 开发页面
[QA]	测试工程师	[QA] 测试功能
[CTO]	技术总监	[CTO] 技术评审
[@all]	所有角色	[@all] 紧急会议通知

批量操作

# 批量分配任务
[PM] 将任务001分配给后端，任务002分配给前端

# 批量更新状态
[PM] 将所有进行中任务标记为待测试

# 批量导出报告
[PM] 导出本月所有项目报告

数据备份与恢复

# 备份整个系统
backup-system.bat

# 恢复系统
restore-system.bat backup-20260331.zip

# 导出项目数据
[PM] 导出电商项目所有文档

故障排除

常见问题

问题1：角色无法启动

症状：运行批处理文件后立即关闭 解决：

# 检查OpenClaw安装
openclaw --version

# 检查工作空间权限
cd D:\openclaw-multi-agent
dir roles\pm

# 手动启动测试
openclaw workspace roles\pm

问题2：角色无法访问共享目录

症状：角色提示找不到shared目录 解决：

# 检查目录是否存在
dir D:\openclaw-multi-agent\shared

# 检查权限
icacls D:\openclaw-multi-agent\shared

问题3：消息路由失败

症状：消息前缀无法正确路由 解决：

# 检查AGENTS.md中的路由规则
type D:\openclaw-multi-agent\AGENTS.md

# 测试路由
[PM] 测试消息路由

系统维护

每日检查

# 检查系统状态
check-system.bat

# 清理临时文件
clean-temp.bat

# 备份重要数据
daily-backup.bat

每周维护

# 更新OpenClaw版本
update-openclaw.bat

# 优化数据库
optimize-database.bat

# 生成周报
generate-weekly-report.bat

最佳实践

项目管理最佳实践

1. 明确需求：PM必须先写清楚需求文档
2. 小步快跑：每个任务不要太大，2-3天完成最佳
3. 及时沟通：遇到问题立即在对应角色中提出
4. 文档先行：先写文档，再写代码

角色协作最佳实践

1. 专业分工：每个角色只做自己专业的事
2. 边界清晰：明确各角色的职责边界
3. 信息透明：所有信息共享在shared目录
4. 尊重流程：严格按照工作流程执行

系统使用最佳实践

1. 定期备份：每天备份重要数据
2. 版本控制：使用Git管理代码和文档
3. 监控告警：设置系统监控和告警
4. 持续优化：根据使用反馈不断优化系统

附录

快捷键参考

操作	快捷键	说明
启动所有角色	Win+R → start-all.bat	快速启动
切换角色窗口	Alt+Tab	在角色间切换
复制任务ID	Ctrl+C	复制任务编号
快速搜索	Ctrl+F	在文档中搜索

文件命名规范

• 任务文件：TASK-YYYYMMDD-序号.md
• 需求文档：{模块名}-spec.md
• 测试报告：test-{模块名}-YYYYMMDD.md
• 设计稿：design-{页面名}-v{版本}.md

状态代码说明

状态代码	含义	可操作角色
todo	待处理	PM
in-progress	进行中	BE/FE
testing	测试中	QA
review	评审中	CTO/PM
done	已完成	PM
blocked	阻塞	所有角色

---

手册版本：v1.0
创建时间：2026-03-31
最后更新：2026-03-31
适用系统：OpenClaw多Agent协作系统
维护者：橙子（龙虾助手）

💡 提示：本手册会随系统更新而更新，请定期查看最新版本。