OpenClaw Monitor
用 AI 监控 AI:为 OpenClaw 智能体提供免费开源的用量与会话可视化面板。
- Star 数
- ★ 13
- 最近更新
- 6 个月前
- License
- MIT
- 主语言
- JavaScript
- FA 评分
- 36/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用
- 费用
- 免费,无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 已经在跑 OpenClaw Gateway 的开发者,想按模型查看最近 7 天的 prompt/completion 令牌消耗,判断哪个模型的用量在增长。
- 不适合
- 未部署 OpenClaw Gateway 的团队
- 需要观测 OpenClaw 之外其他 AI 运行时的用户
- 只想用一条命令行、不做前后端分离部署的用户
- 维护状态
- 超过半年没有提交最近提交 2026-05-14最新版本 v1.0.0(2026-05-14)
这个 Agent 能做什么,适合哪些场景?
OpenClaw Monitor 是一个面向 OpenClaw AI 智能体的自托管监控面板,采用 MIT 协议开源。它由三部分组成:Vue 3 + Vite + Element Plus + ECharts 的前端仪表盘、基于 Node.js + Express 并带 WebSocket 客户端的后端监控 API,以及位于 openclaw-monitor/ 目录下的监控辅助脚本。数据全部来自本地会话 JSON 文件与 .reset 历史文件,不经过云端,属于完全离线的工作方式。使用流程是:后端先连接运行在 18789 端口的 OpenClaw Gateway,再读取本地会话数据并对外暴露 REST 接口,前端在 localhost:5173/monitor-v2 拉取这些接口做图表渲染。它输出的内容包括令牌用量柱状图、实时会话列表、7 天消息趋势以及系统运行时长与内存指标。
后端监控 API 通过 WebSocket 连接 OpenClaw Gateway(18789 端口)获取状态,并读取本地会话 JSON 文件与 .reset 历史文件,然后以 REST 接口对外提供数据,包括 GET /health、GET /api/gateway/status、GET /api/sessions/list、GET /api/metrics/system、GET /api/messages/stats、GET /api/models/current。前端仪表盘从这些接口取数,用 ECharts 绘制按模型拆分的 7 天 prompt/completion 令牌柱状图与每日消息数量趋势,并用列表展示实时会话的模型、运行时长与状态;同时展示任务调度视图、系统运行时长和内存占用。它支持 Claude Code、OpenAI Codex、DeepSeek V4 等多个模型的数据展示,整个链路的输入是本地会话文件,输出是浏览器中的可视化面板。
- 已经在跑 OpenClaw Gateway 的开发者,想按模型查看最近 7 天的 prompt/completion 令牌消耗,判断哪个模型的用量在增长。
- 同时使用 Claude Code、OpenAI Codex、DeepSeek V4 的用户,希望在同一个面板里对比不同模型的调用与消息分布。
- 运维或值班同学需要实时看到当前有哪些会话在跑、各自用的什么模型、已经运行多久、状态是否正常。
- 想观察智能体定时任务调度情况的用户,通过任务调度视图确认任务是否按预期排布。
- 对数据外发有顾虑、希望监控数据只留在本机的用户,直接读取本地会话 JSON 而不依赖云服务。
- 排查资源问题时,需要结合系统运行时长与内存占用指标一起看会话与消息趋势的用户。
如何安装或部署这个 Agent?
前置条件:Node.js 18+,并且本机已有 OpenClaw Gateway 运行在 18789 端口。Windows 用户可在仓库根目录一键启动:
start-all.bat也可以手动分开启动两个服务。先装并启动后端监控 API(3000 端口):
cd backend && npm install && npm start再开一个终端装并启动前端(5173 端口):
cd frontend && npm install && npm run dev停止服务可使用根目录的 stop-all.bat。README 未说明 Linux/macOS 的一键启动脚本,也未给出环境变量或配置文件清单。
如何使用这个 Agent?
两个服务都起来后,在浏览器打开前端地址即可看到面板:
http://localhost:5173/monitor-v2后端 API 默认监听 3000 端口,可直接调用验证数据:
curl http://localhost:3000/health
curl http://localhost:3000/api/gateway/status
curl http://localhost:3000/api/sessions/list
curl http://localhost:3000/api/metrics/system
curl http://localhost:3000/api/messages/stats
curl http://localhost:3000/api/models/current若前端或后端端口被占用,需要自行调整端口,并保证后端到 Gateway 18789 端口的 WebSocket 连接可用。
这个 Agent 有哪些优点和局限?
- 数据源完全是本地会话 JSON 与 .reset 历史文件,监控链路不依赖云服务,也不会把用量数据外发。
- 按模型拆分的 7 天 prompt/completion 令牌柱状图和每日消息趋势,能直接回答“哪个模型在消耗预算”。
- 界面明确支持 Claude Code、OpenAI Codex、DeepSeek V4 等多模型的并列展示。
- 提供 Windows 一键 start-all.bat / stop-all.bat,前后端分开启动也只需要 npm install 与 npm start 两步。
- REST 接口清晰(/api/sessions/list、/api/metrics/system、/api/messages/stats 等),便于自行接二次告警或报表。
- 强依赖 OpenClaw Gateway 运行在 18789 端口,没有 Gateway 时面板没有可用数据源。
- 只能观测 OpenClaw 生态的会话与令牌数据,README 未提供对其他 AI 运行时的采集适配。
- 需要同时部署后端 API(3000)与前端(5173)两个进程,端口冲突时要手动改配置。
- 一键启动脚本只有 Windows 版本,Linux/macOS 需要照着手动步骤自行拼启动流程。
- 仓库未给出 Docker 镜像、配置文件或环境变量文档,容器化与集中部署需要自行补足。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| OpenClaw Monitor 当前 | 36 · 缺口较多 | 自托管服务免费 | ★ 13 | 6 个月前 | JavaScript | — |
| AgentAcct | 75 · 表现良好 | 命令行工具免费 | ★ 757 | 1 个月前 | Python | Codex · Claude Code |
| OpenClaw 指挥中心 | 62 · 存在缺口 | Agent 插件 / 技能免费 | ★ 250 | 1 个月前 | JavaScript | — |
| ClawMetry | 71 · 存在缺口 | 命令行工具免费版 + 付费版 | ★ 439 | 1 天前 | Python | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
README称数据来自本地会话 JSON、可离线运行,且列出网关连接;但缺少所采集字段、网络流向和敏感数据保护说明,因此数据流与隐私处理仅有薄弱证据。服务默认启用宽泛 CORS,代码也未显示写入、修改或回滚监控数据的机制;故权限、外部影响与恢复能力扣分。CI 使用 npm ci --ignore-scripts,但未见锁文件或依赖审计证据;MIT 许可和仓库名称提供有限来源线索,无法确认维护者身份。
README 的手动启动说明后端端口为 3000,实际 backend/src/index.js 默认端口为 3001;README 所列会话、指标等端点也未出现在所给服务入口(该入口只挂载认证、网关、公告和广告路由),形成直接自洽性问题。CI 有依赖安装和构建步骤,但忽略安装脚本且未见锁文件证据,依赖可用性支持有限。入口包含启动失败日志和通用 500 响应,错误信息处理较基础。
功能针对 OpenClaw 操作者,覆盖会话、模型、令牌、趋势和系统指标,受众与常见场景描述较清楚。能力边界只有限地体现在本地 JSON、离线和单个网关端口等陈述;没有说明支持范围、规模限制或异常数据行为。启动条件要求 Node.js 18+ 和运行中的 Gateway,但未清楚解释配置、网络暴露及多环境适配。
README 按功能、技术栈、结构、安装、API 和架构组织,结构清晰;Windows 一键启动和手动步骤可供入门,但端口与入口代码不一致且没有配置细节。项目名和 Monitor 路径总体稳定,但 README 功能/API 与所给服务入口之间存在差异。演示截图被提及,未提供 FAQ、变更记录或明确限制说明。MIT LICENSE 文本完整,版权年份及持有人明确;发布工作流按时间戳生成版本,但未展示维护负责人或长期维护承诺。
仪表盘以会话、令牌趋势、消息统计和系统指标为输出,面向监控用途,预期具有实用性;README 提供端点列表和可视化说明。由于功能与数据源主要由 README 宣称、所给入口代码未展现这些监控端点,边际价值只获部分支持。Node/npm、本地服务和 Gateway 的运行成本有简要交代,但未讨论资源开销或运维成本。
README 的技术栈、数据源、功能和端点有部分对应的架构图及代码入口线索,但监控功能缺少所给实现文件的佐证,且端口和路由描述不一致,故可追溯性与跨源印证有限。README 明确标示功能和架构陈述,但未区分已实现能力与计划或概述内容;因此事实与推断的边界较弱。
- 源码中未见:敏感信息处理使用专用、低权限、可随时吊销的 API 密钥,不要复用生产凭据,也不要让密钥出现在日志里。
- 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
- README 声称的后端端口和监控 API 与所给后端入口代码不一致;请在采用前核实实际启动方式及路由实现。
- 材料没有说明会话数据的敏感字段、访问控制或网络传输范围;不要据此假定部署默认安全或数据完全离开本机的风险为零。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v1.0.0 OpenClaw Monitor v1.0.0
发布说明摘录
OpenClaw Monitor v1.0.0 — First Stable Release Free open-source monitoring dashboard for OpenClaw AI agents. [](https://github.com/flik2002/openclaw-monitor) [](https://opensource.org/licenses/MIT) Download Binaries > Build assets are published to the [v20260514-140808 release](https://github.com/flik2002/openclaw-monitor/releases/tag/v20260514-140808) (same codebase). | File | Description | |------|-------------| …在 GitHub 查看 ↗ -
v20260514-140808 OpenClaw Monitor 2026-05-14T14:08:08Z
发布说明摘录
OpenClaw Monitor Release Build: v20260514-140808 Date: 2026-05-14T14:08:08Z Included - frontend/dist/ - Built frontend static files - backend/ - Backend (run cd backend && npm start) - openclaw-monitor/ - Helper scripts Quick Start ``` tar -xzf openclaw-monitor-*.tar.gz cd openclaw-monitor cd backend && npm start cd frontend && npm run dev ```在 GitHub 查看 ↗ -
v20260514-134729 OpenClaw Monitor 2026-05-14T13:47:29Z
发布说明摘录
OpenClaw Monitor Release Build: v20260514-134729 Date: 2026-05-14T13:47:29Z Included - frontend/dist/ - Built frontend static files - backend/ - Backend (run cd backend && npm start) - openclaw-monitor/ - Helper scripts Quick Start ``` tar -xzf openclaw-monitor-*.tar.gz cd openclaw-monitor cd backend && npm start cd frontend && npm run dev ```在 GitHub 查看 ↗
常见问题
需要额外付费吗?
必须有 OpenClaw Gateway 吗?
数据会被上传到云端吗?
两个端口冲突了怎么办?
能在 Linux 或 macOS 上一键启动吗?
OpenClaw Monitor 开源吗?
OpenClaw Monitor 安全吗?
OpenClaw Monitor 还在维护吗?
OpenClaw Monitor 是谁开发的?
谢谢反馈,我们会据此改进页面。