How to Fix OpenClaw Not Responding

ps aux | grep openclaw
# Look for the node/python process
# Note the PID if it exists

systemctl status openclaw  # If using systemd
# Or check your process manager (pm2, supervisor, etc.)

lsof -i :3000  # Replace 3000 with your OpenClaw port
# Or use netstat
netstat -tuln | grep 3000

# If another process is using the port:
sudo kill -9 <PID>  # Force kill the conflicting process

tail -n 100 ~/.openclaw/logs/openclaw.log
# Or if using systemd:
journalctl -u openclaw -n 100 --no-pager

# Look for:
# - Uncaught exceptions
# - EADDRINUSE (port conflict)
# - Database errors
# - Memory allocation failures

# Find and kill all OpenClaw processes
pkill -9 -f openclaw

# Remove any stale lock files
rm -f ~/.openclaw/*.lock
rm -f ~/.openclaw/db/*.lock

# Start OpenClaw fresh
systemctl restart openclaw  # Or your start command
# Verify it started:
curl http://localhost:3000/health

top -p $(pgrep -f openclaw)
# Or use htop for better visualization
htop -p $(pgrep -f openclaw)

# Check disk space:
df -h

# Check for OOM kills in system logs:
dmesg | grep -i "killed process"
journalctl -k | grep -i "out of memory"

# For JSON config:
jq . ~/.openclaw/config.json
# If this fails, you have invalid JSON

# For YAML config:
yamllint ~/.openclaw/config.yml

# Check for common issues:
# - Trailing commas in JSON
# - Incorrect indentation in YAML
# - Missing required fields
# - Invalid environment variable references