OpenClaw Control Center：为OpenClaw用户（包括团队和个人）提供统一的监控和管理界面

OpenClaw Control Center 为OpenClaw用户（包括团队和个人）提供统一的监控和管理界面，能显示OpenClaw系统的运行状态，包括系统稳定性、资源消耗（用量与花费趋势）、代理（员工）的实际工作与排队情况、任务的当前进度、审批流程和执行证据。OpenClaw Control Center 为OpenClaw 提供基于源文件的文档和记忆管理功能，让信息与活跃的OpenClaw代理保持同步。OpenClaw Control Center 通过“总览”、“用量”、“员工”、“任务”、“文档”和“记忆”等多个清晰的模块，将复杂的后端信息转化为易于理解的视图。OpenClaw Control Center 默认启用只读模式和本地Token认证，默认禁用高风险的写入操作（如实时导入和审批操作），避免直接暴露原始后端数据，提供结构化的API接口以支持查询和受控修改。

OpenClaw Control Center 适用场景

• 已在使用OpenClaw，需要统一控制中心的团队或个人。

• 在同一台机器或可达本地环境中运行OpenClaw的使用者。

• 想公开发布安全优先的OpenClaw控制台，而非搭建通用agent平台的开发者。

安全默认设置

首次接入时，系统自动启用多重安全配置，降低使用风险：

• 默认只读模式（READONLY_MODE=true）。

• 默认本地token鉴权（LOCAL_TOKEN_AUTH_REQUIRED=true）。

• 默认关闭高风险写操作。

• 审批动作默认关闭（APPROVAL_ACTIONS_ENABLED=false）。

• 审批动作默认dry-run模式（APPROVAL_ACTIONS_DRY_RUN=true）。

• 导入修改功能默认关闭（IMPORT_MUTATION_ENABLED=false）。

• 导入修改默认dry-run模式（IMPORT_MUTATION_DRY_RUN=false）。

OpenClaw Control Center 核心功能

总览

非技术用户的主操作页，集中展示当前总控态势、待处理事项、运行异常、停滞执行、预算风险、工作状态等核心信息，快速判断OpenClaw整体运行是否正常。

用量

展示今日、7天、30天的用量和花费趋势，包含订阅窗口、配额消耗、用量结构和数据连接状态，直观判断花费或额度是否存在风险。

员工

清晰区分“正在执行”和“下一项”任务，展示agent的名字、角色定位、当前状态、正在处理的任务、最近产出及排班情况，明确谁在工作、谁待命、谁卡住、谁在等待。

记忆

基于源文件的记忆工作台，查看和编辑每日记忆与长期记忆，展示范围跟随openclaw.json中的活跃agent，不显示已删除agent的相关内容，方便维护当前在用的记忆信息。

文档

基于源文件的文档工作台，查看和编辑共享文档与agent核心文档，打开与保存均直接操作源文件，无需通过副本中转，便于维护系统生效的工作文档。

任务

整合任务板、排期、审批、执行链和运行证据，区分看板映射与真实执行证据，明确哪些任务正在进行、哪些只是计划、哪些卡住需要介入，清晰掌握任务全状态。

设置

展示安全模式、连接器状态和数据链路预期，明确告知哪些数据已接通、哪些部分可见、哪些高风险动作已关闭，方便排查环境配置问题，解释信号缺失原因。

OpenClaw Control Center 的核心约束

• 仅修改control-center/目录内的文件，不改动外部文件。

• 不会改写~/.openclaw/openclaw.json配置文件。

• 开启鉴权时，导入/导出和所有改状态接口均需本地token验证。

• 高风险操作均有硬开关控制，默认处于关闭或安全模式。

启动 OpenClaw Control Center

通过简单命令即可快速启动项目，步骤如下：

npm install
cp .env.example .env
npm run build
npm test
npm run smoke:ui
UI_MODE=true npm run dev

启动后打开对应地址访问：http://127.0.0.1:4310/?section=overview&lang=en

安装 OpenClaw Control Center

前置准备

• 已安装可用的OpenClaw及可连接的OpenClaw Gateway。

• 本地环境具备node和npm。

• 拥有OpenClaw主目录的读取权限。

• 若需完整展示用量/订阅信息，需确保本地可读取~~/.openclaw、~~/.codex及OpenClaw订阅快照文件（非默认位置需手动指定）。

两种安装方式

推荐方式：OpenClaw自动安装与接线

无需手动配置，将预设安装指令交给OpenClaw，即可自动完成环境检查、依赖安装、配置创建、安全校验等操作，适配多种特殊场景（如非默认路径、多套OpenClaw环境等）。

可直接使用以下文件中的指令：

• 英文版本：INSTALL_PROMPT.en.md

指令将按“环境确认→项目安装→安全配置→验证安装→结果交付”五步执行，自动规避高风险操作，确保安装过程安全可控。

手动配置安装

1、克隆仓库并进入目录：

git clone https://github.com/TianyiDataScience/openclaw-control-center.git
cd control-center

2、安装依赖并复制配置文件：

npm install
cp .env.example .env

3、配置.env文件（默认基线配置如下，仅需修改非默认项）：

GATEWAY_URL=ws://127.0.0.1:18789
READONLY_MODE=true
APPROVAL_ACTIONS_ENABLED=false
APPROVAL_ACTIONS_DRY_RUN=true
IMPORT_MUTATION_ENABLED=false
IMPORT_MUTATION_DRY_RUN=false
LOCAL_TOKEN_AUTH_REQUIRED=true
UI_MODE=false
UI_PORT=4310
# 非默认路径时添加以下配置：
# OPENCLAW_HOME=/path/to/.openclaw
# CODEX_HOME=/path/to/.codex
# OPENCLAW_SUBSCRIPTION_SNAPSHOT_PATH=/path/to/subscription.json

需修改配置的场景：

• GATEWAY_URL：Gateway不在默认本地地址。

• OPENCLAW_HOME：OpenClaw不在~/.openclaw。

• CODEX_HOME：Codex数据不在~/.codex。

• OPENCLAW_SUBSCRIPTION_SNAPSHOT_PATH：订阅/账单快照文件在自定义位置。

• UI_PORT：4310端口已被占用。

验证安装

执行以下命令验证安装是否成功：

npm run build
npm test
npm run smoke:ui

预期结果：build与test均通过，UI smoke输出本地访问地址（如http://127.0.0.1:4310）。

启动与首次检查

1、启动界面：

UI_MODE=true npm run dev

2、首次检查顺序：

• 总览：页面正常打开，可查看系统状态。

• 用量：显示真实数据或明确“数据源未连接”；

• 员工：实时工作状态与active session一致；

• 任务：工作、审批、执行链正常加载；

• 文档/记忆：展示的agent标签与openclaw.json中活跃agent一致。

常见问题排查

• 实时活动全空：可能是GATEWAY_URL错误或OpenClaw Gateway未启动；

• 文档/记忆范围异常：可能是OPENCLAW_HOME指定错误或openclaw.json不可读；

• 用量/订阅无数据：可能是CODEX_HOME或OPENCLAW_SUBSCRIPTION_SNAPSHOT_PATH未配对。

本地命令大全

命令	功能描述
npm run build	构建项目
npm run dev	启动开发模式
npm run dev:continuous	持续开发模式
npm run dev:ui	仅启动UI开发模式
npm run smoke:ui	测试UI启动情况
npm run release:audit	发布前审计（维护者使用）
npm run command:backup-export	备份导出
npm run command:import-validate -- runtime/exports/.json	导入验证
npm run command:acks-prune	清理ack记录
npm test	运行测试
npm run validate	验证项目完整性