OpenClaw Control Center 使用教程

📖 项目简介

OpenClaw Control Center 是一个本地部署的 OpenClaw 控制中心，将 AI 智能体从不可见的黑盒变为一个透明的仪表盘。它为非技术人员提供了可观测性和确定性，无需深入后端就能掌握 AI 的真实状态。

项目默认采用只读模式、本地 Token 认证，所有高危操作均默认禁用，安全性放在第一位。

💡

GitHub 地址： https://github.com/TianyiDataScience/openclaw-control-center

✨ 八大核心面板

📊

总览 Overview

一眼掌握 AI 健康状态、决策等待和关键行动项

💰

用量 Usage

追踪每日/7天/30天用量、花销趋势和上下文压力

👥

人员 Staff

实时查看谁在工作、谁在待命、谁被阻塞

🤝

协作 Collaboration

可视化智能体之间的对话链路和任务传递

📋

任务 Tasks

查看当前工作、审批链、执行证据和阻塞项

📄

文档 Documents

直接编辑智能体使用的真实工作文档

🧠

记忆 Memory

检查每个智能体的记忆健康度和可搜索性

⚙️

设置 Settings

连接健康、安全风险摘要、更新状态一目了然

💻 环境要求

已安装的 OpenClaw 环境
可访问的 OpenClaw Gateway
Node.js 和 npm（建议 Node 18+）
对 OpenClaw 主目录的读取权限

⚠️

可选但推荐：~/.openclaw、~/.codex 目录和订阅快照，用于更丰富的仪表盘数据展示。

🚀 安装步骤

克隆项目

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

安装依赖 & 配置环境

                        bash
                        npm install
cp .env.example .env
                    

首次运行保持 .env 中的安全默认值即可，仅在需要时修改 GATEWAY_URL 或路径。

构建 & 测试

                        bash
                        npm run build
npm test
npm run smoke:ui
                    

启动控制中心

                        bash
                        npm run dev:ui
                    

打开浏览器访问：

中文界面：http://127.0.0.1:4310/?section=overview&lang=zh
英文界面：http://127.0.0.1:4310/?section=overview&lang=en

🔒 安全默认配置

项目默认采用最安全的配置，开箱即用：

                .env
                READONLY_MODE=true                    # 只读模式
LOCAL_TOKEN_AUTH_REQUIRED=true         # 本地 Token 认证
APPROVAL_ACTIONS_ENABLED=false         # 审批操作禁用
APPROVAL_ACTIONS_DRY_RUN=true          # 审批操作干运行
IMPORT_MUTATION_ENABLED=false          # 导入变更禁用
IMPORT_MUTATION_DRY_RUN=false          # 导入变更非干运行
            

✅

所有高危写入路径默认关闭，不会修改 ~/.openclaw/openclaw.json 配置文件。

❓ 常见问题

Q: 启动后页面显示连接失败怎么办？

请确认 OpenClaw Gateway 正在运行且 .env 中的 GATEWAY_URL 配置正确。控制中心本身可以正常启动，但实时数据需要 Gateway 连接。

Q: 部分面板数据为空是正常的吗？

是的。如果你的环境缺少订阅快照、Codex 数据等可选数据源，相关面板会显示为降级状态，不影响其他功能使用。

Q: 支持 Windows 系统吗？

支持。推荐使用 npm run dev:ui 启动，这是跨平台最可靠的入口，尤其在 Windows Shell 环境下。

Q: 可以让 OpenClaw 自动完成安装吗？

可以！项目提供了 INSTALL_PROMPT.md（中文）安装提示文件，将内容复制到 OpenClaw 中即可自动完成环境检测、依赖安装、配置和验证。