## 项目概述

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. 克隆仓库：
   ```bash
   git clone https://github.com/TianyiDataScience/openclaw-control-center.git
   cd openclaw-control-center
   ```
2. 安装依赖：
   ```bash
   npm install
   ```
3. 创建环境文件：
   ```bash
   cp .env.example .env
   ```
4. 构建并测试：
   ```bash
   npm run build
   npm test
   npm run smoke:ui
   npm run smoke:hall
   ```
5. 启动 UI：
   ```bash
   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 仓库：https://github.com/TianyiDataScience/openclaw-control-center
- 中文 README：https://github.com/TianyiDataScience/openclaw-control-center/blob/main/README.zh-CN.md

## 信息来源和分析时间

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