--- title: "Integração GitHub — PRs, Issues e CI/CD" url: "https://openclaw.ia.br/integracoes/github/" markdown_url: "https://openclaw.ia.br/integracoes/github.MD" description: "Conecte OpenClaw ao GitHub: criar issues, revisar PRs, ver status de CI/CD pelo WhatsApp ou Telegram. Token e configuração." date: "" author: "" --- # Integração GitHub — PRs, Issues e CI/CD Conecte OpenClaw ao GitHub: criar issues, revisar PRs, ver status de CI/CD pelo WhatsApp ou Telegram. Token e configuração. # 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](/integracoes/discord/) ## Como Configurar ### Passo 1: Gerar Token de Acesso Pessoal 1. No GitHub, acesse [Settings > Developer Settings > Personal Access Tokens](https://github.com/settings/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 ```bash openclaw auth add github --token SEU_TOKEN_AQUI ``` Ou via arquivo de configuração: ```yaml 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](/integracoes/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. Para merges, releases e mudanças sensíveis, combine essa automação com uma política de [human-in-the-loop em IA](/blog/human-in-the-loop-ia-aprovacao-agentes-openclaw/) antes de permitir ações pelo chat. **Veja o [blog do OpenClaw](/blog/) 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](/integracoes/discord/) — direcione notificações do GitHub para canais do servidor - [Integração Notion](/integracoes/notion/) — sincronize issues com sua gestão de projetos - [Guias de fluxo para desenvolvedores](/guias/) — workflows prontos para times de engenharia - [Como usar o OpenClaw](/como-usar/) — configurações gerais e personalização - [Glossário — termos de API e webhooks](/glossario/) --- *Próximo: [Slack](/integracoes/slack/)*