---

Alpha 版软件 — 任务控制中心目前处于积极开发中。API、数据库模式和配置格式可能会在不同版本之间发生变化。请在部署到生产环境之前查看【安全注意事项】。

目录

• 快速入门
• 团队为何选择任务控制中心
• 用例指南
• 开始使用代理
• 文档
• 功能特性
• 架构
• API 参考
• 开发
• 故障排除
• 安全
• 基于任务控制中心构建的应用
• 路线图
• 贡献
• 支持
• 许可证

32 个面板	任务、代理、技能、日志、令牌、记忆、安全、定时任务、告警、Webhook、流水线等——全部集成在一个单页应用界面中。
实时更新	WebSocket + SSE 推送更新，配合智能轮询机制，当您离开时会暂停刷新。确保数据始终最新。
零外部依赖	使用 SQLite 数据库，只需一条命令 `pnpm start` 即可运行。无需 Redis、Postgres 或 Docker。
基于角色的访问控制	提供查看者、操作员和管理员三种角色，并结合会话与 API 密钥认证。支持 Google 登录及管理员审批流程。
质量门控	内置 Aegis 审核系统，未经批准的任务将无法完成。
技能中心	浏览、安装并扫描来自 ClawdHub 和 skills.sh 注册中心的代理技能安全性。支持磁盘与数据库之间的双向同步。
多网关支持	可同时连接多个代理网关。提供 OpenClaw、CrewAI、LangGraph、AutoGen 和 Claude SDK 等框架适配器。
周期性任务	支持自然语言调度（如“每天早上 9 点”），并能根据 Cron 表达式生成模板任务。
Claude Code 桥接	只读集成，可在仪表盘上展示 Claude Code 团队的任务、会话和配置信息。
代理评估与安全	四层评估框架、信任评分、敏感信息检测、MCP 调用审计以及钩子配置文件（极简/标准/严格）。

---

快速入门

一键安装

git clone https://github.com/builderz-labs/mission-control.git
cd mission-control
bash install.sh --local     # 或：bash install.sh --docker

安装完成后：

open http://localhost:3000/setup    # 创建您的管理员账号

安装脚本会自动处理 Node.js 22+、pnpm 和依赖项，并生成安全凭证。对于 Windows 用户，请在 PowerShell 中运行 .\install.ps1 -Mode local。

手动设置

git clone https://github.com/builderz-labs/mission-control.git
cd mission-control
nvm use 22 && pnpm install
pnpm dev                    # 访问 http://localhost:3000/setup

Docker 零配置

docker compose up           # 自动生成凭证，重启后数据仍会保留

预构建镜像

该项目会在主分支和版本标签上发布多架构镜像至 GHCR。

docker pull ghcr.io/builderz-labs/mission-control:latest
docker run --rm -p 3000:3000 ghcr.io/builderz-labs/mission-control:latest

Docker Hub 的发布是可选的，可能取决于组织的包可见性或密钥设置。如果 docker.io/builderz-labs/mission-control 不可用，请使用 GHCR。

针对生产环境加固（只读文件系统、能力降级、HSTS、网络隔离）：

docker compose -f docker-compose.yml -f docker-compose.hardened.yml up -d

---

团队为何选择任务控制中心

• 可预测的编排：一个仪表盘即可实现任务流、调度、质量门控和审计追踪。
• 更快的操作响应：实时代理/任务/安全遥测数据，无需拼凑多个工具。
• 本地优先部署：基于 SQLite 的堆栈，无需强制依赖 Redis 或 Postgres。
• 默认安全：RBAC、信任评分、敏感信息检测以及加固部署配置。

用例指南

1. 在 5 分钟内搭建本地控制中心

• 运行 bash install.sh --local
• 打开 /setup
• 通过 UI 创建您的第一个代理和任务

2. 运行带有质量门控的多代理工作流

• 注册专业代理（研究、编码、审核）
• 启用编排规则和质量审查
• 在看板中全程跟踪交接过程

3. 安全地运行生产环境

• 使用 docker-compose.hardened.yml 部署
• 配置 MC_ALLOWED_HOSTS 和 TLS 反向代理
• 持续监控信任评分和安全审计面板

4. 集成现有 CLI 代理，无需重新平台化

• 通过 CLI 集成连接 Claude Code/Codex
• 保持现有工作流程，同时增加集中式的可观测性和控制能力

---

开始使用代理

在不到 5 分钟内注册您的第一个代理——无需网关：

export MC_URL=http://localhost:3000
export MC_API_KEY=your-api-key   # 在首次登录后于设置中显示

# 注册代理
curl -X POST "$MC_URL/api/agents/register" \
  -H "Authorization: Bearer <MC_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"name": "scout", "role": "researcher"}'

# 创建任务
curl -X POST "$MC_URL/api/tasks" \
  -H "Authorization: Bearer <MC_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"title": "研究竞争对手", "assigned_to": "scout", "priority": "medium"}'

# 作为代理轮询队列
curl "$MC_URL/api/tasks/queue?agent=scout" \
  -H "Authorization: Bearer <MC_API_KEY>"

如需完整操作指南，请参阅 快速入门指南。

---

文档

指南	你将学到的内容
快速入门	注册代理、创建任务、完成任务 — 5 分钟
代理设置	SOUL 个性、配置、心跳、代理来源
编排	多代理工作流、自动调度、质量审查门控
CLI 参考	适用于无头或脚本化使用的完整 CLI 命令列表
CLI 集成	直接连接 Claude Code、Codex 或任何 CLI 工具
部署	生产环境部署、反向代理、VPS 设置
安全加固	Docker 安全加固、CSP、网络隔离
发布流程	SemVer 策略、分支策略、标签/发布检查清单
API 参考	OpenAPI 3.1 规范 — 101 个 REST 端点，附带 Scalar UI，访问地址为 /api-docs

网关可选模式

Mission Control 可以在不连接网关的情况下独立运行——这对于有防火墙限制的 VPS 部署，或主要进行项目/任务操作时非常有用：

NEXT_PUBLIC_GATEWAY_OPTIONAL=true pnpm start

任务看板、项目、代理、会话、调度器、Webhook、告警和成本跟踪等功能在没有网关的情况下均可正常工作。但实时会话更新和代理消息传递需要活跃的网关连接。

项目健康文件

• CONTRIBUTING.md — 贡献流程和开发规范
• SECURITY.md — 漏洞披露与安全政策
• CODE_OF_CONDUCT.md — 社区行为期望
• CHANGELOG.md — 发布历史
• RELEASE.md — 发布流程与检查清单
• LICENSE — MIT 许可证

---

功能特性

代理管理

监控代理状态、配置模型、查看心跳，并管理从注册到退役的完整代理生命周期。支持从 ~/.agents/、~/.codex/agents/ 和 ~/.claude/agents/ 进行本地代理发现。代理 SOUL 系统实现双向工作空间同步。

任务看板

基于 Kanban 的看板，包含六个列（收件箱 → 已分配 → 进行中 → 审核 → 质量审核 → 完成），支持拖放、优先级划分、指派、线程式评论以及内联子代理孵化。多项目支持，每个项目可自定义工单前缀。

内存知识图谱

通过内存浏览器、基于文件系统的内存树以及会话、内存块和关联知识文件的交互式关系图，探索代理的知识。

技能中心

浏览、安装并管理来自本地目录和外部注册表（ClawdHub、skills.sh）的代理技能。内置安全扫描器可在安装前检测提示注入、凭据泄露、数据外泄、混淆内容及危险的 Shell 命令。支持五个技能根目录：~/.agents/skills、~/.codex/skills、项目本地目录以及 ~/.openclaw/skills。

成本跟踪

按模型细分的令牌使用仪表盘，包含趋势图和成本分析。由 Recharts 提供支持，实现会话级别的粒度。

安全审计与代理信任

实时态势评分（0-100）、代理消息中的秘密检测、MCP 工具调用审计、注入尝试追踪以及每项代理的信任分数。钩子配置文件（极简/标准/严格）允许运维人员根据部署需求调整安全严格程度。

代理评估框架

四层评估：输出评估（基于黄金数据集的任务完成度评分）、轨迹评估（收敛性/循环检测）、组件评估（工具可靠性，包括 p50/p95/p99 延迟）以及漂移检测（与四周滚动基准相比，阈值为 10%）。

自然语言重复任务

使用自然语言创建重复任务，例如“每天早上 9 点”或“每 2 小时”。内置的调度解析器会将这些表达式转换为 Cron 表达式，并存储在任务元数据中。模板克隆模式会保留原始任务作为模板，并按计划生成带有日期的子任务。

Claude Code 集成

• 会话跟踪 — 自动发现 ~/.claude/projects/ 中的本地 Claude Code 会话，提取令牌用量、模型信息、成本估算和活动状态。
• 任务桥接 — 只读扫描器会将 ~/.claude/tasks/ 和 ~/.claude/teams/ 中的团队任务和配置显示在仪表盘上。
• 直接 CLI — 无需网关即可直接连接 Claude Code、Codex 或任何 CLI 工具。

活动动态

跨所有代理、任务和系统事件的实时活动流。可按事件类型、代理或时间范围进行筛选。

集成

出站 Webhook 支持交付历史记录、指数退避重试、断路器机制以及 HMAC-SHA256 签名验证。GitHub Issues 同步支持标签/负责人映射。代理间可通过通信 API 进行消息传递。

框架适配器

内置适配层，支持多代理注册：OpenClaw、CrewAI、LangGraph、AutoGen、Claude SDK 以及通用回退方案。每个适配器都会将注册、心跳和任务报告标准化为统一接口。

工作空间管理

通过 /api/super/* 端口实现多租户工作空间隔离。可创建客户实例、监控部署作业，并在必要时清理后注销租户。每个工作空间都拥有独立的隔离环境，配备专用网关和状态目录。

---

架构

mission-control/
├── src/
│   ├── proxy.ts               # 认证网关 + CSRF 防护 + 网络访问控制
│   ├── app/
│   │   ├── page.tsx           # 单页应用外壳 — 路由所有面板
│   │   ├── login/page.tsx     # 登录页面
│   │   └── api/               # 101 个 REST API 路由
│   ├── components/
│   │   ├── layout/            # 导航栏、页眉、实时信息流
│   │   ├── dashboard/         # 概览仪表板
│   │   ├── panels/            # 32 个功能面板
│   │   └── chat/              # 客服聊天 UI
│   ├── lib/
│   │   ├── db.ts              # SQLite（better-sqlite3，WAL 模式）
│   │   ├── auth.ts            # 会话 + API 密钥认证，RBAC
│   │   ├── migrations.ts      # 39 个数据库模式迁移
│   │   ├── scheduler.ts       # 后台任务调度器
│   │   ├── skill-sync.ts      # 双向磁盘 ↔ 数据库技能同步
│   │   ├── skill-registry.ts  # 注册表客户端及安全扫描器
│   │   ├── agent-evals.ts     # 四层客服评估框架
│   │   ├── security-events.ts # 安全事件日志记录器 + 信任评分
│   │   └── adapters/          # 框架适配器
│   └── store/index.ts         # Zustand 状态管理
└── .data/                     # 运行时数据（SQLite 数据库、令牌日志）

技术栈

层次	技术
框架	Next.js 16（App Router）
UI	React 19，Tailwind CSS 3.4
语言	TypeScript 5.7
数据库	SQLite 通过 better-sqlite3（WAL 模式）
状态管理	Zustand 5
图表	Recharts 3
实时通信	WebSocket + Server-Sent Events
认证	scrypt 哈希算法，会话令牌，RBAC
验证	Zod 4
测试	Vitest（282 个单元测试）+ Playwright（295 个端到端测试）

认证

方法	详情
会话 Cookie	POST /api/auth/login — 有效期 7 天
API 密钥	x-api-key 头部
Google Sign-In	OAuth，需管理员审批流程

角色	权限
viewer	只读
operator	读写（任务、客服、聊天）
admin	全权限（用户、设置、系统运维）

API 参考

Mission Control 提供 101 个 REST 端点，使用 OpenAPI 3.1 文档化。本地运行时可在 /api-docs（Scalar UI）浏览交互式 API 文档，或查看 openapi.json。

核心端点一览

领域	关键端点
客服	GET/POST /api/agents，POST /api/agents/register，POST /api/agents/sync
任务	GET/POST /api/tasks，GET /api/tasks/queue，PUT /api/tasks/[id]
技能	GET/POST /api/skills，GET/POST /api/skills/registry
安全	GET /api/security-audit，GET /api/security-scan
评估	GET/POST /api/agents/evals，GET /api/agents/optimize
监控	GET /api/status，GET /api/tokens，GET /api/activities
Webhook	GET/POST/PUT/DELETE /api/webhooks，POST /api/webhooks/test
Claude Code	GET /api/claude/sessions，GET /api/claude-tasks
流水线	GET /api/pipelines，POST /api/pipelines/run
工作空间	GET/POST /api/super/tenants，GET/POST /api/super/provision-jobs

环境变量

完整列表请参阅 .env.example。关键变量：

变量	必需	描述
AUTH_USER	否	初始管理员用户名（默认：admin）
AUTH_PASS	否	初始管理员密码（未设置时自动生成）
API_KEY	否	用于无头访问的 API 密钥（未设置时自动生成）
OPENCLAW_CONFIG_PATH	否*	openclaw.json 的绝对路径
OPENCLAW_STATE_DIR	否*	OpenClaw 状态目录的精确路径（默认：~/.openclaw）。建议优先使用此变量，以避免双重嵌套
OPENCLAW_HOME	否*	旧版别名 — 被视为 父级 主目录（.openclaw 会被追加）。当 OPENCLAW_STATE_DIR 已指向状态目录时，请使用该变量
MISSION_CONTROL_DATA_DIR	否	存放所有 MC 数据文件的目录（数据库、令牌等）。独立服务器部署时，建议使用绝对路径，以便在重建后仍能保留数据。
MC_CLAUDE_HOME	否	~/.claude 目录的路径
MC_ALLOWED_HOSTS	否	生产环境的主机白名单
NEXT_PUBLIC_GATEWAY_OPTIONAL	否	可在不连接网关的情况下运行

*仅对内存浏览器、日志查看器和网关功能必需。

---

开发

pnpm dev              # 开发服务器
pnpm build            # 生产构建
pnpm typecheck        # TypeScript 检查
pnpm lint             # ESLint
pnpm test             # Vitest 单元测试（282 个）
pnpm test:e2e         # Playwright E2E 测试（295 个）
pnpm quality:gate     # 执行所有检查

诊断工具

bash scripts/station-doctor.sh     # 安装健康检查
bash scripts/security-audit.sh     # 安全配置审计

故障排除

问题	解决方法
登录时出现“内部服务器错误”	pnpm rebuild better-sqlite3（Node 版本不匹配）
Docker：网关无法连接	在 .env 中设置 OPENCLAW_GATEWAY_HOST=host.docker.internal
Docker：浏览器 WebSocket 连接失败	将 NEXT_PUBLIC_GATEWAY_HOST 留空（自动检测）或设置为浏览器可访问的主机名
所有页面均显示 404 错误	清除 Next.js 缓存：rm -rf .next && pnpm dev
AUTH_PASS 中包含 # 被忽略	将其用引号括起来：AUTH_PASS="my#pass" 或使用 AUTH_PASS_B64

详细故障排除指南请参阅 docs/deployment.md。

安全

• 部署前 务必更改所有默认凭据
• 对于任何可网络访问的部署，请在反向代理后部署并启用 TLS
• 切勿直接暴露于公共互联网，除非已配置 MC_ALLOWED_HOSTS 和 TLS
• 漏洞报告请参阅 SECURITY.md

---

使用 Mission Control 打造

正在生产环境中使用 Mission Control 的团队和项目。添加您的项目！

项目	描述
MUTX	客服基础设施平台 — 移植并扩展了 Mission Control，用于多客服编排
Builderz	跨 32+ 已发布产品的 AI 客服舰队管理

您正在使用 Mission Control 吗？ 我们非常乐意介绍您。请开一个带有 showcase 标签的问题，或在 Twitter 上@@nyk_builderz 提及。

路线图

计划中的工作请参阅 未解决的问题。

• 不依赖特定客服框架的网关支持 — 可连接任何编排框架
• Flight Deck — 原生桌面伴侣应用（Tauri v2），配备 PTY 终端网格和系统托盘 HUD
• 一流的每客服成本分解
• OAuth 审批界面优化
• API 令牌轮换界面

贡献

欢迎贡献代码。设置说明和指南请参阅 CONTRIBUTING.md。

支持

如果您觉得这个项目有用，请考虑支持这项开源工作：

Solana: BYLu8XD8hGDUtdRBWpGWu5HKoiPrWqCxYFSh4oxXuvPg

---

许可证

MIT © 2026 Builderz Labs

Mission Control 快速上手指南

Mission Control 是一个开源的 AI 智能体编排仪表盘。它支持管理智能体集群、分发任务、追踪成本以及协调多智能体工作流。该工具完全自托管，无需外部依赖（如 Redis 或 Postgres），基于 SQLite 运行。

注意：当前软件处于 Alpha 阶段，API 和配置格式可能在版本更新中发生变化。生产环境部署前请务必查阅安全注意事项。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux, macOS, 或 Windows (需 PowerShell)
• Node.js：版本 22 或更高
• 包管理器：推荐安装 pnpm
• 可选容器环境：Docker & Docker Compose (如需容器化部署)
• 网络：能够访问 GitHub (克隆代码) 和 npm/pnpm registry

安装步骤

您可以选择以下三种方式之一进行安装：

方式一：一键脚本安装（推荐）

这是最快捷的方式，脚本会自动处理 Node.js 检查、依赖安装及安全凭证生成。

Linux / macOS:

git clone https://github.com/builderz-labs/mission-control.git
cd mission-control
bash install.sh --local

Windows (PowerShell):

git clone https://github.com/builderz-labs/mission-control.git
cd mission-control
.\install.ps1 -Mode local

方式二：手动安装

如果您希望手动控制依赖安装过程：

git clone https://github.com/builderz-labs/mission-control.git
cd mission-control

# 切换至 Node.js 22 并安装依赖
nvm use 22 && pnpm install

# 启动开发服务器
pnpm dev

方式三：Docker 零配置安装

无需安装任何本地依赖，直接通过 Docker 运行：

docker compose up

或者使用预构建镜像：

docker run --rm -p 3000:3000 ghcr.io/builderz-labs/mission-control:latest

基本使用

安装完成后，按照以下步骤初始化并使用系统：

1. 初始化管理员账户

启动服务后，在浏览器中打开设置页面创建首个管理员账户：

http://localhost:3000/setup

2. 获取 API 密钥

登录仪表盘后，进入 Settings (设置) 页面，复制您的 MC_API_KEY。后续操作需要通过该密钥进行认证。

3. 注册智能体与创建任务

您可以通过命令行 API 快速注册一个智能体并下发任务。请替换 <MC_API_KEY> 为您刚才获取的密钥。

注册智能体：

export MC_URL=http://localhost:3000
export MC_API_KEY=your-api-key

curl -X POST "$MC_URL/api/agents/register" \
  -H "Authorization: Bearer <MC_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"name": "scout", "role": "researcher"}'

创建任务：

curl -X POST "$MC_URL/api/tasks" \
  -H "Authorization: Bearer <MC_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"title": "Research competitors", "assigned_to": "scout", "priority": "medium"}'

智能体轮询任务队列：

curl "$MC_URL/api/tasks/queue?agent=scout" \
  -H "Authorization: Bearer <MC_API_KEY>"

4. 进阶功能提示

• 无网关模式：如果仅需任务管理和项目协作，无需连接外部智能体网关，可设置环境变量启动：

  NEXT_PUBLIC_GATEWAY_OPTIONAL=true pnpm start
  

• 技能中心：在仪表盘中浏览并安装来自 ClawdHub 或 skills.sh 的智能体技能，系统会自动进行安全扫描。
• 成本追踪：在仪表盘查看各模型的 Token 使用量和成本趋势。

更多详细文档（如多智能体编排、CLI 集成、生产环境加固）请参考项目根目录下的 docs/ 文件夹。