OpenClaw 任务控制中心

OpenClaw 任务控制中心是用于跨团队和组织运行 OpenClaw 的集中式运营与治理平台，提供统一的可见性、审批控制以及网关感知编排功能。它为运维人员提供了一个单一界面，用于工作编排、代理和网关管理、基于审批的治理以及基于 API 的自动化。

平台概述

任务控制中心旨在成为 OpenClaw 的日常运营界面。团队无需将工作分散到多个工具中，而可以在一个系统中完成活动的计划、执行、审查和审计。

核心运营领域：

• 工作编排：管理组织、看板组、看板、任务和标签。
• 代理运营：从统一的控制界面创建、检查并管理代理生命周期。
• 治理与审批：通过明确的审批流程路由敏感操作。
• 网关管理：连接并操作分布式环境中的网关集成。
• 活动可见性：查看系统操作的时间线，以加快调试和问责。
• API 首选模型：支持来自同一平台的 Web 工作流和自动化客户端。

使用场景

• 多团队代理运营：从单个控制平面运行跨组织的多个看板和看板组。
• 人工参与的执行：在执行敏感操作前需要审批，并将决策轨迹附加到工作中。
• 分布式运行时控制：连接网关并操作远程执行环境，而无需更改运维人员的工作流程。
• 审计和事件回顾：使用活动历史重建发生了什么、何时发生以及由谁发起。
• 基于 API 的流程集成：将内部工作流和自动化客户端连接到与 UI 相同的运营模式。

任务控制中心的独特之处

• 运营优先设计：专为可靠地运行代理工作而构建，而不仅仅是创建任务。
• 内置治理：审批、认证模式和清晰的控制边界均为一等公民。
• 网关感知编排：专为同时运行本地和连接的运行时环境而设计。
• 统一的 UI 和 API 模型：运维人员和自动化以相同的方式操作对象和生命周期。
• 团队规模结构：组织、看板组、看板、任务、标签和用户在一个记录系统中。

适用人群

• 在自托管或内部环境中运行 OpenClaw 的平台团队。
• 需要明确审批和可审计性控制的运营和工程团队。
• 希望在不丢失可用 Web UI 的情况下实现 API 可访问运营的组织。

几分钟内开始使用

方案 A：一键式生产级初始化

如果您尚未克隆仓库，可以使用以下命令行运行安装程序：

curl -fsSL https://raw.githubusercontent.com/abhi1693/openclaw-mission-control/master/install.sh | bash

如果当前目录中没有本地检出，此命令会将仓库克隆到 ./openclaw-mission-control。

如果您已经克隆了仓库：

./install.sh

安装程序是交互式的，将执行以下操作：

• 询问部署模式（docker 或 local）。
• 在可能的情况下安装缺失的系统依赖项。
• 生成并配置环境文件。
• 初始化并启动所选的部署模式。

安装程序支持矩阵：docs/installer-support.md

方案 B：手动设置

先决条件

• 支持的平台：Linux 和 macOS。在 macOS 上，Docker 模式需要 Docker Desktop；本地模式需要 Homebrew 和 Node.js 22+。
• Docker 引擎
• Docker Compose v2 (docker compose)

1. 配置环境

cp .env.example .env

在启动之前：

• 当 AUTH_MODE=local 时，将 LOCAL_AUTH_TOKEN 设置为非占位符值（至少 50 个字符）。
• 如果您未使用 http://localhost:8000，请确保 BASE_URL 与公共后端源匹配。
• NEXT_PUBLIC_API_URL=auto（默认）解析为 http(s)://<current-host>:8000。
  • 当您的 API 位于反向代理或非默认端口之后时，请设置显式 URL。

2. 启动任务控制中心

docker compose -f compose.yml --env-file .env up -d --build

如果您正在 Docker 中迭代 UI，并希望在源代码更改时自动重新构建前端，请运行：

docker compose -f compose.yml --env-file .env up --build --watch

注意事项：

• Compose Watch 需要 Docker Compose 2.22.0+。
• 您也可以在启动后单独运行监视：

docker compose -f compose.yml --env-file .env up -d --build
docker compose -f compose.yml --env-file .env watch

拉取新更改后，重新构建并重新创建所有服务：

docker compose -f compose.yml --env-file .env up -d --build --force-recreate

对于完全干净的重新构建（无缓存构建层）：

docker compose -f compose.yml --env-file .env build --no-cache --pull
docker compose -f compose.yml --env-file .env up -d --force-recreate

3. 打开应用程序

• 任务控制中心 UI：http://localhost:3000
• 后端健康状态：http://localhost:8000/healthz

4. 停止堆栈

docker compose -f compose.yml --env-file .env down

身份验证

任务控制中心支持两种身份验证模式：

• local：共享 Bearer Token 模式（自托管使用的默认模式）
• clerk：Clerk JWT 模式

环境模板：

• 根目录：/.env.example
• 后端：backend/.env.example
• 前端：frontend/.env.example

文档

完整的部署、生产、故障排除和测试指南位于 /docs。

项目状态

任务控制中心目前处于积极开发中。

• 功能和 API 可能在不同版本之间发生变化。
• 在投入生产使用前，请务必验证并加固您的配置。

贡献

欢迎提交问题和拉取请求。

• 贡献指南
• 未解决的问题

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE。

星标历史

OpenClaw Mission Control 快速上手指南

OpenClaw Mission Control 是 OpenClaw 的集中式运营与治理平台，提供统一的工作编排、代理（Agent）管理、审批流控制及网关集成能力。本指南将帮助开发者在几分钟内完成本地部署。

环境准备

系统要求

• 操作系统：Linux 或 macOS
• Docker 环境：
  • Docker Engine
  • Docker Compose v2+ (命令为 docker compose)
  • macOS 用户推荐安装 Docker Desktop
• 本地开发模式额外要求（若不使用 Docker）：
  • Homebrew (macOS)
  • Node.js 22+

安装步骤

你可以选择一键自动安装或手动配置启动。

方式 A：一键自动安装（推荐）

如果尚未克隆仓库，可直接运行以下命令，脚本会自动克隆代码并引导安装：

curl -fsSL https://raw.githubusercontent.com/abhi1693/openclaw-mission-control/master/install.sh | bash

如果已经克隆了仓库，进入目录后运行：

./install.sh

安装程序将交互式引导你完成：

1. 选择部署模式（docker 或 local）。
2. 自动安装缺失的系统依赖。
3. 生成并配置环境变量文件。
4. 启动服务。

方式 B：手动安装

1. 配置环境变量

复制示例配置文件：

cp .env.example .env

编辑 .env 文件，注意以下关键配置：

• 认证令牌：当 AUTH_MODE=local 时，必须将 LOCAL_AUTH_TOKEN 设置为至少 50 个字符的非占位符字符串。
• 基础 URL：若非默认本地访问，需修改 BASE_URL 匹配后端公网地址。
• API 地址：NEXT_PUBLIC_API_URL 默认为 auto（自动解析为当前宿主机的 8000 端口）。若 API 位于反向代理后或非标准端口，请显式指定 URL。

2. 启动服务

使用 Docker Compose 启动服务：

docker compose -f compose.yml --env-file .env up -d --build

注：若需在开发过程中监听前端代码变化自动重建，可使用 --watch 参数（需 Docker Compose 2.22.0+）：

docker compose -f compose.yml --env-file .env up --build --watch

3. 验证运行

服务启动后，可通过以下地址访问：

• 管理控制台 UI: http://localhost:3000
• 后端健康检查: http://localhost:8000/healthz

4. 停止服务

如需停止所有容器：

docker compose -f compose.yml --env-file .env down

基本使用

启动成功后，打开浏览器访问 http://localhost:3000。

1. 登录系统：

   • 若使用默认的 local 认证模式，输入你在 .env 中配置的 LOCAL_AUTH_TOKEN 即可进入。

2. 核心操作：

   • 工作编排：在界面中创建组织（Organizations）、看板组（Board Groups）及任务（Tasks）。
   • 代理管理：统一查看和管理 Agent 的生命周期状态。
   • 审批治理：配置敏感操作的审批流，确保操作可追溯。
   • 活动审计：在时间轴视图中查看系统操作记录，用于调试和合规审查。

3. API 集成：

   • 平台采用 API First 设计，所有 UI 操作均对应底层 API。你可以直接调用后端接口（默认端口 8000）将内部自动化流程接入 Mission Control。