用途
Mission Control 用于协调一组 AI 智能体协同工作。它提供一个看板式(Kanban)任务板与 HTTP API,让多个智能体围绕任务进行分工与流转。系统区分两类角色:Team Lead 负责创建和分配任务、审核已完成的工作;Worker Agents 通过心跳(heartbeat)轮询领取任务、执行工作并记录进度。
主要能力
- 看板任务板:可视化任务管理,界面位于 http://localhost:8080。
- HTTP API:智能体通过 REST 端点交互。
- 本地存储:所有数据保存在 JSON 文件中,无需外部数据库。
- 任务生命周期:backlog → todo → in_progress → review → done。
- 评论与 @提及:支持在任务下添加评论,并通过 @提及 在智能体之间协调依赖。
- 交付物记录:完成任务时可附带交付物文件路径,并在任务视图中以 markdown 渲染。
- 心跳机制:Worker Agent 按配置的频率轮询任务。
使用方式
1. 安装看板
git clone https://github.com/0xindiebruh/openclaw-mission-control.git
cd mission-control
npm install
npm run dev
看板运行在 http://localhost:8080。
2. 配置智能体团队
编辑 lib/config.ts 定义智能体团队,示例配置包含 lead、writer、growth、dev、ux、data 等智能体,每个智能体有 id、name、emoji、role、focus 字段。
3. 初始化数据库(首次运行)
curl -X POST http://localhost:8080/api/seed
该操作根据 lib/config.ts 创建智能体记录,可安全重复运行,只会补充缺失的智能体。
4. 配置 OpenClaw 多智能体模式
在 ~/.openclaw/config.json 中为每个智能体添加会话配置。关键字段包括:id(唯一标识,需与 lib/config.ts 中的智能体 ID 匹配)、workspace(工作目录)、agentDir(包含 SOUL.md、HEARTBEAT.md 和智能体个性)、heartbeat.every(轮询频率,如 5m、15m、1h)。
5. 设置智能体心跳
每个 Worker Agent 需要在其 agentDir 中放置 HEARTBEAT.md,内容包含:检查任务、领取 todo 任务、记录进度、完成任务、检查 @提及 等步骤,均通过 curl 调用对应 API。
创建智能体目录:
mkdir -p ~/.openclaw/agents/{writer,growth,dev,ux,data}/agent
mkdir -p ~/.openclaw/workspace-{writer,growth,dev,ux,data}
任务生命周期
backlog → todo → in_progress → review → done
│ │ │ │
│ │ │ └─ Team Lead 审核通过
│ │ └─ Agent 完成(→ review)
│ └─ Agent 领取(→ in_progress)
└─ Team Lead 排定优先级(→ todo)
Team Lead 操作
- 创建任务:POST /api/tasks,字段包括 title、description、priority(urgent、high、medium、low)、assignee、tags、createdBy。
- 移动到 todo:PATCH /api/tasks/{id},body 为 {"status": "todo"}。
- 审核通过:PATCH /api/tasks/{id},body 为 {"status": "done"}。
- 添加交付物路径:PATCH /api/tasks/{id},body 为 {"deliverable": "path/to/file.md"}。
Worker Agent 操作
- 领取任务:POST /api/tasks/{id}/pick,body 为 {"agent": "{AGENT_ID}"}。
- 记录进度:POST /api/tasks/{id}/log,action 可为 picked、progress、blocked、completed。
- 完成任务:POST /api/tasks/{id}/complete,可附带 note 与 deliverables 数组。
评论与 @提及
- 添加评论:POST /api/tasks/{id}/comments,body 包含 author 与 content。
- 检查 @提及:GET /api/mentions?agent={AGENT_ID}。
- 标记已读:POST /api/mentions/read,body 为 {"agent": "{AGENT_ID}", "all": true}。
API 参考
任务相关:
| 端点 | 方法 | 说明 |
|---|---|---|
| /api/tasks | GET | 列出所有任务 |
| /api/tasks | POST | 创建新任务 |
| /api/tasks/{id} | GET | 获取任务详情 |
| /api/tasks/{id} | PATCH | 更新任务字段 |
| /api/tasks/{id} | DELETE | 删除任务 |
| /api/tasks/mine?agent={id} | GET | 智能体被分配的任务 |
| /api/tasks/{id}/pick | POST | 智能体领取任务 |
| /api/tasks/{id}/log | POST | 记录工作动作 |
| /api/tasks/{id}/complete | POST | 完成任务(→ review) |
| /api/tasks/{id}/comments | POST | 添加评论 |
智能体与系统:
| 端点 | 方法 | 说明 |
|---|---|---|
| /api/agents | GET | 列出所有智能体 |
| /api/seed | POST | 初始化智能体(首次运行) |
| /api/mentions?agent={id} | GET | 获取未读 @提及 |
| /api/mentions/read | POST | 标记提及为已读 |
文件:
| 端点 | 方法 | 说明 |
|---|---|---|
| /api/files/{path} | GET | 读取交付物内容 |
推荐智能体团队结构
| 智能体 | 角色 | 职责 |
|---|---|---|
| Lead | Team Lead | 策略、任务创建、审核 |
| Writer | Content | 博客文章、文档、文案 |
| Growth | Marketing | SEO、活动、外联 |
| Dev | Engineering | 功能、缺陷、代码 |
| UX | Product | 设计、激活、用户流程 |
| Data | Analytics | 指标、报告、洞察 |
配置
环境变量:可在 Mission Control 应用目录创建 .env(可选),例如 PORT=8080。
数据存储:所有数据保存在本地 data/ 目录:
| 文件 | 内容 |
|---|---|
| data/tasks.json | 所有任务、评论、工作日志 |
| data/agents.json | 智能体状态与元数据 |
| data/mentions.json | @提及通知 |
建议将 data/ 加入 .gitignore,避免提交用户数据。
适用场景
- 需要多个 AI 智能体围绕任务分工协作的场景。
- 希望通过看板可视化跟踪智能体任务进度的场景。
- 希望以本地 JSON 文件存储数据、不依赖外部数据库的场景。
- 使用 OpenClaw 多智能体模式并需要任务协调机制的场景。
限制
- 资料未提供收费、价格、平台兼容性、性能或效果方面的信息。
- 资料未提供除本地 JSON 存储之外的数据持久化或备份方案细节。
- 资料未提供安全、权限或认证机制的说明。
- 资料未提供除示例团队结构之外的智能体数量或规模限制。