Configuração de Proxy Reverso (Nginx/Caddy)
Configure Nginx ou Caddy como proxy reverso para o OpenClaw: SSL, WebSocket, headers.
O OpenClaw está por trás de proxy reverso mas webhooks falham ou WebSocket não conecta.
Se você está enfrentando esse problema, siga as soluções abaixo em ordem de probabilidade.
Antes de tentar as soluções, colete informações:
# Status geral do OpenClaw
openclaw status
# Logs recentes
openclaw logs --tail 50
# Versão atual
openclaw --version
Prioridade: Alta
No Nginx, adicione: proxy_set_header Upgrade $http_upgrade; e proxy_set_header Connection 'upgrade';.
Prioridade: Alta
Configure SSL no Nginx/Caddy, não no OpenClaw. Set ssl_enabled: false no config.yaml.
Prioridade: Média
Adicione: proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; e X-Forwarded-Proto $scheme;.
Prioridade: Média
Caddy configura SSL automaticamente. reverse_proxy localhost:3000 é tudo que precisa.
Se nenhuma solução acima resolveu:
- Colete logs detalhados:
openclaw logs --level debug --tail 200 > debug.log - Verifique a versão:
openclaw --version— considere atualizar para a última versão - Busque na comunidade: Discord do OpenClaw — outros usuários podem ter resolvido
- Abra uma issue: GitHub Issues com logs e passos para reproduzir
- Troubleshooting Geral — índice de todos os problemas
- Guia de Instalação — reinstalar pode resolver problemas persistentes
- FAQ Técnico — perguntas frequentes técnicas
- Guia de Segurança — configurações de segurança