clawprobe

Real-time observability for OpenClaw agents. Check health, token usage, API cost, context window, and optimization suggestions — all from the CLI.

Install

npm install -g clawprobe
clawprobe start

Core commands

Recommended self-check workflow

Run at session start or before any expensive task:

STATUS=$(clawprobe status --json)
UTIL=$(echo $STATUS | node -e "process.stdin.resume();let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>console.log(JSON.parse(d).utilizationPct))")
echo "Context: $UTIL%"

Or in a single call:

clawprobe status --json

Key fields to act on:

• utilizationPct ≥ 85 → compact soon or start a fresh session
• suggestions[].ruleId === "tools-truncation" → TOOLS.md is being cut off
• suggestions[].ruleId === "cost-spike" → today's spend is unusually high
• daemonRunning: false → run clawprobe start to enable monitoring

Handling suggestions programmatically

# List active suggestions
clawprobe suggest --json

# Dismiss a noisy rule
clawprobe suggest --dismiss memory-bloat --json
# → { "ok": true, "dismissed": "memory-bloat" }

Schema introspection

When you need to know exact field names for any command:

clawprobe schema status    # full field spec for status --json
clawprobe schema cost      # full field spec for cost --json
clawprobe schema           # list all available schemas

Error format

All errors under --json are structured — never colored text:

{ "ok": false, "error": "no_active_session", "message": "No active session found" }

Exit code is always 1 on error.

Cost note

Cost figures are estimates based on public model pricing. Verify exact amounts with your model provider's billing dashboard.