OpenClaw Doctor — System Diagnostics
The openclaw doctor command runs a comprehensive diagnostic check on your OpenClaw installation—verifying dependencies, configuration, connectivity, and system health.
Running Diagnostics
openclaw doctorWhat It Checks
| Check | Description |
|---|---|
| Node.js version | Verifies Node.js 22+ is installed |
| OpenClaw version | Checks if you are running the latest version |
| Configuration | Validates your config file syntax and required fields |
| API connectivity | Tests connections to configured LLM providers |
| Channel status | Verifies each messaging channel is connected and responsive |
| Disk space | Checks available storage for logs and workspace |
| Permissions | Validates file system permissions on key directories |
Interpreting Results
- ✅ PASS: Component is working correctly
- ⚠️ WARN: Component works but may have issues (e.g., low disk space)
- ❌ FAIL: Component has a problem that needs to be fixed
Auto-Fix Mode
# Attempt to automatically fix common issues
openclaw doctor --fixAuto-fix can resolve issues like outdated dependencies, missing directories, and invalid configuration defaults.
OpenClaw Setup
Ready to launch? Get your personal AI agent running in minutes.