Product

Troubleshooting

Troubleshooting

Common issues and how to fix them.

Agent Not Responding

Check the Health page (🏥) — it runs diagnostics on all services.

If the gateway is down:

1. Go to the Dashboard and click Restart
2. Or use the Terminal: sudo systemctl restart openclaw-gateway

Can’t Connect to Chat

The web chat (Control Panel) requires HTTPS. If you haven’t set up SSL yet:

1. Go to Settings → SSL Setup
2. Enter your domain name
3. Make sure your DNS points to your VPS IP
4. Click Setup SSL

502 Bad Gateway

This usually means the web UI is restarting. Wait 10 seconds and refresh. If it persists:

• SSH in: sudo systemctl restart easyclaw-webui
• Check logs: sudo journalctl -u easyclaw-webui -n 50

Locked Out of Web UI

1. SSH in with your easyvps password
2. Run: sudo /opt/easyclaw/webui/bin/reset-password.sh
3. Follow the prompts to set a new password

Out of Memory (OOM)

Signs: services crash, VPS becomes unresponsive.

Quick fix: Add more swap space from Settings, or via SSH:

sudo swapoff /swapfile
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

Email Not Working

• Check Channels → Email → verify credentials
• The system log shows ✓ Connection verified or ✗ Connection FAILED at startup
• Check logs: sudo journalctl -u easyclaw-webui | grep email-poller

Telegram Bot Not Responding

1. Verify the bot token in Channels → Telegram
2. Make sure your Telegram user ID is correct
3. Check if the gateway is running (Dashboard)
4. Try messaging the bot again — it may take a moment after a restart

Update Failed

• Click Rollback in Settings to restore the previous version
• Or SSH in: sudo /opt/easyclaw/webui/bin/rollback.sh

SSH Locked Out (Banned by fail2ban)

If you got banned by fail2ban:

• Wait 10 minutes (bans are temporary by default)
• Or ask someone with access to unban you from the Security page
• Or use the easyDNS VPS console to run: sudo fail2ban-client set sshd unbanip YOUR_IP