GitHub CLI para Openclaw

Una integración de alto rendimiento de Openclaw Skills para ejecutar operaciones de GitHub, como comprobaciones de PR, logs de runner y consultas de API personalizadas usando el CLI gh.

khurramjamil12
v1.0.0
Jun 16, 2026
0
510
0

Instalar y Descargar

1. ClawHub CLI

La forma más rápida de instalar una habilidad directamente desde el registro.

npx clawhub@latest install github-1

2. Instalación manual

Copia la carpeta de la habilidad a una de estas ubicaciones

Global
~/.openclaw/skills/
Espacio de trabajo
<project>/skills/

Prioridad: Espacio de trabajo > Local > Integrado

3. Instalación del prompt

Copia este prompt en OpenClaw para instalarlo automáticamente.

Ayúdame a instalar github-1 usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).

¿Prefieres descargar?

Obtén los archivos originales de la habilidad en un archivo ZIP.

¿Qué es GitHub CLI?

El GitHub CLI skill permite que su agente de codificación AI interactúe directamente con repositorios de GitHub sin salir de la terminal. Al aprovechar la herramienta oficial gh CLI, este skill permite una gestión fluida de pull requests, issues y ejecuciones de flujos de trabajo de GitHub Actions. Actúa como un puente para automatizar pipelines de desarrollo, verificar el estado de CI y obtener metadatos de repositorios, que son capacidades esenciales para las configuraciones modernas de Openclaw Skills.

Ya sea ejecutando dentro de un repositorio git local o realizando consultas remotas especificando explícitamente los repositorios de destino, este skill proporciona una interfaz robusta orientada a la línea de comandos. Los desarrolladores y agentes automatizados pueden ejecutar consultas complejas, filtrar resultados con selectores personalizados de JSON/jq y depurar fallos de CI/CD sobre la marcha, optimizando todo el ciclo de vida del desarrollo de software.

Casos de uso de GitHub CLI

  • Verificación del estado de integración continua (CI) de pull requests específicos.
  • Monitoreo, listado y depuración de fallos en ejecuciones de flujos de trabajo y logs de actions.
  • Consulta de datos complejos de repositorios directamente desde la API de GitHub usando filtrado avanzado de JQ.
  • Gestión y listado de issues de repositorios con análisis de salida JSON automatizado.
  • Estandarización de flujos de trabajo de desarrollo en contextos locales de git y configuraciones remotas de múltiples repositorios.

Cómo funciona GitHub CLI

  1. Inicialización de comandos: El agente activa un comando de GitHub CLI (por ejemplo, gh pr, gh issue, gh run o gh api).
  2. Resolución de contexto: La herramienta verifica si se está ejecutando dentro de un directorio git local; si no, aplica la flag --repo owner/repo especificada explícitamente.
  3. Ejecución de API y CLI: El skill se comunica con el backend de GitHub para recuperar los recursos solicitados o activar eventos de repositorio.
  4. Análisis y filtrado de salida: El skill utiliza formatos estructurados --json y filtros --jq para extraer campos exactos (como estados de PR o títulos de issues).
  5. Entrega de resultados: Se devuelven metadatos limpios y estructurados o logs de salida al agente que realiza la llamada o al entorno del usuario.

Configuración de GitHub CLI

Requisitos previos

Asegúrese de tener el GitHub CLI oficial (gh) instalado y autenticado en su máquina local.

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

# Autenticar su cuenta de GitHub
gh auth login

Habilitar el Skill

Agregue la configuración del skill de GitHub a la configuración de su espacio de trabajo de Openclaw Skills. Una vez configurado, puede usar los comandos interactivos directamente:

# Probar la instalación consultando un repositorio
gh repo view --repo owner/repo

Esquema de datos y taxonomía de GitHub CLI

Esquema de salida JSON estructurado

Al usar las flags --json y --jq con Openclaw Skills, la estructura de datos subyacente se alinea directamente con los esquemas de payload oficiales de la API de GitHub. Aquí hay un desglose de los esquemas comunes devueltos:

Tipo de comando Campos clave admitidos Ejemplo 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 personalizable .title, .state

Todas las respuestas de consultas estructuradas se emiten en JSON para facilitar la ingesta en pipelines de automatización.

Funciones avanzadas de GitHub CLI

  • Solución de problemas de CI/CD granulares: Use la flag --log-failed en las vistas de ejecución de flujos de trabajo para aislar y recuperar instantáneamente logs solo de los pasos con errores, minimizando el ancho de banda y el ruido en pantalla.
  • Integración directa con la API de GitHub: Use gh api para omitir las limitaciones estándar del CLI, ejecutando consultas REST y GraphQL directamente para la recuperación compleja de metadatos de repositorios.
  • Proyección de datos avanzada: Utilice combinaciones de --json y filtros JQ personalizados para transformar respuestas de API anidadas en formatos planos y optimizados directamente dentro del CLI.
  • Ejecución agnóstica al contexto: Soporte para sobrescritura explícita de la flag --repo, lo que permite que los flujos de trabajo automatizados escalen a través de múltiples repositorios remotos sin requerir clones físicos de git.

SKILL.md


Cargando

Habilidades relacionadas de Openclaw

METADATA

Github Stars: 0
forks: 0

Presentado*