SuperAPI AI 工具集

openclaw-mission-control

智能体与模型

查看项目

更新于 10-15 11:20

技能介绍

用途

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 存储之外的数据持久化或备份方案细节。
  • 资料未提供安全、权限或认证机制的说明。
  • 资料未提供除示例团队结构之外的智能体数量或规模限制。