Troubleshooting

title: Troubleshooting description: Quick troubleshooting guide for common OpenClaw failures. sidebar: label: Troubleshooting order: 99

Having trouble? Here’s how to diagnose and fix common issues.

Check Status
Terminal window
```
openclaw status
```
Gives a high-level overview of the gateway, channels, and sessions.
View Logs
Terminal window
```
openclaw logs --follow
```
Watch real-time logs to see what’s happening when you interact with the bot.
Deep Health Check
Terminal window
```
openclaw doctor
```
Scans for configuration errors and missing dependencies.

Error: No API key found for provider "anthropic"

The agent is missing credentials.

Fix: Run openclaw models auth setup-token --provider anthropic on the gateway host.
Verify: Run openclaw models status.

Error: OAuth token refresh failed

Error: Control UI fails on HTTP

Browsers block cryptographic features on insecure HTTP.

Fix: Use http://127.0.0.1:18789 (localhost) or set up HTTPS (Tailscale).
Workaround: Enable gateway.controlUi.allowInsecureAuth: true (Not recommended).

Symptom: Service installed but not running.

Check: openclaw gateway status
Fix: Check logs (/tmp/openclaw/openclaw-gateway.log on macOS) for crash reasons.

Command	Usage
`openclaw status`	General overview.
`openclaw status --all`	Full report (redacted) for sharing.
`openclaw gateway probe`	Test network reachability.
`openclaw channels status --probe`	Check if channels (WhatsApp/Telegram) are connected.