在使用 OpenClaw AI Agent 的过程中,你是否遇到过这样的问题:Agent说"正在生成子Agent",然后你就只能……等着?不知道它在读什么文件、调什么工具、花了多少Token?

别慌,试试下面这个工具。


一、ClawMetry 是什么?

ClawMetry 是一个免费、开源的实时可观测性仪表盘,专门为 OpenClaw AI Agent 打造。你可以把它理解为 AI Agent 界的 Grafana

简单来说,它能让你实时看到你的 Agent 在做什么:

  • 正在读哪些文件、执行什么命令
  • 调用了哪些工具、在"想"什么
  • 子Agent的生成和执行情况
  • Token 消耗和费用明细(按会话、按模型、按工具)
  • 定时任务(Cron)运行状态
  • 系统健康状况(磁盘、服务在线状态等)

官方仓库:https://github.com/vivekchand/clawmetry

官网:https://clawmetry.com

官方示例图


二、核心特性一览

功能 说明
Live Flow 可视化 实时动画 SVG 架构图,Agent 处理消息时会亮灯,不同事件用不同颜色区分
子Agent监控 查看每个子Agent的文件读取、命令执行、工具调用和思考过程
Token & 费用追踪 按会话/模型/工具维度拆解费用,日/周/月图表展示
Session 历史 所有会话都有时间线、工具调用记录和成本,随时回溯
Cron 管理 定时任务状态、运行历史一目了然
配置 自动检测 OpenClaw 的工作空间、日志、会话和定时任务

【截图位置:Token & Cost 费用追踪页面】


三、环境要求

开始之前,确认你的环境满足以下条件:

  • Python 3.8+
  • Flask(pip安装时会自动装好)
  • OpenClaw 已在机器上运行
  • 操作系统:macOS / Linux / Windows(WSL) / 甚至树莓派都行

四、安装配置(30秒搞定)

方法一:pip 安装(推荐)

最简单的方式,一行命令:

pip install clawmetry

安装完成后,直接运行:

clawmetry

【截图位置:终端中执行 pip install clawmetry 的输出】

方法二:一键脚本安装

curl -fsSL https://clawmetry.com/install.sh | bash

脚本会自动检测你的操作系统并完成安装。

方法三:从源码安装

git clone https://github.com/vivekchand/clawmetry.git
cd clawmetry && pip install flask && python3 dashboard.py

五、启动和访问

安装完成后,直接在终端输入:

clawmetry

然后打开浏览器访问:

http://localhost:8900

就能看到仪表盘了,就这么简单。

本地跑通截图

重点:ClawMetry 是零配置的。 它会自动读取 ~/.openclaw/openclaw.json,只显示你已经配置好的 Channel,未配置的会自动隐藏。大多数人不需要做任何额外配置。


六、自定义参数(可选)

如果你需要调整端口或绑定地址,可以使用以下参数:

clawmetry --port 9000           # 自定义端口(默认 8900)
clawmetry --host 127.0.0.1      # 仅绑定到本地
clawmetry --workspace ~/mybot   # 指定 OpenClaw 工作空间路径
clawmetry --name "Alice"        # 在 Flow 可视化中显示你的名字

也可以通过环境变量配置:

环境变量 说明 默认值
CLAWMETRY_PORT 端口号 8900
CLAWMETRY_HOST 绑定地址 0.0.0.0
OPENCLAW_HOME 指定 OpenClaw 工作空间 自动检测

【截图位置:自定义参数启动后的终端输出】


七、总结

整个配置流程回顾一下:

  1. pip install clawmetry
  2. clawmetry
  3. 浏览器打开 http://localhost:8900

三步,完事。

ClawMetry 完全本地运行,没有云服务、没有遥测、没有数据外传,用起来可以放心。

如果你正在用 OpenClaw 构建 AI Agent,强烈建议装一个 ClawMetry,真的能省掉很多"盲猜 Agent 在干什么"的时间。


如果觉得有帮助,欢迎点赞收藏,也可以在评论区交流~

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐