Porta em Uso (EADDRINUSE) — Solução
Como resolver erro EADDRINUSE quando a porta já está sendo usada. Liberar porta ocupada.
⏱️ 2 min de leitura
Porta em Uso (EADDRINUSE)
Ao iniciar o gateway, você recebe erro indicando que a porta já está em uso:
Error: listen EADDRINUSE: address already in use :::3000
Error: Port 3000 is already in use
bind: Address already in use
- Instância anterior rodando - Gateway não foi parado corretamente
- Outro serviço na porta - Nginx, Apache, outro app
- Processo zumbi - Processo travado ocupando a porta
- Container Docker - Container antigo ainda rodando
# Ver qual processo está na porta 3000
lsof -i :3000
# Alternativa com netstat
netstat -tulpn | grep 3000
# Alternativa com ss
ss -tulpn | grep 3000
# Matar por PID (substitua pelo número real)
kill -9 <PID>
# Matar processos do openclaw
pkill -f openclaw
# Matar processo na porta específica
fuser -k 3000/tcp
# Iniciar em porta diferente
openclaw gateway start --port 3001
# Ou configurar no arquivo
# ~/.openclaw/config.yaml
gateway:
port: 3001
# Listar containers
docker ps -a | grep openclaw
# Parar container
docker stop <container_id>
# Remover container parado
docker rm <container_id>
# Parar Nginx
sudo systemctl stop nginx
# Parar Apache
sudo systemctl stop apache2
# Verificar o que está rodando
sudo systemctl list-units --type=service --state=running
# Encontrar processos zumbis
ps aux | grep -w Z
# Ver processos do node
ps aux | grep node
# Matar todos os processos node (cuidado!)
killall node
#!/bin/bash
PORT=${1:-3000}
echo "Verificando porta $PORT..."
# Verificar se está em uso
if lsof -i :$PORT > /dev/null 2>&1; then
echo "Porta $PORT está em uso!"
echo ""
echo "Processo:"
lsof -i :$PORT
echo ""
read -p "Deseja matar o processo? (s/n) " -n 1 -r
echo
if [[ $REPLY =~ ^[Ss]$ ]]; then
fuser -k $PORT/tcp
echo "Processo finalizado!"
fi
else
echo "Porta $PORT está livre!"
fi
- Sempre pare o gateway corretamente com
openclaw gateway stop - Use portas diferentes para cada serviço
- Configure healthchecks para detectar processos travados
- Use process managers como PM2 ou systemd