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