openclaw-debugging

Diagnose OpenClaw model, provider, tool-surface, and streaming failures using targeted debug logs and proof paths.

Updated Jun 19, 2026
One-click install
npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill openclaw-debugging-amirulandalib
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openclaw-debugging
Source: https://github.com/AmirulAndalib/Vilvona-AI/tree/main/.agents/skills/openclaw-debugging
Command: npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill openclaw-debugging-amirulandalib

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When OpenClaw behaves differently across local tests, live models, providers, code mode, Tool Search, Crabbox, or CI, it is hard to know which boundary is failing. This Skill replaces guessing with a structured debugging loop that picks the right logs, probes, and proof path before any code is changed. ## Core Features & Use Cases - Boundary-first debugging loop: Identify whether the fault lies in config, tool construction, provider payload, fetch, SSE streaming, transcript replay, worker/runtime, packaging, or CI before patching. - Targeted transport logging: Use environment flags like OPENCLAW_DEBUG_MODEL_TRANSPORT, OPENCLAW_DEBUG_MODEL_PAYLOAD, OPENCLAW_DEBUG_SSE, and OPENCLAW_DEBUG_CODE_MODE to capture request shapes, tool names, and stream timing without global debug noise. - Proof selection guidance: Match each fix to the narrowest verification, from targeted Vitest runs and pnpm build for worker/dist changes to Crabbox for Docker, package, Linux, and CI-parity proof. - Use Case: A model call hangs with no output. Enable SSE event logging, confirm the fetch response arrived but the first SSE event never did, and isolate the issue to the provider stream rather than tool execution. ## Quick Start Ask the assistant to use the openclaw-debugging skill to identify the failing boundary and enable the right debug flags for the OpenClaw issue you are seeing.

Frequently Asked Questions about openclaw-debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug OpenClaw model streaming issues?

Enable OPENCLAW_DEBUG_SSE=events to log first-event and stream-completion timing, and OPENCLAW_DEBUG_MODEL_TRANSPORT=1 for fetch response and transport errors. If the fetch response arrives but the first SSE event does not, the issue is in the provider stream, not tool execution.

How do I see which tools the model actually receives in OpenClaw?

Set OPENCLAW_DEBUG_MODEL_PAYLOAD=tools to log all model-facing tool names before the SDK call. Config can enable tools while the run disables them, so always inspect the actual visible tool surface rather than the registry or config alone.

What is the difference between fetch response and first SSE event when debugging?

The fetch response proves HTTP headers arrived from the provider, while the first SSE event proves the response body is streaming. A gap between them indicates a stream, body, or provider issue rather than a tool execution problem.

When should I use Crabbox instead of local tests for OpenClaw debugging?

Use Crabbox for broad, Docker, package, Linux, live-key, or CI-parity proof. Local targeted Vitest is enough for single helper or payload bugs, while worker, dist, or lazy-import changes need targeted tests plus pnpm build.

Why does OpenClaw code mode not show exec and wait tools?

Code mode exposes exactly the exec and wait tools only after it actually activates in the run. Enable OPENCLAW_DEBUG_CODE_MODE=1 for tool-surface diagnostics and compare configured state against actual run activation before assuming a payload bug.