Webhook do GitHub Não Funciona

Sintomas

Webhooks do GitHub não disparam notificações no OpenClaw, ou disparam com erro.

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:

# Status geral do OpenClaw
openclaw status

# Logs recentes
openclaw logs --tail 50

# Versão atual
openclaw --version

Soluções🔴 URL incorreta

Prioridade: Alta

Verifique a URL do webhook: https://seu-servidor:porta/webhook/github. Confirme que o OpenClaw está acessível externamente.

🔴 Secret incorreto

Prioridade: Alta

O secret no GitHub deve ser idêntico ao configurado em config.yaml. Regenere: openclaw webhook github --regenerate-secret.

🟡 Firewall bloqueando

Prioridade: Média

GitHub envia de IPs específicos. Adicione os ranges do GitHub (api.github.com/meta) ao seu firewall.

🟢 Eventos não selecionados

Prioridade: Baixa

No GitHub, verifique se os eventos corretos estão selecionados (push, PR, issues, etc.).

Ainda Com Problemas?

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

📄 Mais em Troubleshooting