GitHub CLI para Openclaw

Uma integração de alto desempenho do Openclaw Skills para executar operações do GitHub, como verificações de PR, logs de runner e consultas personalizadas de API, usando o CLI gh.

khurramjamil12
v1.0.0
Jun 16, 2026
0
510
0

Instalar e Baixar

1. ClawHub CLI

A maneira mais rápida de instalar uma habilidade diretamente do registro.

npx clawhub@latest install github-1

2. Instalação Manual

Copie a pasta da habilidade para um desses locais

Global
~/.openclaw/skills/
Espaço de trabalho
<project>/skills/

Prioridade: Espaço de Trabalho > Local > Integrado

3. Instalação do Prompt

Copie este prompt para o OpenClaw para instalá-lo automaticamente.

Ajude-me a instalar o github-1 usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).

Prefere baixar?

Obtenha os arquivos originais da habilidade em um arquivo ZIP.

O que é GitHub CLI?

O GitHub CLI skill capacita seu agente de codificação de IA a interagir diretamente com repositórios do GitHub sem sair do terminal. Ao aproveitar a ferramenta oficial gh CLI, este skill permite o gerenciamento contínuo de pull requests, issues e execuções de workflow do GitHub Actions. Ele atua como uma ponte para automatizar pipelines de desenvolvimento, verificar status de CI e buscar metadados de repositório, que são capacidades essenciais para configurações modernas do Openclaw Skills.

Seja executando dentro de um repositório git local ou realizando consultas remotas especificando explicitamente os repositórios de destino, este skill fornece uma interface robusta e focada na linha de comando. Desenvolvedores e agentes automatizados podem executar consultas complexas, filtrar saídas com seletores personalizados de JSON/jq e depurar falhas de CI/CD instantaneamente, simplificando todo o ciclo de vida do desenvolvimento de software.

Casos de uso do GitHub CLI

  • Verificação do status de integração contínua (CI) de pull requests específicos.
  • Monitoramento, listagem e depuração de falhas em execuções de workflow e logs de actions.
  • Consulta de dados complexos de repositórios diretamente da API do GitHub usando filtragem avançada de JQ.
  • Gerenciamento e listagem de issues de repositório com parsing de saída JSON automatizado.
  • Padronização de fluxos de trabalho de desenvolvimento em contextos locais de git e configurações remotas de múltiplos repositórios.

Como o GitHub CLI funciona

  1. Inicialização de Comando: O agente dispara um comando do GitHub CLI (por exemplo, gh pr, gh issue, gh run ou gh api).
  2. Resolução de Contexto: A ferramenta verifica se está sendo executada em um diretório git local; caso contrário, aplica a flag --repo owner/repo especificada explicitamente.
  3. Execução de API e CLI: O skill se comunica com o backend do GitHub para recuperar recursos solicitados ou disparar eventos de repositório.
  4. Parsing e Filtragem de Saída: O skill utiliza formatos estruturados --json e filtros --jq para extrair campos exatos (como estados de PR ou títulos de issues).
  5. Entrega de Resultado: Metadados limpos e estruturados ou saídas de log são retornados ao agente chamador ou ambiente do usuário.

Configuração do GitHub CLI

Pré-requisitos

Certifique-se de que você tenha o GitHub CLI oficial (gh) instalado e autenticado em sua máquina local.

# Instalar GitHub CLI (exemplo para macOS)
brew install gh

# Autenticar sua conta do GitHub
gh auth login

Habilitando o Skill

Adicione a configuração do skill do GitHub à configuração do seu workspace do Openclaw Skills. Uma vez configurado, você pode usar os comandos interativos diretamente:

# Testar a instalação consultando um repositório
gh repo view --repo owner/repo

Esquema de Dados e Taxonomia de GitHub CLI

Esquema de Saída JSON Estruturado

Ao usar as flags --json e --jq com o Openclaw Skills, a estrutura de dados subjacente alinha-se diretamente com os esquemas de payload oficiais da API do GitHub. Aqui está uma análise dos esquemas comuns retornados:

Tipo de Comando Campos Principais Suportados Exemplo de Consulta JQ
Pull Requests (gh pr) number, title, state, author .[] | .title
Workflow Runs (gh run) id, name, status, conclusion .workflow_runs[] | .id
Issues (gh issue) number, title, state, labels .[] | .title
GitHub API (gh api) Payload dinâmico customizável .title, .state

Todas as respostas de consultas estruturadas são emitidas em JSON para fácil ingestão em pipelines de automação.

Recursos avançados do GitHub CLI

  • Solução de problemas de CI/CD granulares: Use a flag --log-failed nas visualizações de execução de workflow para isolar e recuperar logs instantaneamente apenas de etapas com falha, minimizando o uso de largura de banda e ruído na tela.
  • Integração direta com a API do GitHub: Use gh api para contornar limitações padrão do CLI, executando consultas REST e GraphQL diretamente para a recuperação complexa de metadados de repositórios.
  • Projeção de dados avançada: Utilize filtros combinados --json e JQ personalizados para transformar respostas de API aninhadas em formatos otimizados e planos diretamente dentro do CLI.
  • Execução agnóstica de contexto: Suporte para substituição explícita da flag --repo, permitindo que fluxos de trabalho automatizados escalem através de múltiplos repositórios remotos sem exigir clones físicos de git.

SKILL.md


Carregamento

Habilidades relacionadas do Openclaw

METADATA

Github Stars: 0
forks: 0

Apresentou*