openclaw-control-center

本地优先、安全优先的 OpenClaw 智能体控制中心——提供只读默认、令牌归属、协作追踪和安全写入操作的可见性仪表盘。

66Star

13Fork

更新于 2026/7/9

获取 Skill 源代码

openclaw-control-center

技能由 ara.so 提供 — Daily 2026 Skills 合集

OpenClaw Control Center 将 OpenClaw 从一个黑盒转变为本地可审计的控制中心。它提供智能体活动、令牌消耗、任务执行链、跨会话协作、内存状态和文档来源的可见性——默认采用安全优先策略，所有变更操作默认关闭。

功能概述

概览：系统健康状态、待处理项、风险信号和运行摘要
用量：每日/7天/30天令牌消耗、配额、上下文压力、订阅窗口
人员：谁正在活跃执行 vs 排队中——不仅仅是“有任务”
协作：父子会话交接和经过验证的跨会话消息（例如 Main ⇄ Pandas）
任务：任务面板、审批、执行链、运行证据
内存：每个智能体的内存健康、可搜索性和源文件编辑
文档：从实际源文件打开的共享文档和智能体核心文档
设置：连接器接线状态、安全风险摘要、更新状态

安装

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 终端中。

项目结构

openclaw-control-center/
├── control-center/          # 所有修改必须在此目录内进行
│   ├── src/
│   │   ├── runtime/         # 核心运行时、连接器、监控器
│   │   └── ui/              # 前端 UI 组件
│   ├── .env.example
│   └── package.json
├── docs/
│   └── assets/              # 截图和文档图片
├── README.md
└── README.en.md

关键约束：仅修改 control-center/ 内的文件。切勿修改 ~/.openclaw/openclaw.json。

环境配置

复制 .env.example 为 .env 并配置：

# 安全默认值——未经理解影响请勿更改
READONLY_MODE=true
LOCAL_TOKEN_AUTH_REQUIRED=true
IMPORT_MUTATION_ENABLED=false
IMPORT_MUTATION_DRY_RUN=false
APPROVAL_ACTIONS_ENABLED=false
APPROVAL_ACTIONS_DRY_RUN=true

# 连接
OPENCLAW_GATEWAY_URL=http://127.0.0.1:PORT
OPENCLAW_HOME=~/.openclaw

# UI
PORT=4310
DEFAULT_LANG=zh

安全标志含义

标志	默认值	作用
`READONLY_MODE`	`true`	所有改变状态的端点禁用
`LOCAL_TOKEN_AUTH_REQUIRED`	`true`	导入/导出和写入 API 需要本地令牌
`IMPORT_MUTATION_ENABLED`	`false`	导入变更完全阻止
`IMPORT_MUTATION_DRY_RUN`	`false`	启用时导入为试运行模式
`APPROVAL_ACTIONS_ENABLED`	`false`	审批操作硬禁用
`APPROVAL_ACTIONS_DRY_RUN`	`true`	启用时审批操作为试运行

关键命令

# 开发
npm run dev:ui          # 启动 UI 服务器（推荐）
npm run dev             # 一次性监控运行，无 HTTP UI

# 构建与测试
npm run build           # TypeScript 编译
npm test                # 运行测试套件
npm run smoke:ui        # UI 端点冒烟测试

# 代码检查
npm run lint            # ESLint 检查
npm run lint:fix        # 自动修复 lint 问题

TypeScript 代码示例

连接到运行时监控器

import { createMonitor } from './src/runtime/monitor';

const monitor = createMonitor({
  gatewayUrl: process.env.OPENCLAW_GATEWAY_URL ?? 'http://127.0.0.1:4310',
  readonlyMode: process.env.READONLY_MODE !== 'false',
  localTokenAuthRequired: process.env.LOCAL_TOKEN_AUTH_REQUIRED !== 'false',
});

// 获取当前系统概览
const overview = await monitor.getOverview();
console.log(overview.systemStatus);      // 'healthy' | 'degraded' | 'critical'
console.log(overview.pendingItems);      // number
console.log(overview.activeAgents);      // Agent[]

读取智能体人员状态

import { StaffConnector } from './src/runtime/connectors/staff';

const staff = new StaffConnector({ gatewayUrl: process.env.OPENCLAW_GATEWAY_URL });

// 获取正在活跃执行的智能体（不仅仅是排队中）
const activeAgents = await staff.getActiveAgents();
activeAgents.forEach(agent => {
  console.log(`${agent.name}: ${agent.status}`);
  // 'executing' | 'queued' | 'idle' | 'blocked'
  console.log(`Current task: ${agent.currentTask?.title ?? 'none'}`);
  console.log(`Last output: ${agent.lastOutput}`);
});

// 获取完整人员名单，包括队列深度
const roster = await staff.getRoster();

追踪跨会话协作

import { CollaborationTracer } from './src/runtime/connectors/collaboration';

const tracer = new CollaborationTracer({ gatewayUrl: process.env.OPENCLAW_GATEWAY_URL });

// 获取父子会话交接
const handoffs = await tracer.getSessionHandoffs();
handoffs.forEach(handoff => {
  console.log(`${handoff.parentSession} → ${handoff.childSession}`);
  console.log(`Delegated task: ${handoff.taskTitle}`);
  console.log(`Status: ${handoff.status}`);
});

// 获取经过验证的跨会话消息（例如 Main ⇄ Pandas）
const crossSessionMessages = await tracer.getCrossSessionMessages();
crossSessionMessages.forEach(msg => {
  console.log(`${msg.fromAgent} ⇄ ${msg.toAgent}: ${msg.messageType}`);
  // messageType: 'sessions_send' | 'inter-session message'
});

获取令牌用量和花费

import { UsageConnector } from './src/runtime/connectors/usage';

const usage = new UsageConnector({ gatewayUrl: process.env.OPENCLAW_GATEWAY_URL });

// 今日用量
const today = await usage.getUsageSummary('today');
console.log(`Tokens used: ${today.tokensUsed}`);
console.log(`Cost: $${today.costUsd.toFixed(4)}`);
console.log(`Context pressure: ${today.contextPressure}`);
// contextPressure: 'low' | 'medium' | 'high' | 'critical'

// 7天用量趋势
const trend = await usage.getUsageTrend(7);
trend.forEach(day => {
  console.log(`${day.date}: ${day.tokensUsed} tokens, $${day.costUsd.toFixed(4)}`);
});

// 按任务归属令牌（谁消耗了计划任务令牌）
const attribution = await usage.getTokenAttribution();
attribution.tasks.forEach(task => {
  console.log(`${task.title}: ${task.tokensUsed} (${task.percentOfTotal}%)`);
});

读取内存状态

import { MemoryConnector } from './src/runtime/connectors/memory';

const memory = new MemoryConnector({
  openclawHome: process.env.OPENCLAW_HOME ?? '~/.openclaw',
});

// 获取每个活跃智能体的内存健康（限定于 openclaw.json）
const memoryState = await memory.getMemoryState();
memoryState.agents.forEach(agent => {
  console.log(`${agent.name}:`);
  console.log(`  Available: ${agent.memoryAvailable}`);
  console.log(`  Searchable: ${agent.memorySearchable}`);
  console.log(`  Needs review: ${agent.needsReview}`);
});

// 读取智能体的每日内存
const dailyMemory = await memory.readDailyMemory('main-agent');
console.log(dailyMemory.content);

// 编辑内存（需要 READONLY_MODE=false 和有效的本地令牌）
await memory.writeDailyMemory('main-agent', updatedContent, { token: localToken });

检查接线状态

import { WiringChecker } from './src/runtime/connectors/wiring';

const wiring = new WiringChecker({ gatewayUrl: process.env.OPENCLAW_GATEWAY_URL });

const status = await wiring.getWiringStatus();
status.connectors.forEach(connector => {
  console.log(`${connector.name}: ${connector.status}`);
  // status: 'connected' | 'partial' | 'disconnected'
  if (connector.status !== 'connected') {
    console.log(`  Fix: ${connector.nextStep}`);
  }
});

审批任务（受限端点）

import { TaskConnector } from './src/runtime/connectors/tasks';

const tasks = new TaskConnector({
  gatewayUrl: process.env.OPENCLAW_GATEWAY_URL,
  approvalActionsEnabled: process.env.APPROVAL_ACTIONS_ENABLED === 'true',
  approvalActionsDryRun: process.env.APPROVAL_ACTIONS_DRY_RUN !== 'false',
});

// 如果 APPROVAL_ACTIONS_ENABLED=false（默认），此操作会抛出异常
try {
  const result = await tasks.approveTask('task-id-123', { token: localToken });
  if (result.dryRun) {
    console.log('Dry run — no actual state change');
  }
} catch (err) {
  if (err.code === 'APPROVAL_ACTIONS_DISABLED') {
    console.log('Set APPROVAL_ACTIONS_ENABLED=true to enable approvals');
  }
}

UI 部分导航

通过查询参数导航：

http://127.0.0.1:4310/?section=overview&lang=zh
http://127.0.0.1:4310/?section=usage&lang=en
http://127.0.0.1:4310/?section=staff&lang=zh
http://127.0.0.1:4310/?section=collaboration&lang=en
http://127.0.0.1:4310/?section=tasks&lang=zh
http://127.0.0.1:4310/?section=memory&lang=en
http://127.0.0.1:4310/?section=documents&lang=zh
http://127.0.0.1:4310/?section=settings&lang=en

语言：zh（中文，默认）| en（英文）

集成模式

嵌入现有 OpenClaw 工作流

如果您的 OpenClaw 智能体需要将设置指令移交给控制中心，请使用文档化的安装块：

// 在您的 OpenClaw 智能体任务中
const installInstructions = `
cd openclaw-control-center
npm install
cp .env.example .env
# 编辑 .env：设置 OPENCLAW_GATEWAY_URL 和 OPENCLAW_HOME
npm run build && npm test && npm run dev:ui
`;

添加自定义连接器

所有连接器位于 control-center/src/runtime/connectors/。遵循以下模式：

// control-center/src/runtime/connectors/my-connector.ts
import { BaseConnector, ConnectorOptions } from './base';

export interface MyData {
  id: string;
  value: string;
}

export class MyConnector extends BaseConnector {
  constructor(options: ConnectorOptions) {
    super(options);
  }

  async getData(): Promise<MyData[]> {
    // 对于任何写操作，始终检查只读模式
    this.assertNotReadonly('getData is readonly-safe');

    const response = await this.fetch('/api/my-endpoint');
    return response.json() as Promise<MyData[]>;
  }
}

自定义 UI 部分

// control-center/src/ui/sections/MySection.tsx
import React from 'react';
import { useConnector } from '../hooks/useConnector';
import { MyConnector } from '../../runtime/connectors/my-connector';

export const MySection: React.FC = () => {
  const { data, loading, error } = useConnector(MyConnector, 'getData');

  if (loading) return <div>Loading...</div>;
  if (error) return <div>Error: {error.message}</div>;

  return (
    <ul>
      {data?.map(item => (
        <li key={item.id}>{item.value}</li>
      ))}
    </ul>
  );
};

故障排除

"Missing src/runtime" 或 "Missing core source"

这几乎总是意味着工作目录错误：

# 确保您在仓库根目录
pwd  # 应以 /openclaw-control-center 结尾
ls control-center/src/runtime  # 应存在

如果克隆正确但仍然缺失：克隆不完整。重新克隆：

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

UI 无法启动 / 端口冲突

# 检查端口 4310 是否被占用
lsof -i :4310
# 或在 Windows 上
netstat -ano | findstr :4310

# 在 .env 中更改端口
PORT=4311

数据不显示（部分或空白部分）

打开 Settings → 接线状态 (Wiring Status) — 它会列出哪些连接器已连接、部分连接或缺失。
常见原因：
- OPENCLAW_GATEWAY_URL 未设置或端口错误
- OPENCLAW_HOME 未指向实际的 ~/.openclaw
- OpenClaw 订阅快照不在默认路径

令牌认证失败

# 生成本地令牌（参见 openclaw 文档了解令牌位置）
cat ~/.openclaw/local-token

# 在 API 调用中通过标头传递
curl -H "X-Local-Token: <token>" http://127.0.0.1:4310/api/tasks/approve

审批操作静默无反应

检查您的 .env：

APPROVAL_ACTIONS_ENABLED=true   # 必须为 true
APPROVAL_ACTIONS_DRY_RUN=false  # 必须为 false 才能实际执行

两者都必须显式设置。默认是禁用 + 试运行。

内存部分显示非活跃智能体

内存部分限定于 openclaw.json 中列出的智能体。如果已删除的智能体仍然显示：

# 检查活跃智能体
cat ~/.openclaw/openclaw.json | grep -A5 '"agents"'

从 openclaw.json 中移除过时的条目——内存部分将在下次加载时更新。

Windows 终端问题

优先使用 npm run dev:ui 而非 UI_MODE=true npm run dev。跨环境变量设置在 PowerShell/CMD 中行为不同。dev:ui 脚本内部处理了这一点。

前提条件

Node.js + npm
运行中的 OpenClaw 安装，可访问 Gateway
对本地机器上 ~/.openclaw 的读取权限
（可选）~/.codex 和 OpenClaw 订阅快照以获取完整用量数据

你可能还喜欢

blucli

385Kresearch-knowledge

BluOS 命令行工具（blu），用于设备发现、播放控制、多房分组与音量调节。

steipete

获取

agent-architecture-audit

237Kresearch-knowledge

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature.

affaan-m

获取

triaging-issues

102Kresearch-knowledge

Triages GitHub issues by routing to oncall teams, applying labels, and closing questions. Use when processing new PyTorch issues or when asked to triage an issue.

pytorch

获取

继续探索

浏览 research-knowledge 热门 Skills 最近更新

openclaw-control-center

相关 Skills

openclaw-control-center

功能概述

安装

项目结构

环境配置

安全标志含义

关键命令

TypeScript 代码示例

连接到运行时监控器

读取智能体人员状态

追踪跨会话协作

获取令牌用量和花费

读取内存状态

检查接线状态

审批任务（受限端点）

UI 部分导航

集成模式

嵌入现有 OpenClaw 工作流

添加自定义连接器

自定义 UI 部分

故障排除

"Missing src/runtime" 或 "Missing core source"

UI 无法启动 / 端口冲突

数据不显示（部分或空白部分）

令牌认证失败

审批操作静默无反应

内存部分显示非活跃智能体

Windows 终端问题

前提条件

你可能还喜欢

blucli

agent-architecture-audit

triaging-issues

继续探索