token-burn-monitor代币燃烧监控

Real-time token consumption monitoring dashboard for OpenClaw agents. Tracks per-agent token usage, cost breakdown by model, cache hit rates, cron job status, and 30-day historical trends. Use when setting up cost monitoring, checking daily token burn, or reviewing cron job health. User prompts are redacted by default.

作者: admin | 来源: ClawHub

Token Burn Monitor

Zero-dependency Node.js dashboard. Core API + swappable frontend themes.

Architecture

CODEBLOCK0

Quick Start

CODEBLOCK1

Configuration

Copy config.default.json to config.json:

CODEBLOCK2

- theme: Directory name under themes/. Default: INLINECODE3
agents: Display names/icons. Auto-discovered; config only overrides display.
port: Also settable via PORT env var.
modelPricing: Override/add model pricing ($/1M tokens).

Set OPENCLAW_AGENTS_DIR to override agent directory (default: /home/node/.openclaw/agents).

Themes

Themes live in themes/<name>/. Minimum: one index.html that fetches data from the API.

To create a custom theme:

1. Read API.md for all available endpoints
Create INLINECODE10
Set "theme": "my-theme" in config.json
Restart

The default theme (themes/default/) is a full reference implementation.

API Overview

All endpoints return JSON. GET-only. Server binds to localhost. Full docs in API.md.

Endpoint	Description
INLINECODE14	Agent names and icons
INLINECODE15

Security

- Server binds to 127.0.0.1 by default (localhost only)
No shell execution — all data read from filesystem
No outbound network requests — default theme uses system fonts
User prompts redacted by default ([redacted]), opt-in via showPrompts: true in config
HTML responses include CSP: INLINECODE24
GET-only — all other HTTP methods rejected

Troubleshooting

- No data: Verify OPENCLAW_AGENTS_DIR points to correct agents directory.
Port conflict: INLINECODE26
Theme not loading: Check themes/<name>/index.html exists.

Token Burn Monitor

零依赖的Node.js仪表盘。核心API + 可切换的前端主题。

架构

server.js → 核心API（稳定，请勿修改）
themes/default/ → 默认深色仪表盘主题
themes// → 用户/代理生成的主题
API.md → 面向主题开发者的API契约
config.json → 端口、主题、代理、定价覆盖配置

快速开始

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

配置

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

json
{
port: 3847,
theme: default,
agents: {
main: { name: Karl, icon: /assets/karl.png }
},
modelPricing: {}
}

- theme: themes/目录下的子目录名称。默认值：default
agents: 显示名称/图标。自动发现；配置仅覆盖显示内容。
port: 也可通过PORT环境变量设置。
modelPricing: 覆盖/添加模型定价（$/百万Token）。

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

主题

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

创建自定义主题：

1. 阅读API.md了解所有可用端点
创建themes/my-theme/index.html
在config.json中设置theme: my-theme
重启

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

API概览

所有端点返回JSON格式。仅支持GET请求。服务器绑定到localhost。完整文档见API.md。

端点	描述
GET /api/config	代理名称和图标
GET /api/stats?date=

安全

- 服务器默认绑定到127.0.0.1（仅限本地访问）
不执行shell命令——所有数据从文件系统读取
无出站网络请求——默认主题使用系统字体
用户提示默认被编辑（[redacted]），可通过配置中的showPrompts: true选择显示
HTML响应包含CSP：connect-src self; font-src self
仅支持GET——拒绝所有其他HTTP方法

故障排除

- 无数据：验证OPENCLAWAGENTSDIR指向正确的代理目录。
端口冲突：PORT=4000 bash start.sh
主题未加载：检查themes//index.html是否存在。

token-burn-monitor代币燃烧监控