Skillppx logo

Token Burn Monitor

实时监控 OpenClaw 代理的 Token 使用情况，支持成本分析与任务状态查看。

已扫描
适合谁
OpenClaw 用户、AI 代理运维人员
不适合谁
无 OpenClaw 环境的用户、无需成本监控的普通使用者
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @kasparchen/token-burn-monitor
下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

Token Burn Monitor

无依赖的 Node.js 仪表板。核心 API + 可替换的前端主题。

架构

server.js          → 核心 API（稳定，勿修改）
themes/default/    → 默认深色仪表板主题
themes/<custom>/   → 用户/代理生成的主题
API.md             → 主题开发者使用的 API 协议
config.json        → 端口、主题、代理、定价覆盖配置

快速开始

bash start.sh            # 启动（默认端口 3847）
bash start.sh status     # 检查状态
bash start.sh restart    # 配置更改后重启
bash start.sh stop       # 停止

配置

将 config.default.json 复制为 config.json：

{
  "port": 3847,
  "theme": "default",
  "agents": {
    "main": { "name": "Karl", "icon": "/assets/karl.png" }
  },
  "modelPricing": {}
}
  • theme：themes/ 目录下的子目录名称。默认值："default"
  • agents：显示名称和图标。自动发现；仅在配置中覆盖显示信息。
  • port：也可通过 PORT 环境变量设置。
  • modelPricing：覆盖或添加模型定价（每百万 token 的费用）。

设置 OPENCLAW_AGENTS_DIR 可以覆盖代理目录（默认：/home/node/.openclaw/agents）。

主题

主题位于 themes/<name>/ 目录下。最低要求：一个 index.html 文件，用于从 API 获取数据。

创建自定义主题的步骤：

  1. 阅读 API.md 了解所有可用接口
  2. 创建 themes/my-theme/index.html
  3. 在 config.json 中设置 "theme": "my-theme"
  4. 重启服务

默认主题（themes/default/）是一个完整的参考实现。

API 概览

所有接口返回 JSON。仅支持 GET 请求。服务器绑定到本地回环地址。完整文档见 API.md。

接口描述
GET /api/config代理名称和图标
GET /api/stats?date=所有代理聚合数据
GET /api/agent/:id?date=单个代理及其每次调用的详细分析
GET /api/history?days=30 天的成本历史记录
GET /api/pricing模型定价表
GET /api/crons计划任务（从文件系统读取）
GET /api/cron/:id/runs任务运行历史

安全性

  • 服务器默认绑定到 127.0.0.1（仅限本地访问）
  • 无 shell 执行 — 所有数据均来自文件系统
  • 无出站网络请求 — 默认主题使用系统字体
  • 用户提示默认被遮蔽（显示为 [redacted]），可通过在配置中设置 showPrompts: true 开启显示
  • HTML 响应包含 CSP：connect-src 'self'; font-src 'self'
  • 仅支持 GET — 其他 HTTP 方法一律拒绝

故障排除

  • 无数据：确认 OPENCLAW_AGENTS_DIR 指向正确的代理目录。
  • 端口冲突：使用 PORT=4000 bash start.sh 指定新端口。
  • 主题未加载：检查 themes/<name>/index.html 是否存在。
K
@kasparchen

已收录 1 个 Skill

相关推荐