Cannot send messages | Check bot has permission in the channel |
Diagnostic Commands
# Full system diagnostic
openclaw doctor
# ✅ Node.js: v20.10.0 (required: v18+)
# ✅ Git: 2.43.0 (required: 2.30+)
# ✅ OpenClaw: v2.5.0
# ✅ Config: Valid
# ✅ Memory DB: OK (142 entries)
# ⚠️ Disk space: 2.1 GB free (recommend 5+ GB)
# ✅ Network: Connected
# ✅ Model (ollama): Responding (latency: 340ms)
# Check specific components
openclaw diagnostics network
openclaw diagnostics model
openclaw diagnostics memory
openclaw diagnostics platforms
# View error logs
openclaw logs --level error --since 24h
# View logs for specific component
openclaw logs --component gateway --tail 50
openclaw logs --component skill:email-sender --level error
Error Log Analysis
# Export logs for analysis
openclaw logs --since 7d --format json > error-report.json
# Count errors by type
openclaw logs --level error --since 24h --stats
# Error Summary (last 24h):
# API timeout: 12 occurrences
# Rate limit: 3 occurrences
# Skill error: 1 occurrence
# Total: 16 errors
Recovery Procedures
Corrupted Configuration
# Reset config to defaults
openclaw config reset
openclaw init
# Or restore from backup
openclaw backup restore --latest --only config
Corrupted Memory Database
# Try repair first
openclaw memory repair
# If repair fails, restore from backup
openclaw backup restore --latest --only memory
# Last resort: clear and start fresh
openclaw memory clear --force
Complete Reset
# Nuclear option: full reset
openclaw reset --confirm
# ⚠️ This deletes ALL data: config, memory, skills, sessions
# Start fresh:
openclaw init
Getting Help
# Built-in help
openclaw help
openclaw <command> --help
# Generate bug report (no sensitive data)
openclaw report-bug
# → Collects: version, OS, config (sanitized), recent errors
# → Opens GitHub issue template
# Community help
openclaw community --discord # Join Discord for live help
Error Prevention
| Practice | Prevents |
Run openclaw doctor weekly | Catches issues early |
| Keep OpenClaw updated | Bug fixes and stability |
Use openclaw backup create before changes | Easy rollback |
Monitor logs with --follow | Catch errors in real-time |