TianyiDataScience / openclaw-control-center

TianyiDataScience/openclaw-control-center

open_in_new前往仓库

将OpenClaw从黑盒转变为本地控制中心，让您看得见、信得过、控得住。

项目概览

项目概述

OpenClaw Control Center 是一个面向 OpenClaw 的本地控制中心，旨在将 OpenClaw 从黑盒转变为可查看、可信赖、可控制的本地控制台。它提供可观测性、使用情况、任务、审批、回放、文档和记忆等功能，并强调安全优先的默认配置。项目采用 TypeScript 编写，遵循 MIT 许可证。

核心功能

  • 总览（Overview）：展示健康状态、当前状态、待处理决策和面向操作员的摘要。
  • 使用情况（Usage）：展示使用量、花费、订阅窗口和连接器状态，包括上下文压力。
  • 员工（Staff）：区分真正活跃的代理与仅排队的代理，显示谁在忙碌、空闲、阻塞或等待。
  • 协作（Collaboration）：提供大厅优先的多代理工作聊天，支持实时讨论、执行顺序、交接、审查和证据线程。
  • 任务（Tasks）：展示当前工作、审批、执行链和运行时证据。
  • 文档（Documents） 和 记忆（Memory）：提供基于源文件的工作台，范围限定于活跃的 OpenClaw 代理。
  • 设置（Settings）：包含连接健康、安全风险摘要和更新状态卡片。

适用与不适用场景

适用场景：

  • 希望在一个本地控制中心查看 OpenClaw 健康、使用、任务、审批、回放、文档和记忆的 OpenClaw 用户。
  • 在单台机器或可达的本地环境中运行 OpenClaw 的团队。
  • 希望获得安全优先、面向操作员的 OpenClaw 仪表盘，而非通用代理平台的维护者。

不适用场景：

  • 不是 OpenClaw 本身的替代品。
  • 不是非 OpenClaw 代理栈的通用仪表盘。
  • 不是托管 SaaS 控制平面。

技术架构与依赖

  • 语言：TypeScript
  • 运行时：Node.js 和 npm
  • 核心依赖：OpenClaw Gateway（默认 ws://127.0.0.1:18789）、OpenClaw 运行时、本地文件存储（runtime/ 目录）
  • 架构原则：优先使用官方 OpenClaw 接口，仅在必要时添加薄适配器。
  • 安全默认值：READONLY_MODE=true、LOCAL_TOKEN_AUTH_REQUIRED=true、APPROVAL_ACTIONS_ENABLED=false、IMPORT_MUTATION_ENABLED=false。

安装与快速开始

  1. 克隆仓库： 
    git clone https://github.com/TianyiDataScience/openclaw-control-center.git
cd openclaw-control-center
  2. 安装依赖： 
    npm install
  3. 创建环境文件： 
    cp .env.example .env
  4. 构建并测试： 
    npm run build
npm test
npm run smoke:ui
npm run smoke:hall
  5. 启动 UI： 
    npm run dev:ui
  6. 打开浏览器访问：
    • http://127.0.0.1:4310/?section=overview&lang=en
    • http://127.0.0.1:4310/?section=overview&lang=zh

典型使用方法

  • 查看总览：访问 /?section=overview 快速了解 OpenClaw 当前是否健康。
  • 监控使用情况：访问 /?section=usage-cost 查看今日、7 天、30 天的使用和花费趋势。
  • 管理协作：在大厅发布任务，代理实时讨论，安排执行顺序，观察执行和审查。
  • 检查员工状态：访问 /?section=office-space 查看代理的忙碌状态和职责。
  • 审查任务：访问 /?section=projects-tasks 查看任务板、审批和执行链。
  • 查看审计：访问 /audit 查看时间线、审批和操作审计。

配置与部署要点

  • 环境变量：GATEWAY_URL、OPENCLAW_HOME、OPENCLAW_CONFIG_PATH、OPENCLAW_WORKSPACE_ROOT、CODEX_HOME、LOCAL_API_TOKEN、UI_TIMEZONE、OPENCLAW_CONTROL_UI_URL、UI_BIND_ADDRESS 等。
  • 安全默认值：保持 READONLY_MODE=true、LOCAL_TOKEN_AUTH_REQUIRED=true、APPROVAL_ACTIONS_ENABLED=false、IMPORT_MUTATION_ENABLED=false。
  • Docker 部署：使用 Dockerfile 和 docker-compose.example.yml，确保容器能访问 OpenClaw 数据路径和 Gateway。
  • 多代理工作区：默认布局为 <OPENCLAW_WORKSPACE_ROOT>/agents/<agentId>，自定义布局需在 openclaw.json 中为每个代理指定 workspace。
  • 本地令牌认证：设置 LOCAL_API_TOKEN 为长随机字符串，并在 UI 中用于受保护操作。

限制、风险与许可证

  • 限制：仅操作 control-center/ 目录内的文件；不修改 ~/.openclaw/openclaw.json；默认只读模式；审批操作默认禁用且为干运行。
  • 风险：启用实时导入或审批操作可能带来风险，需谨慎配置；订阅数据缺失时相关面板会降级。
  • 许可证：MIT。

官方链接

信息来源和分析时间

  • 信息来源：GitHub 仓库 README、docs/ 目录下的架构、FAQ、运行手册等文档。
  • 分析时间：2026-03-04（基于文档中的日期）。