← Back to Skills Marketplace
qingyu24

Token Monitor

by qingyu24 · GitHub ↗ · v1.0.0 · MIT-0
darwinlinux ✓ Security Clean
126
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install qy-token-monitor
Description
分析 OpenClaw 会话 JSONL 文件,监控各 skill/功能的 token 消耗(输入/输出/缓存命中)和成功率。当需要分析会话 token 使用、跟踪性能或生成使用报告时使用。关键词触发:token、会话分析、skill 性能、使用报告。
Usage Guidance
This skill appears to do what it says: analyze local OpenClaw/Claude session JSONL files for token usage and produce reports. Before installing or running it, review these points: 1) The tool reads files under ~/.claude/projects and ~/.claude/skills — those session files can contain sensitive conversation content, so run it only if you trust the environment and code. 2) Inspect scripts/analyze_session.py locally (it is included) to verify there are no unexpected network calls or writes; the provided script shows only local file I/O and no networking. 3) When running, prefer an explicit output path (use --output) and run in a controlled directory/sandbox if you have privacy concerns. 4) SKILL.md references a metrics document that is not present (references/metrics-calculation.md) and uses a {baseDir} placeholder — ensure you run the correct script path. If you need higher assurance, run the script in an isolated environment or review/execute it line-by-line before giving it access to your real session files.
Capability Analysis
Type: OpenClaw Skill Name: qy-token-monitor Version: 1.0.0 The qy-token-monitor skill is a diagnostic utility designed to analyze OpenClaw session logs (~/.claude/projects/*.jsonl) to track token consumption, success rates, and latency. The Python script (scripts/analyze_session.py) parses local session data to generate usage reports in JSON, Markdown, or HTML formats. While it accesses sensitive conversation history, this is necessary for its stated purpose, and there is no evidence of data exfiltration, unauthorized network activity, or malicious instructions in the SKILL.md file.
Capability Assessment
Purpose & Capability
Name/description (token/session analysis) align with the included script and instructions. The skill only requires python3 and operates on session files under ~/.claude/projects and the local ~/.claude/skills directory to map skill names — which is expected for this purpose.
Instruction Scope
SKILL.md instructs the agent to run the local script against files in the user's home (~/.claude/projects) and to read ~/.claude/skills; this is coherent with session analysis but means the tool will read potentially sensitive local session data. The SKILL.md references a metrics-calculation doc that is not present in the manifest (minor inconsistency). The instructions use a {baseDir} placeholder (ambiguous) — user should ensure the correct path when running.
Install Mechanism
No install spec — instruction-only with an included Python script. No external downloads, no archive extraction, and no package installs are requested in the manifest.
Credentials
The skill declares no required environment variables, no credentials, and no config paths beyond reading files under the user's home. The script reads local files (session JSONL and ~/.claude/skills) which is proportional to its stated goal; it does not access unrelated secrets or cloud credentials.
Persistence & Privilege
always is false and the skill does not request persistent platform privileges. The script appears to only read files and write reports (to stdout or chosen output path) and does not modify other skills or system-wide configuration.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install qy-token-monitor
  3. After installation, invoke the skill by name or use /qy-token-monitor
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
qy-token-monitor 1.0.0 - 首发版本,支持分析 OpenClaw 会话 JSONL 文件,统计并可视化各 skill 的 token 消耗和成功率 - 支持多种报告格式:JSON、Markdown、HTML(含交互仪表板和详情表格) - 提供 skill 级别的 token 分析、成功率与性能指标 - 支持按 skill 名称筛选、项目或单独会话分析
Metadata
Slug qy-token-monitor
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Token Monitor?

分析 OpenClaw 会话 JSONL 文件,监控各 skill/功能的 token 消耗(输入/输出/缓存命中)和成功率。当需要分析会话 token 使用、跟踪性能或生成使用报告时使用。关键词触发:token、会话分析、skill 性能、使用报告。 It is an AI Agent Skill for Claude Code / OpenClaw, with 126 downloads so far.

How do I install Token Monitor?

Run "/install qy-token-monitor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Token Monitor free?

Yes, Token Monitor is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Token Monitor support?

Token Monitor is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).

Who created Token Monitor?

It is built and maintained by qingyu24 (@qingyu24); the current version is v1.0.0.

💬 Comments