# Troubleshooting

> Common issues and how to fix them — lockouts, OOM, chat problems, and more.


# 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:
```bash
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`

---
_Canonical: https://easynode.ai/docs/troubleshooting/index.md_