Integração com GitHub

Para desenvolvedores, o GitHub é o centro de tudo: código, issues, pull requests, pipelines de CI/CD e colaboração com o time. Mas alternar entre o chat do WhatsApp, Telegram ou Discord e o navegador com o GitHub aberto interrompe o fluxo de trabalho constantemente.

Com a integração do OpenClaw ao GitHub, você controla seus repositórios diretamente pelo canal de chat que já usa. Crie issues durante uma reunião, consulte o status do CI antes de dar merge, e receba alertas de PR sem precisar abrir o navegador.

O Que É Possível Fazer

• Listar e navegar repositórios — veja seus repos recentes, branches ativas e contribuidores
• Criar e gerenciar issues — abra bugs, feature requests e tasks com título, descrição e labels
• Revisão de pull requests — liste PRs abertos, veja diffs resumidos, aprove ou solicite changes
• Status de CI/CD — consulte o resultado dos workflows do GitHub Actions no último commit
• Notificações em tempo real — receba alertas de novos PRs, issues e builds no canal de sua escolha
• Ler e navegar arquivos — leia o README, consulte configurações e veja código sem abrir o navegador
• Gerenciar releases — crie tags, veja changelogs e acompanhe versões publicadas
• Integração com Discord — direcione notificações do GitHub para canais específicos do Discord

Como Configurar

Passo 1: Gerar Token de Acesso Pessoal

1. No GitHub, acesse Settings > Developer Settings > Personal Access Tokens
2. Clique em “Generate new token (classic)”
3. Dê um nome descritivo ao token (ex: “OpenClaw - Acesso Repositórios”)
4. Selecione os escopos necessários:
   • repo — acesso completo a repositórios privados e públicos
   • workflow — para ver e disparar GitHub Actions
   • notifications — para gerenciar notificações
   • read:user — para ler informações do perfil
5. Defina uma data de expiração (recomendado: 90 dias ou mais)
6. Clique em “Generate token” e copie o valor (ele aparece apenas uma vez)

Passo 2: Configurar no OpenClaw

openclaw auth add github --token SEU_TOKEN_AQUI

Ou via arquivo de configuração:

integrations:
  github:
    token: "SEU_GITHUB_TOKEN"
    defaultRepo: "seu-usuario/repo-principal"  # repo padrão para comandos sem contexto
    notifyChannel: "whatsapp"                   # canal para receber alertas

Passo 3: Configurar Webhooks (para notificações em tempo real)

Para receber alertas automáticos de eventos no repositório:

1. No repositório GitHub, vá em Settings > Webhooks > Add webhook
2. Payload URL: https://sua-instancia-openclaw.com/webhooks/github
3. Content type: application/json
4. Selecione os eventos: Pull requests, Issues, Workflow runs
5. Clique em “Add webhook”

Passo 4: Testar a Conexão

Liste meus repositórios recentes

Se a integração estiver funcionando, você verá a lista dos seus repos mais recentes.

Exemplos Práticos

1. Desenvolvedor Solo — Triagem de Issues via WhatsApp

Durante uma reunião com cliente, o cliente reporta um bug. Sem interromper a reunião:

Você: "Cria issue: bug no módulo de pagamento — erro 500 ao processar cartão Visa"
Bot: "Issue #47 criada no repo payments-service. Labels: bug, payment.
     Link: github.com/empresa/payments-service/issues/47"

2. Tech Lead — Revisão Matinal de PRs

Toda manhã, ao tomar café:

Você: "Quais PRs estão aguardando minha revisão?"
Bot: "3 PRs aguardando sua revisão:
     • PR #89: Add OAuth2 support (by carlos) — 2 dias aberto
     • PR #91: Fix null pointer in UserService (by ana) — 1 dia aberto
     • PR #93: Update dependencies (by bot) — hoje"

3. DevOps — Monitoramento de CI/CD

Antes de aprovar um deploy em produção:

Você: "Qual o status do CI na branch main?"
Bot: "Último build na main: ✅ Passou
     Commit: feat: add dark mode (por carlos, há 2h)
     Testes: 247 passando, 0 falhando
     Cobertura: 84%"

4. Time — Notificações no Discord

Configure alertas automáticos para o canal #dev-updates:

Quando PR for aberto na main → poste resumo no #code-review do Discord
Quando CI falhar → alerte no #alertas com detalhes do erro e link
Quando issue de prioridade alta for aberta → ping no #urgente

5. Product Manager — Acompanhamento de Milestones

Você: "Quantos issues abertos temos na milestone v2.0?"
Bot: "Milestone v2.0 — Progresso: 68%
     • Concluídas: 17 issues
     • Em progresso: 5 issues
     • Pendentes: 3 issues
     Prazo: 15 de abril (23 dias restantes)"

Dicas Avançadas

Use labels de forma consistente: Configure o OpenClaw para sempre aplicar labels automáticos com base no texto da issue. Issues com “bug” no título recebem o label bug, issues com “perf” recebem performance.

Templates de issues via chat: Peça ao OpenClaw para memorizar sua estrutura preferida de issue. Depois é só dizer “cria bug” e ele já preenche com o template certo, pedindo apenas os detalhes específicos.

Integração com Notion: Quando uma issue for fechada, atualize automaticamente o status da tarefa correspondente no seu workspace do Notion. Mantém sua gestão de projetos sempre sincronizada.

Alertas de build nos canais certos: Separe os alertas por gravidade — CI falhando vai para o canal de alertas urgentes no Discord, build bem-sucedido vai como resumo no canal de devs.

Revisão de PRs com contexto: O OpenClaw pode buscar issues relacionadas ao PR, verificar se existem testes para as mudanças e alertar sobre mudanças de arquivos críticos, como arquivos de configuração de produção.

Veja o blog do OpenClaw para tutoriais avançados de fluxos com GitHub Actions.

FAQ

Preciso dar acesso de admin ao token? Não necessariamente. Para leitura de repos públicos, um token com escopo public_repo é suficiente. Para repos privados, use repo. Dê apenas as permissões que realmente precisar.

O token expira? Personal Access Tokens clássicos podem ser configurados sem expiração, mas recomendamos definir uma data de expiração por segurança. Quando expirar, gere um novo e atualize a configuração do OpenClaw.

Posso conectar múltiplos repositórios? Sim. O OpenClaw acessa todos os repositórios que o token tem permissão. Você pode definir um repo padrão e especificar outros nos comandos: “Quais issues abertas no repo backend-api?”.

Como funciona com organizações? Para repositórios de uma organização do GitHub, certifique-se de que o token tem acesso à organização. Em algumas organizações, o SSO precisa ser autorizado explicitamente para o token.

O OpenClaw pode fazer commits diretamente? Sim, com as permissões corretas no token. Porém, para modificações de código, recomendamos usar o Claude Code (via integração específica) para revisão adequada antes de commitar.

Próximos Passos

• Integração Discord — direcione notificações do GitHub para canais do servidor
• Integração Notion — sincronize issues com sua gestão de projetos
• Guias de fluxo para desenvolvedores — workflows prontos para times de engenharia
• Como usar o OpenClaw — configurações gerais e personalização
• Glossário — termos de API e webhooks

Próximo: Slack