Openclaw Log Report

Agent Session Log Report

Parse agent session logs → structured telemetry → TelemetryAPI.

Supports three agent platforms (auto-detected):

What It Does

Reads a session log file and uploads it as a structured trace:

Trace
└── session:<id>                    ← root span (full session)
    ├── turn:0                      ← user message + agent response
    │   ├── OpenAI-generation       ← LLM call (model, tokens, latency)
    │   ├── skill_install:exec      ← tool call
    │   ├── OpenAI-generation
    │   ├── caw.onboard             ← caw CLI command
    │   └── OpenAI-generation
    ├── turn:1
    │   ├── OpenAI-generation
    │   ├── caw.wallet.balance
    │   └── ...
    └── turn:N

Each span includes:

• Original timestamps — latency reflects actual execution time
• Input/Output — user messages, assistant responses, tool results
• Token usage — per-generation input/output token counts
• caw command classification — 106 commands across 15 categories
• Error detection — failed commands, policy denials, process poll errors

Prerequisites

1. caw installed and onboarded — the script reads API key from ~/.cobo-agentic-wallet/
2. Backend telemetry endpoint available — POST /api/v1/telemetry/session
3. Session file — .jsonl (OpenClaw/Claude Code) or .json (Hermes) from session directories

Usage

Upload a session

# OpenClaw / Claude Code (.jsonl)
python scripts/otel_report.py <session.jsonl>

# Hermes (.json)
python scripts/otel_report.py <session_YYYYMMDD_HHMMSS_xxxx.json>

The script auto-detects API URL and key from caw config. Override with env vars:

AGENT_WALLET_API_URL=https://api-core.agenticwallet.sandbox.cobo.com \
python scripts/otel_report.py session.jsonl

Upload multiple sessions

# Multiple files
python scripts/otel_report.py a.jsonl b.jsonl c.jsonl

# Glob pattern
python scripts/otel_report.py ~/.openclaw/agents/main/sessions/*.jsonl

Upload by time range

Filters by session content time (not file modification time). Both session selection and turn-level filtering apply — only turns within the time range are uploaded.

# Last 2 hours — only uploads turns from the last 2h
python scripts/otel_report.py --since 2h

# Last 1 day
python scripts/otel_report.py --since 1d

# Specific time range (UTC+8)
python scripts/otel_report.py --since 2026-04-05T10:00 --until 2026-04-05T18:00

# A full day
python scripts/otel_report.py --since 2026-04-05 --until 2026-04-06

# Filter a specific file — only turns in range are included
python scripts/otel_report.py --since 8h ~/Downloads/session.jsonl

# Custom sessions directory + time range
python scripts/otel_report.py --since 2h /path/to/sessions/

Supported time formats: 2h (hours ago), 30m (minutes ago), 1d (days ago), 2026-04-05, 2026-04-05T10:00

Dry run (preview without uploading)

python scripts/otel_report.py --dry-run session.jsonl

Shows the span tree structure with timestamps and latencies.

Dump JSON (debug)

python scripts/otel_report.py --dump session.jsonl

Prints the first turn's full JSON payload for inspection.

Watch mode (continuous)

python scripts/otel_report.py --watch [sessions_dir]

Monitors a directory for new session files and auto-uploads.

Upload latest session

python scripts/otel_report.py

Without arguments, uploads the most recent session file from default paths (~/.openclaw/.../sessions/ and ~/.hermes/sessions/).

Environment Variables

Environments:

# Upload to dev environment
AGENT_WALLET_API_URL=https://api-core.agenticwallet.dev.cobo.com \
python scripts/otel_report.py session.jsonl

caw Command Categories

The script classifies 106 caw CLI subcommands into categories:

Trace Dimensions

Constraints

• Don't modify this script — treat it as a read-only tool
• Don't modify uploaded traces
• Don't retry after success — if upload prints Status: OK, do not re-run the command
• Uploading the current session is allowed, but note it's still being written — the upload captures a snapshot at that moment
• Use python3 not python — some servers only have python3
• Session files are read-only; never write to ~/.openclaw/ or ~/.hermes/

Security Notes

安装时 npx skills 可能显示 Socket / Snyk 安全告警，这些是脚本正常功能所需：

脚本不包含任何恶意代码，所有网络请求仅发往配置的 AGENT_WALLET_API_URL。