โ† All skills
Tencent SkillHub ยท Developer Tools

Session Cost

Analyze OpenClaw session logs to report token usage, costs, and performance metrics grouped by model. Use when the user asks about API spending, token usage,...

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

Analyze OpenClaw session logs to report token usage, costs, and performance metrics grouped by model. Use when the user asks about API spending, token usage,...

โฌ‡ 0 downloads โ˜… 0 stars Unverified but indexed

Install for OpenClaw

Quick setup
  1. Download the package from Yavira.
  2. Extract the archive and review SKILL.md first.
  3. Import or place the package into your OpenClaw setup.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Yavira redirect
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
SKILL.md, scripts/session-cost.js

Validation

  • Use the Yavira download entry.
  • Review SKILL.md after the package is downloaded.
  • Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

  1. Download the package from Yavira.
  2. Extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the extracted folder.
New install

I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.

Upgrade existing

I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
1.0.3

Documentation

ClawHub primary doc Primary doc: SKILL.md 11 sections Open source page

Session Cost

Analyze OpenClaw session logs for token usage, costs, and performance metrics grouped by agent and model. By default, scans all agents in ~/.openclaw/agents/. Each agent's sessions are read from ~/.openclaw/agents/<name>/sessions/.

Quick Start

# Summary across all agents node scripts/session-cost.js # Show all session details node scripts/session-cost.js --details # Show details for a specific session (searches across all agents) node scripts/session-cost.js --details abc123

Options

--path <dir> โ€” Directory to scan for .jsonl files (overrides agent auto-discovery) --agent <name> โ€” Filter by agent name (e.g., main, codegen) --offset <time> โ€” Only include sessions from the last N units (30m, 2h, 7d) --provider <name> โ€” Filter by model provider (anthropic, openai, ollama, etc.) --details [session-id] โ€” Show per-session details. Optionally pass a session ID to show just that session (searches across all agents for <id>.jsonl) --table โ€” Show details in compact table format (use with --details) --format <type> โ€” Output format: text (default), json, or discord --json โ€” Shorthand for --format json (backwards compat) --help, -h โ€” Show help message

Examples

# Last 24 hours summary node scripts/session-cost.js --offset 24h # Only the main agent node scripts/session-cost.js --agent main # Last 7 days, JSON output node scripts/session-cost.js --offset 7d --json # Discord-friendly format (for bots/chat) node scripts/session-cost.js --format discord # Discord format with filters node scripts/session-cost.js --format discord --offset 24h --provider anthropic # Filter by provider node scripts/session-cost.js --provider anthropic # All sessions in compact table format node scripts/session-cost.js --details --table # Custom path with details (overrides agent discovery, scans exact directory) node scripts/session-cost.js --path /other/dir --details # Single session detail (found automatically across agents) node scripts/session-cost.js --details 9df7a399-8254-411b-a875-e7337df73d29 # Anthropic sessions from last 24h in table format node scripts/session-cost.js --provider anthropic --offset 24h --details --table

Text Summary (Default)

Results are grouped by agent, then by model within each agent. A grand total section shows per-agent subtotals and a combined total. Found 52 .jsonl files across 2 agents, 52 matched ==================================================================================================== SUMMARY BY AGENT ==================================================================================================== Agent: main anthropic/claude-sonnet-4-5-20250929 -------------------------------------------------------------------------------- Sessions: 30 Tokens: 1,234,567 (input: 900,000, output: 334,567) Cache: read: 500,000 tokens, write: 200,000 tokens Cost: $12.3456 Input: $5.4000 Output: $5.0185 Cache read: $1.5000 (included in total, discounted rate) Cache write: $0.4271 (included in total) anthropic/claude-opus-4-6 -------------------------------------------------------------------------------- Sessions: 5 Tokens: 250,000 (input: 180,000, output: 70,000) ... Agent: codegen anthropic/claude-sonnet-4-5-20250929 -------------------------------------------------------------------------------- Sessions: 17 ... ==================================================================================================== GRAND TOTAL ==================================================================================================== main โ€” 35 sessions, $15.8200 codegen โ€” 17 sessions, $8.5600 All agents (2) -------------------------------------------------------------------------------- Sessions: 52 Tokens: ... Cost: $24.3800 ... When only a single agent is present, the grand total shows "All models (N)" instead.

Text Details (--details)

Shows per-session breakdown (session ID, agent, model, duration, timestamps, tokens, cache, cost) followed by the agent/model summary.

Table Format (--details --table)

Compact table view. When multiple agents are present, an Agent column is included. SESSION DETAILS ============================================================================================================================================ Agent Model Duration Tokens Cache Cost Session โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ main anthropic/claude-sonnet-4.5 45 min 128.5K 15.2K / 8.1K $0.3245 abc123def456 codegen anthropic/claude-sonnet-4.5 12 min 45.3K 2.1K / 1.5K $0.8921 xyz789abc012 With a single agent, the Agent column is omitted and the table matches the previous format.

JSON (--format json)

Results are nested by agent. Each agent contains its model summaries and an agent-level totals object. A top-level grandTotal aggregates across all agents. { "agents": { "main": { "models": { "anthropic/claude-sonnet-4-5-20250929": { "sessions": 30, "tokens": { "input": 900000, "output": 334567, "total": 1234567 }, "cache": { "read": 500000, "write": 200000 }, "cost": { "total": 12.3456, "input": 5.4, "output": 5.0185, "cacheRead": 1.5, "cacheWrite": 0.4271 } } }, "totals": { "sessions": 35, "tokens": { "input": 1080000, "output": 404567, "total": 1484567 }, "cache": { "read": 600000, "write": 250000 }, "cost": { "total": 15.82, ... } } }, "codegen": { "models": { ... }, "totals": { ... } } }, "grandTotal": { "sessions": 52, "tokens": { "input": 1500000, "output": 600000, "total": 2100000 }, "cache": { "read": 800000, "write": 350000 }, "cost": { "total": 24.38, ... } } }

Discord (--format discord)

Optimized for chat platforms (Discord, Slack, etc.) - concise, markdown-friendly, no tables: ๐Ÿ’ฐ **Usage Summary** (last 24h) **Total Cost:** $24.38 **Total Tokens:** 2.1M **Sessions:** 52 **By Agent:** โ€ข main: $15.82 (35 sessions) โ€ข codegen: $8.56 (17 sessions) **By Provider:** โ€ข anthropic: $22.50 (1.9M tokens) โ€ข openai: $1.88 (200K tokens) **Top Models:** โ€ข anthropic/claude-sonnet-4.5: $18.20 (1.5M tokens) โ€ข anthropic/claude-opus-4: $4.30 (400K tokens) โ€ข openai/gpt-4o: $1.88 (200K tokens) The "By Agent" section is shown only when multiple agents are present.

Output Fields

Agent โ€” Agent name (derived from directory under ~/.openclaw/agents/) Sessions โ€” Number of session files analyzed Tokens โ€” Total, input, and output token counts Cache โ€” Cache read and write token counts Cost โ€” Total cost broken down by input, output, cache read, and cache write Duration โ€” Session duration in minutes (details mode) Timestamps โ€” First and last activity timestamps (details mode)

Notes

When --path is provided, it overrides agent auto-discovery and scans exactly that directory. The agent name is inferred from the path (e.g., .../agents/main/sessions โ†’ "main"). --agent and --provider filters can be combined (e.g., --agent main --provider anthropic). Single session lookup (--details <id>) searches across all discovered agents to find the session file.

Category context

Code helpers, APIs, CLIs, browser automation, testing, and developer operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
1 Docs1 Scripts
  • SKILL.md Primary doc
  • scripts/session-cost.js Scripts