OpenClaw Field Guide · 22 of 24

21 · Troubleshooting by symptom

Updated 24 September 2026 · Community edition

Record the exact symptom, installed version, and last change. Start with observation, then change one thing at a time.

openclaw status
openclaw gateway status
openclaw doctor
openclaw logs --limit 50

The dashboard will not connect

Check the Gateway, the address, and the intended authentication method. For a remote host, follow its remote-access route. Do not disable authentication to remove a connection error.

The dashboard opens but chat fails

Inspect openclaw models status and the affected provider error. Check auth, quota, selected model, and runtime availability. Test a small request after a targeted fix.

The bot does not answer

Run openclaw channels status --probe. If connected, inspect pairing, sender/group policy, and mention requirements. Do not switch to public access as a diagnostic shortcut.

A skill is installed but unavailable

Run openclaw skills check and inspect dependencies and tool policy. The installed inventory does not guarantee all capabilities are enabled.

A scheduled task did not arrive

Inspect the job and run history using the cron reference. Confirm time zone, enabled state, outcome, destination, and actual delivery. Do not create duplicates before checking the existing job.

An update or config change broke something

Review validation and update status. Preserve diagnostics and backups, then follow chapter 19. Avoid repeated restarts, broad resets, or credential rotation unrelated to the error.

When seeking support, share the version, redacted error, expected behavior, and steps already attempted. Do not share raw secrets or private conversation histories.