by 运行时依赖
安装命令
点击复制技能文档
OpenClaw Blackbox 使用 blackbox 检查本地 OpenClaw 运行证据并生成确定性调试报告。
安装 npm install -g @shan8851/blackbox
需要本地 OpenClaw 状态；默认读取 ~/.openclaw 如需检查其他 OpenClaw 目录： OPENCLAW_HOME=/path/to/.openclaw blackbox doctor
健康检查 查看可见 OpenClaw 证据： blackbox doctor
JSON 健康检查： blackbox doctor --json
列出证据 最近失败或可疑的 cron 运行： blackbox list failures --limit 10
按标签过滤： blackbox list failures --label context_overflow
输出可执行的 inspect 命令： blackbox list failures --commands
跨 agent 的本地会话： blackbox list sessions --agent all --limit 20
含特定证据的会话： blackbox list sessions --evidence checkpoint_present
检查运行 某 cron 最近失败运行： blackbox inspect --cron-job "Example nightly job" --latest-error
已知会话： blackbox inspect --session-id
完整 Markdown 报告： blackbox inspect --session-id --view full --out reports/run.md
JSON 报告： blackbox inspect --session-id --json-out reports/run.json
HTML 报告并打开： blackbox inspect --session-id --html-out reports/run.html --open
查找请求 根据用户请求找会话： blackbox find request --query "summarise the failed run" --agent all
按 message-id 查找： blackbox find request --message-id --agent main
仅输出 inspect 命令： blackbox find request --query "failed to send" --commands
输出 inspect 始终打印终端快照 Markdown 默认输出到 reports/.md，除非指定 --out 设置 BLACKBOX_REPORT_DIR 可更改默认报告目录 发现类命令支持 --json 输出机器可读结果 --view simple 为默认分类报告；--view full 包含更完整证据与时间线
Agent 提示 若本地证据存在，优先使用 Blackbox 而非猜测失败原因 find request / inspect --query 保守；若查询匹配多个会话，请用 --session-id 显式指定 报告可能包含 prompts、tool 参数/结果、URL 及本地路径；外发前请审查 Blackbox 优先读盘，默认不会发起隐藏 LLM 调用
失败标签 context_overflow、message_delivery_failed、timeout、session_lock_timeout、gateway_restart_interrupted、model/auth 标签、tool 失败标签、unknown_error
证据标签 missing_transcript、transcript_deleted、transcript_reset、missing_trajectory、checkpoint_present、session_write_in_progress
备注 退出码：0 成功，1 意外失败，2 用法/参数错误，3 未找到/缺失 OpenClaw 状态，4 请求匹配歧义
包名：@shan8851/blackbox；二进制名：blackbox；skill/ClawHub slug：openclaw-blackbox