openclaw-blackbox

OpenClaw Blackbox CLI — inspect failed, stalled, expensive, or weird OpenClaw agent runs from local disk evidence; list sessions and failures; find the session behind a request; and generate terminal, Markdown, JSON, or HTML reports. Use when debugging OpenClaw cron runs, session failures, context overflows, missing transcripts/trajectories, message delivery issues, or when an agent needs deterministic run inspection without hidden LLM calls.

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "openclaw-blackbox" with this command: npx skills add shan8851/openclaw-blackbox

OpenClaw Blackbox

Use blackbox to inspect local OpenClaw run evidence and produce deterministic debugging reports.

Setup

  • npm install -g @shan8851/blackbox
  • Requires local OpenClaw state; by default it reads ~/.openclaw
  • To inspect another OpenClaw home: OPENCLAW_HOME=/path/to/.openclaw blackbox doctor

Health Check

  • Check visible OpenClaw evidence: blackbox doctor
  • JSON health check: blackbox doctor --json

List Evidence

  • Recent failed or suspicious cron runs: blackbox list failures --limit 10
  • Filter by label: blackbox list failures --label context_overflow
  • Emit runnable inspect commands: blackbox list failures --commands
  • Local sessions across agents: blackbox list sessions --agent all --limit 20
  • Sessions with specific evidence: blackbox list sessions --evidence checkpoint_present

Inspect Runs

  • Latest failed run for a cron job: blackbox inspect --cron-job "Example nightly job" --latest-error
  • Known session: blackbox inspect --session-id <session-id>
  • Full Markdown report: blackbox inspect --session-id <session-id> --view full --out reports/run.md
  • JSON report: blackbox inspect --session-id <session-id> --json-out reports/run.json
  • HTML report: blackbox inspect --session-id <session-id> --html-out reports/run.html --open

Find Requests

  • Find the session behind a user request: blackbox find request --query "summarise the failed run" --agent all
  • Find by message id: blackbox find request --message-id <message-id> --agent main
  • Emit inspect commands only: blackbox find request --query "failed to send" --commands

Output

  • inspect always prints a terminal snapshot
  • Markdown defaults to reports/<run>.md unless --out is set
  • Set BLACKBOX_REPORT_DIR to change the default report directory
  • Discovery commands support --json for machine-readable output
  • --view simple is the default triage report; --view full includes fuller evidence and timeline details

Agent Notes

  • Prefer Blackbox before guessing why an OpenClaw run failed if local evidence exists
  • find request / inspect --query are conservative; if a query maps to multiple sessions, inspect by explicit --session-id
  • Reports can include prompts, tool arguments/results, URLs, and local paths; review before sharing externally
  • Blackbox is disk-first and should not make hidden LLM calls by default
  • Failure labels include context_overflow, message_delivery_failed, timeout, session_lock_timeout, gateway_restart_interrupted, model/auth labels, tool failure labels, and unknown_error
  • Evidence labels include missing_transcript, transcript_deleted, transcript_reset, missing_trajectory, checkpoint_present, and session_write_in_progress

Notes

  • Exit codes: 0 success, 1 unexpected failure, 2 usage/invalid argument, 3 not found/missing OpenClaw state, 4 ambiguous request match
  • Package name: @shan8851/blackbox; binary name: blackbox; skill/ClawHub slug: openclaw-blackbox

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open Registry RecordOpen in ClawHub

Related Skills

Related by shared tags or category signals.

Coding

Hermes Memory Sync

Extract daily conversation summaries from Hermes Agent session logs and persist them as readable memory files. Covers the Python extraction script, cron setu...

Registry SourceRecently Updated
00realpda
Coding

China Export Data

Access and retrieve China's official export statistics from authoritative sources. Provides step-by-step guidance for querying trade data by HS code, destina...

Registry SourceRecently Updated
3200findhappy7
Coding

Usable Stability Loop · The 99/80 Loop

Help agents ship usable, stable solutions faster for non-technical but goal-clear users, then improve them through real-world usage instead of over-engineeri...

Registry SourceRecently Updated
00cutexsoda
Coding

Office Document Extractor

Convert Microsoft Office documents (DOCX, XLSX, PPTX) to Markdown without any external dependencies. Use when the user needs to extract text from Word docume...

Registry SourceRecently Updated
00michealxie001