openclaw-log-report

Agent Session Log Report

Parse agent session logs → structured telemetry → TelemetryAPI.

Supports three agent platforms (auto-detected):

Platform	Format	Default Path
OpenClaw	JSONL	~/.openclaw/agents/main/sessions/*.jsonl
Claude Code	JSONL	~/.claude/projects/*/*.jsonl
Hermes	JSON	~/.hermes/sessions/session_*.json

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

Variable	Default	Description
AGENT_WALLET_API_URL	https://api-core.agenticwallet.sandbox.cobo.com	Backend API URL
USER_ID	auto-detected from session messages	User identifier for telemetry

Environments:

Environment	URL
Sandbox	https://api-core.agenticwallet.sandbox.cobo.com (default)
Dev	https://api-core.agenticwallet.dev.cobo.com

# 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:

Category	Examples
onboarding	onboard, onboard bootstrap, onboard self-test
transaction	tx transfer, tx call, tx sign-message, tx speedup
query	wallet balance, tx list, tx records, address list, status
auth	pending approve/reject, pact submit/status, policy create
wallet	wallet use/rename/archive/claim, address create
agent	agent status, agent api-key
ap2	ap2 purchase/cancel/search, ap2 shipping
node	node start/stop/status/health
meta	meta chains/tokens/prices, version, health, schema
util	util abi encode/decode, util base64, fetch
dev	faucet deposit/tokens, demo
audit	audit logs
monitor	track

Trace Dimensions

Dimension	Value	Source
Trace Name	script_{user}@{hostname}_{MMDDHHmm}	User + hostname + timestamp (UTC+8)
Session ID	Session UUID or Hermes session ID	Session file
User ID	Telegram sender_id or "unknown"	First user message
Tags	[skill_name, "openclaw", provider, "upload:YYYYMMDD"]	Session metadata + upload date

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 安全告警，这些是脚本正常功能所需：

告警	原因
网络请求	脚本通过 urllib.request POST 数据到 TelemetryAPI
文件读取	读取 ~/.openclaw/、~/.hermes/、~/.claude/ 下的会话日志文件
凭证访问	从 ~/.cobo-agentic-wallet/ 读取 caw API key 用于鉴权
主机信息	通过 socket.gethostname() 获取机器名写入 metadata

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