---
title: "Configuração de Proxy Reverso (Nginx/Caddy)"
url: "https://openclaw.ia.br/troubleshooting/proxy-reverso-configuracao/"
markdown_url: "https://openclaw.ia.br/troubleshooting/proxy-reverso-configuracao.MD"
description: "Configure Nginx ou Caddy como proxy reverso para o OpenClaw: SSL, WebSocket, headers."
date: "2026-02-08"
author: ""
---

# Configuração de Proxy Reverso (Nginx/Caddy)

Configure Nginx ou Caddy como proxy reverso para o OpenClaw: SSL, WebSocket, headers.


## Sintomas

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.

## Diagnóstico Rápido

Antes de tentar as soluções, colete informações:

```bash
# Status geral do OpenClaw
openclaw status

# Logs recentes
openclaw logs --tail 50

# Versão atual
openclaw --version
```

## Soluções


###  WebSocket não configurado

**Prioridade:** Alta

No Nginx, adicione: `proxy_set_header Upgrade $http_upgrade;` e `proxy_set_header Connection 'upgrade';`.


###  SSL termination

**Prioridade:** Alta

Configure SSL no Nginx/Caddy, não no OpenClaw. Set `ssl_enabled: false` no config.yaml.


###  Headers X-Forwarded-*

**Prioridade:** Média

Adicione: `proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;` e `X-Forwarded-Proto $scheme;`.


###  Usar Caddy (mais simples)

**Prioridade:** Média

Caddy configura SSL automaticamente. `reverse_proxy localhost:3000` é tudo que precisa.



## Ainda Com Problemas?

Se nenhuma solução acima resolveu:

1. **Colete logs detalhados**: `openclaw logs --level debug --tail 200 > debug.log`
2. **Verifique a versão**: `openclaw --version` — considere atualizar para a última versão
3. **Busque na comunidade**: [Discord do OpenClaw](https://discord.gg/clawd) — outros usuários podem ter resolvido
4. **Abra uma issue**: [GitHub Issues](https://github.com/openclaw/openclaw/issues) com logs e passos para reproduzir

## Artigos Relacionados

- [Troubleshooting Geral](/troubleshooting/) — índice de todos os problemas
- [Guia de Instalação](/instalacao/) — reinstalar pode resolver problemas persistentes
- [FAQ Técnico](/faq/tecnico/) — perguntas frequentes técnicas
- [Guia de Segurança](/seguranca/) — configurações de segurança