Gateway Troubleshooting

Common gateway issues and solutions.

Diagnostic Commands

# Check status
openclaw status

# Run diagnostics
openclaw doctor

# View logs
openclaw logs --level error

Common Issues

Gateway Won't Start

Port in use:

# Check what's using the port
lsof -i :3000

# Use a different port
openclaw gateway start --port 8080

Permission denied:

# Check file permissions
ls -la ~/.config/openclaw/

# Fix permissions
chmod 755 ~/.config/openclaw/

Connection Refused

Gateway not running:

# Start gateway
openclaw gateway start

# Check status
openclaw gateway status

Wrong address:

Ensure you're connecting to the correct host/port.

High Memory Usage

# Check session count
openclaw sessions list --count

# Clear old sessions
openclaw sessions clear --older-than 7d

# Compact memory
openclaw memory compact

Slow Responses

• Check model latency
• Reduce context window size
• Enable compaction
• Use a faster model for routing

Getting Help

1. Check logs: openclaw logs --level debug
2. Run diagnostics: openclaw doctor --verbose
3. Search GitHub Issues
4. Ask on Discord

See Also

• Help: Troubleshooting
• CLI: doctor