SuperAPI AI 工具集

openclaw-control-center

部署与运维

查看项目

更新于 10-15 08:26

技能介绍

用途

OpenClaw Control Center 是 OpenClaw 智能体的本地化、安全优先控制中心,目标是把 OpenClaw 从黑盒状态转为可本地审计的可视化系统。它面向需要掌握智能体运行情况、Token 消耗与协作过程的运维/管理场景。

主要能力

  • 总览(Overview):系统健康状态、待处理项、风险信号与运行摘要。
  • 用量(Usage):按日/7天/30天统计 Token 消耗、配额、上下文压力与订阅窗口。
  • 人员(Staff):区分正在执行的智能体与排队中的智能体,而非仅显示“有任务”。
  • 协作(Collaboration):父子会话交接,以及经过验证的跨会话消息(例如 Main ⇄ Pandas)。
  • 任务(Tasks):任务看板、审批、执行链与运行证据。
  • 记忆(Memory):按智能体查看记忆健康度、可检索性及源文件编辑。
  • 文档(Documents):从实际源文件打开共享文档与智能体核心文档。
  • 设置(Settings):连接器接线状态、安全风险摘要与更新状态。

使用方式

安装步骤:

git clone https://github.com/TianyiDataScience/openclaw-control-center.git cd openclaw-control-center npm install cp .env.example .env npm run build npm test npm run smoke:ui npm run dev:ui

访问地址:

http://127.0.0.1:4310/?section=overview&lang=zh http://127.0.0.1:4310/?section=overview&lang=en

建议使用 npm run dev:ui,而不是 UI_MODE=true npm run dev,后者尤其在 Windows shell 下更不稳定。

关键命令:

  • npm run dev:ui:启动 UI 服务器(推荐)
  • npm run dev:一次性监控运行,不带 HTTP UI
  • npm run build:TypeScript 编译
  • npm test:运行测试套件
  • npm run smoke:ui:对 UI 端点做冒烟测试
  • npm run lint / npm run lint:fix:ESLint 检查与自动修复

UI 通过查询参数导航,section 可选:overview | usage | staff | collaboration | tasks | memory | documents | settings;lang 可选 zh(默认)| en。

安全默认配置

.env 中安全相关默认值:

  • READONLY_MODE=true:禁用所有状态变更端点
  • LOCAL_TOKEN_AUTH_REQUIRED=true:导入/导出与写入 API 需要本地令牌
  • IMPORT_MUTATION_ENABLED=false:完全阻止导入变更
  • IMPORT_MUTATION_DRY_RUN=false:启用导入时先 dry-run
  • APPROVAL_ACTIONS_ENABLED=false:审批操作默认硬禁用
  • APPROVAL_ACTIONS_DRY_RUN=true:启用审批时以 dry-run 运行

连接与 UI 配置:OPENCLAW_GATEWAY_URL=http://127.0.0.1:PORT、OPENCLAW_HOME=~/.openclaw、PORT=4310、DEFAULT_LANG=zh。

适用场景与限制

适用于需要本地审计 OpenClaw 智能体活动、Token 归属、任务执行链与会话协作的用户。项目有严格约束:所有修改必须保持在 control-center/ 目录内,绝不修改 ~/.openclaw/openclaw.json。前置条件包括 Node.js 与 npm、可访问的 OpenClaw Gateway、对本地 ~/.openclaw 的读取权限,完整用量数据可选需要 ~/.codex 与 OpenClaw 订阅快照。记忆部分的作用范围受 openclaw.json 中列出的智能体限制。审批操作需同时显式设置 APPROVAL_ACTIONS_ENABLED=true 与 APPROVAL_ACTIONS_DRY_RUN=false 才会真正执行。本资料未提供收费、价格与效果相关信息。