Skill GitHub (gh) para OpenClaw — Guía Completa

Descripción General del Skill GitHub de OpenClaw

El skill de GitHub (gh) conecta OpenClaw a la plataforma GitHub a través del GitHub CLI (gh) oficial. Una vez instalado, tu agente OpenClaw puede interactuar con repositorios, pull requests, issues, flujos de trabajo de Actions y más — usando comandos en lenguaje natural.

Este es uno de los skills más populares y versátiles del ecosistema OpenClaw. Ya sea que estés clasificando issues, abriendo PRs o verificando el estado del CI, el skill de GitHub convierte flujos de trabajo Git de múltiples pasos en conversaciones simples.

Flujo de trabajo típico:

1. Pide a OpenClaw que revise tus PRs pendientes.
2. El agente ejecuta gh pr list en segundo plano.
3. Los resultados se devuelven en un resumen legible — sin necesidad de cambiar de contexto.

Requisitos Previos del Skill GitHub

Antes de instalar el skill de GitHub, asegúrate de tener:

• OpenClaw instalado y en ejecución (v1.0+)
• GitHub CLI (gh) instalado — guía de instalación
• Una cuenta de GitHub con acceso a los repositorios que deseas gestionar
• clawhub CLI instalado para la gestión de skills

Verifica tu configuración:

# Verificar versión de OpenClaw
openclaw --version

# Verificar versión de GitHub CLI
gh --version

# Verificar autenticación de GitHub
gh auth status

Cómo Instalar el Skill de GitHub

Instala el skill de GitHub con un solo comando:

npx clawhub@latest install github

Para verificar la instalación:

clawhub list

Deberías ver github en la lista de skills instalados.

Guía de Configuración del Skill GitHub

El skill de GitHub requiere un Token de Acceso Personal (PAT) o autenticación de GitHub CLI. Recomendamos usar gh auth login para la configuración más sencilla.

Alcances del Token

Si prefieres un PAT, crea uno en github.com/settings/tokens con estos alcances:

| Alcance | Requerido | Propósito | |---------|-----------|-----------| | repo | Sí | Acceso completo a repositorios | | read:org | Recomendado | Leer membresía de organización | | workflow | Opcional | Gestionar flujos de trabajo de GitHub Actions | | read:project | Opcional | Leer tableros de proyecto | | gist | Opcional | Crear y gestionar gists |

Configuración del Entorno

# Opción 1: Usar autenticación de GitHub CLI (recomendado)
gh auth login

# Opción 2: Establecer un Token de Acceso Personal
export GITHUB_TOKEN=ghp_your_token_here

Importante: Nunca incluyas tokens directamente en archivos de configuración. Usa variables de entorno o un gestor de secretos (como 1Password o Bitwarden).

Ejemplos de Uso del Skill GitHub

1. Listar y Clasificar Issues Abiertos

Tú: "Muéstrame los issues abiertos en nuestro repo principal etiquetados como bug."

El agente ejecuta el equivalente de gh issue list --label bug --state open y devuelve un resumen formateado con números de issue, títulos y asignados.

Tú: "Asígneme el issue #42 y añade la etiqueta priority:high."

El agente ejecuta gh issue edit 42 --add-assignee @me --add-label priority:high.

2. Crear un Pull Request

Tú: "Crea un PR desde la rama feature/auth a main con el título 'Add OAuth2 login' y un resumen de los cambios."

El agente prepara el PR usando gh pr create, completa el título y genera una descripción basada en las diferencias de los commits.

3. Revisar un Pull Request

Tú: "Resume los cambios en el PR #128."

El agente obtiene las diferencias con gh pr diff 128, analiza los cambios y proporciona un resumen conciso que incluye:

• Archivos modificados y líneas añadidas/eliminadas
• Cambios clave en la lógica
• Posibles preocupaciones o sugerencias

4. Verificar Estado del CI

Tú: "¿Cuál es el estado de la última ejecución de Actions en main?"

El agente verifica gh run list --branch main --limit 1 e informa si la ejecución pasó, falló o aún está en progreso — junto con un enlace al registro completo.

Seguridad y Mejores Prácticas

El skill de GitHub puede realizar operaciones de escritura en tus repositorios. Sigue estas pautas para mantenerte seguro:

• Usa el mínimo privilegio. Otorga solo los alcances de token que realmente necesitas. Si solo lees repos, omite el alcance workflow.
• Autentícate con gh auth login en lugar de PATs de larga duración cuando sea posible. El CLI maneja la renovación del token automáticamente.
• Revisa antes de fusionar. Siempre confirma las fusiones de PRs y las acciones destructivas. OpenClaw solicitará aprobación por defecto.
• Rota los tokens regularmente. Si usas un PAT, establece una fecha de expiración y rótalo al menos cada 90 días.
• Evita otorgar alcances de administrador. Los alcances admin:org y delete_repo rara vez son necesarios. No los otorgues a menos que sea imprescindible.
• Audita la actividad. Revisa el registro de auditoría de GitHub periódicamente para verificar las acciones realizadas a través de la API.

Errores Comunes y Solución de Problemas

"gh: command not found"

El GitHub CLI no está instalado o no está en tu PATH.

# macOS
brew install gh

# Ubuntu / Debian
sudo apt install gh

# Windows
winget install GitHub.cli

Después de instalar, autentícate con gh auth login.

"HTTP 401: Bad credentials"

Tu token falta, ha expirado o carece de los alcances requeridos.

1. Ejecuta gh auth status para verificar el estado actual de autenticación.
2. Si ha expirado, vuelve a autenticarte con gh auth login.
3. Si usas un PAT, verifica que tenga el alcance repo en github.com/settings/tokens.

"Resource not accessible by integration"

Estás intentando acceder a un repositorio u organización para la que tu token no tiene permiso.

1. Verifica que tu token incluya el alcance read:org.
2. Confirma que tu cuenta de GitHub tiene acceso al repositorio objetivo.
3. Para repos de organización, un administrador puede necesitar aprobar tu token en Settings → Third-party access.