Diagnostics & Common Fixes in OpenClaw

From the OpenClaw cheat sheet · Troubleshooting · verified Jul 2026

Diagnostics & Common Fixes

Run diagnostics, check logs, and resolve known issues.

bash
# Run diagnostics
openclaw doctor

# Check gateway logs
journalctl --user -u openclaw-gateway -n 50 --no-pager

# Full reset (keeps CLI installed)
openclaw gateway stop
openclaw uninstall
rm -rf ~/.openclaw
💡 A "DNS lookup failed" message is often misleading; always check the full log for the real error
⚡ "openclaw doctor --fix" attempts automatic repairs for common config and service problems
📌 Use "openclaw models status --probe" to confirm a provider API key and connectivity
🟢 "openclaw doctor" checks connectivity, config, and service status in one command
troubleshootingdebuglogs

Continue with OpenClaw

Save the full cheat sheet or work through every related task.

Back to the full OpenClaw cheat sheet