OpenClaw 生态系统的可视化指挥中心，提供 Agent/Subagent 实时监控、时间线调试、告警管理和多代理编排能力。基于 React 19 + Vite 7 构建，支持 SSE 流式更新和可配置的等距办公室布局。
openClawOffice 是一个基于 Web 的可视化指挥中心，专门用于实时监控和编排 OpenClaw 生态系统中的 Agent 与 Subagent。当前版本 0.0.0，处于活跃开发阶段，采用 MIT 许可证。
- OpenClaw 生态中缺乏统一的可视化界面来监控多代理运行状态
- 调试 Agent 行为时缺少时间线回放和事件追踪能力
- 多代理场景下难以快速定位异常和编排任务
- 仅支持本地单用户场景：运行约束绑定
127.0.0.1
- 依赖 OpenClaw 运行时：需预装在
~/.openclaw/ 目录
- 前端监控工具定位：不直接执行 Agent 逻辑，仅提供观测与命令入口
| 特性 | 说明 |
|---|
| 实时监控 | SSE 流式更新，2.5 秒刷新周期，支持轮询降级 |
| 等距办公室视图 | 5 个功能区：Strategy Room / Ops Floor / Spawn Lab / Build Pods / Recovery Lounge |
| 可配置房间布局 | 支持 ring、grid、line、cluster 四种形状 |
| Agent/Subagent 区分 | 不同样式标识，支持实体聚类 |
| 时间线调试器 | 播放、过滤、事件类型筛选 |
| 命令面板 | ⌘/Ctrl + K 快捷键唤起 |
| 告警规则引擎 | 自定义告警规则，⌘/Ctrl + Shift + A 打开告警中心 |
| OpenClaw Hub | 项目状态仪表板，渐进式信息披露 |
| ARIA 无障碍 | 符合无障碍标准 |
openClawOffice/
├── src/
│ ├── components/ # React 组件
│ ├── hooks/ # 自定义 hooks（useOfficeStream）
│ ├── lib/ # 核心逻辑
│ └── types/ # TypeScript 类型
├── server/ # Vite 插件 API（嵌入式中间件）
├── public/assets/ # 静态资源和配置
└── docs/ # 文档
~/.openclaw/ 目录下的 agents 和 subagents 数据 → server/office-state.ts 构建 OfficeSnapshot → 通过 /api/office/snapshot 或 /api/office/stream (SSE) 输出 → useOfficeStream hook 消费 → 渲染到 OfficeStage（等距视图）、EventRail（时间线）、Stats bar（统计）
- API-as-Plugin：无独立后端进程，
server/ 作为 Vite 中间件插件运行
- 房间布局算法：根据 zone-config.json 动态计算实体位置
- 哈希精灵：
hashString(entityId) 从 Kenney 精灵表选择确定性头像
- 气泡提取：会话文件最新 JSONL 行解析为对话气泡
- 配置热重载：分区配置每 10 秒自动刷新
- Node.js 18+（推荐 20+）
- pnpm 8+
- OpenClaw 运行时安装在
~/.openclaw/
git clone https://github.com/Two-Weeks-Team/openClawOffice.git
cd openClawOffice
pnpm install
pnpm dev
# 访问 http://127.0.0.1:5179
| 变量 | 默认值 | 描述 |
|---|
OPENCLAW_STATE_DIR | ~/.openclaw | OpenClaw 状态目录 |
OPENCLAW_PROJECT_DIR | ../openclaw | OpenClaw 项目根目录 |
OPENCLAW_GATEWAY_PORT | 18789 | OpenClaw 网关端口 |
PORT | 5179 | 开发服务器端口 |
| 端点 | 方法 | 描述 |
|---|
/api/office/snapshot | GET | 完整办公室状态快照 |
/api/office/stream | GET | SSE 实时更新流 |
/api/office/metrics | GET | 服务器指标和诊断 |
/api/office/openclaw-hub | GET | OpenClaw 项目状态快照 |
/api/office/openclaw-hub/doc | GET | 完整文档内容（?path=） |
| 快捷键 | 操作 |
|---|
| ⌘/Ctrl + K | 打开命令面板 |
| ⌘/Ctrl + H | 切换 OpenClaw Hub |
| ⌘/Ctrl + Shift + A | 打开告警中心 |
| Escape | 关闭面板/清除选择 |
| + / - | 缩放 |
| 0 | 重置缩放 |
| F | 适应内容 |
- AI 代理运营监控（实时查看执行状态、子代理生命周期）
- 调试与诊断（时间线回放、会话消息检查）
- 多代理编排（等距办公室视图管理多达 50 个活动代理）
- 项目健康度总览（OpenClaw Hub 仪表板）