Session Cost

Analyze OpenClaw session logs for token usage, costs, and performance metrics grouped by model.

Note: Currently limited to the main agent (default path: ~/.openclaw/agents/main/sessions/). If other agents are added in the future, this could be modified to accept an --agent parameter to specify which agent's sessions to analyze.

Quick Start

# Summary of all sessions (default path: ~/.openclaw/agents/main/sessions/)
node scripts/session-cost.js

# Show all session details
node scripts/session-cost.js --details

# Show details for a specific session
node scripts/session-cost.js --details abc123

Options

• --path <dir> — Directory to scan for .jsonl files (default: ~/.openclaw/agents/main/sessions/)
• --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 (looks 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

# 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
node scripts/session-cost.js --path /other/dir --details

# Single session detail
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

Output Format

Text Summary (Default)

Found 42 .jsonl files, 42 matched

====================================================================================================
SUMMARY BY MODEL
====================================================================================================

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)

Text Details (--details)

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

Table Format (--details --table)

Compact table view with columns: Session, Model, Duration, Tokens, Cache (read/write), Cost.

SESSION DETAILS
=============================================================================================================================
Model                           Duration  Tokens        Cache          Cost        Session
─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
anthropic/claude-sonnet-4.5     45 min    128.5K        15.2K / 8.1K   $0.3245     abc123def456
anthropic/claude-opus-4         12 min    45.3K         2.1K / 1.5K    $0.8921     xyz789abc012

JSON (--format json)

{
  "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 }
    }
  },
  "grandTotal": { ... }
}

Discord (--format discord)

Optimized for chat platforms (Discord, Slack, etc.) - concise, markdown-friendly, no tables:

💰 **Usage Summary**
(last 24h)

**Total Cost:** $12.34
**Total Tokens:** 1.2M
**Sessions:** 42

**By Provider:**
• anthropic: $10.50 (950K tokens)
• openai: $1.84 (250K tokens)

**Top Models:**
• anthropic/claude-sonnet-4.5: $8.20 (800K tokens)
• openai/gpt-4o: $1.84 (250K tokens)
• anthropic/claude-opus-4: $2.30 (150K tokens)

Output Fields

• 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)