Habilidades de GitLab para Openclaw

Gestiona proyectos, incidencias, merge requests y pipelines de CI/CD de GitLab desde una única herramienta de línea de comandos de Python.

weiguang1017
v0.1.1
Oct 8, 2026
0
2.6k
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 gitlab-devops-skill

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 gitlab-devops-skill 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 Habilidades de GitLab?

GitLab Skills permite que un agente de programación con IA trabaje con GitLab mediante GitLab REST API v4 y la interfaz de línea de comandos incluida scripts/gitlab_cli.py. Úsalo para buscar e inspeccionar proyectos, enumerar o crear incidencias y merge requests, fusionar MR aptos e inspeccionar o activar pipelines de CI/CD en GitLab.com o en instancias autogestionadas compatibles.

Como uno de los Openclaw Skills para flujos de trabajo de desarrollo, devuelve los resultados de los comandos en JSON para facilitar la automatización y la creación de scripts fiables. Las credenciales se leen de variables de entorno o de un archivo de configuración local opcional; las operaciones de escritura requieren que el usuario confirme el proyecto y la rama de destino antes de ejecutarse.

Casos de uso de Habilidades de GitLab

  • Busca proyectos por término de búsqueda o inspecciona un proyecto mediante su ID numérico o la ruta group/subgroup/project.
  • Revisa incidencias abiertas o crea una incidencia para hacer un seguimiento de un error o una tarea.
  • Enumera merge requests, abre un MR de una rama de origen a una rama de destino o fusiona un MR listo.
  • Comprueba la actividad del pipeline de una rama o ref y determina si se ha completado correctamente.
  • Activa un pipeline en una ref cuando el proyecto tenga un archivo .gitlab-ci.yml.
  • Automatiza tareas de GitLab.com o de un GitLab autogestionado desde un agente de IA, un flujo de trabajo de terminal o un script.

Cómo funciona Habilidades de GitLab

  1. Lee la URL de la instancia de GitLab y el token API de las variables de entorno GITLAB_URL y GITLAB_TOKEN o de ~/.devops-skills/gitlab.json.
  2. Ejecuta scripts/gitlab_cli.py con un comando compatible y un identificador de proyecto. Usa un ID numérico de proyecto o una ruta como group/subgroup/project.
  3. Antes de emitir el comando, comprueba la versión de GitLab mediante /api/v4/version; se rechazan las instancias anteriores a GitLab 9.0 salvo que se omita explícitamente la comprobación de versión.
  4. Envía la operación solicitada a GitLab REST API v4. Las operaciones de lectura obtienen información sobre proyectos, incidencias, MR o pipelines; las operaciones de escritura crean incidencias o MR, fusionan MR o activan pipelines.
  5. Devuelve el resultado como JSON en stdout. Si se produce un error, finaliza con un estado distinto de cero. Las operaciones de fusión y de pipelines están sujetas a los requisitos de GitLab para proyectos, ramas, MR y configuración de CI.

Configuración de Habilidades de GitLab

  1. Crea un token de acceso de GitLab en Configuración de usuario → Tokens de acceso y concédele el ámbito api.
  2. Configura la URL y el token de GitLab como variables de entorno o utiliza el archivo de configuración opcional ~/.devops-skills/gitlab.json. No incluyas el token directamente en los argumentos de la línea de comandos.
  3. Usa un entorno Python con la dependencia requests instalada. La documentación de la skill recomienda llamar a la CLI con la ruta absoluta de Python proporcionada, si está disponible.
  4. Ejecuta un comando de la CLI con un ID o una ruta de proyecto. Confirma con el usuario el proyecto y la rama de destino antes de cualquier operación de escritura.
export GITLAB_URL="https://gitlab.com"  # Para GitLab autogestionado, usa la URL de su instancia
export GITLAB_TOKEN="<access-token>"    # Requiere el ámbito api

PY="$HOME/.workbuddy/binaries/python/envs/default/bin/python"

# Si falta requests, instálalo en el mismo entorno Python:
"$PY" -m pip install requests

"$PY" scripts/gitlab_cli.py list-projects --search app
"$PY" scripts/gitlab_cli.py get-project group/app
"$PY" scripts/gitlab_cli.py list-issues group/app --state opened
"$PY" scripts/gitlab_cli.py create-issue group/app --title "Bug" --description "..."
"$PY" scripts/gitlab_cli.py list-mrs group/app --state opened
"$PY" scripts/gitlab_cli.py create-mr group/app --source feat --target main --title "Add feature"
"$PY" scripts/gitlab_cli.py merge-mr group/app 42
"$PY" scripts/gitlab_cli.py list-pipelines group/app --ref main
"$PY" scripts/gitlab_cli.py trigger-pipeline group/app --ref main

La CLI admite GitLab.com e instancias autogestionadas de GitLab 9.0+ mediante REST API v4. Para obtener información detallada sobre configuración, campos y resolución de problemas, consulta references/USAGE.md.

Esquema de datos y taxonomía de Habilidades de GitLab

La skill utiliza recursos de la API de GitLab y no documenta una base de datos local ni archivos de proyecto generados. Las respuestas de la CLI se escriben como JSON en stdout; los errores se indican con un código de salida distinto de cero.

Recurso o archivo Finalidad
scripts/gitlab_cli.py CLI de Python incluida para operaciones de proyectos, incidencias, MR y pipelines.
~/.devops-skills/gitlab.json Archivo de configuración local opcional para los ajustes de conexión de GitLab.
references/USAGE.md Documentación detallada sobre configuración, campos y resolución de problemas.
Proyecto de GitLab El destino se identifica mediante un ID numérico o una ruta group/subgroup/project codificada para URL.
Incidencias Se enumeran o crean para un proyecto; para crearlas se acepta un título y una descripción.
Merge requests Se enumeran, se crean desde ramas de origen y destino o se fusionan por número de MR cuando cumplen los requisitos.
Pipelines Se enumeran por proyecto y ref, o se activan para una ref cuando el proyecto contiene .gitlab-ci.yml.

Los metadatos de conexión incluyen la URL de la instancia de GitLab y el token de acceso. Guarda el token en el entorno o en la configuración local, en lugar de pasarlo como argumento de la CLI.

Funciones avanzadas de Habilidades de GitLab

  • Admite GitLab.com e instancias autogestionadas de GitLab 9.0+ mediante REST API v4; la CLI codifica las rutas de los proyectos.
  • Comprueba la versión de GitLab antes de ejecutar comandos. Define GITLAB_SKIP_VERSION_CHECK=1 o DEVOPS_SKILLS_SKIP_VERSION_CHECK=1 para omitir la comprobación cuando sea necesario.
  • Emite JSON en stdout y utiliza códigos de salida distintos de cero en caso de error, por lo que los resultados son adecuados para la automatización posterior.
  • Abarca flujos de lectura y escritura en proyectos, incidencias, merge requests y pipelines de CI/CD.
  • Las operaciones de escritura —crear incidencias o MR, fusionar MR y activar pipelines— requieren que el usuario confirme el proyecto y la rama de destino. Un MR debe poder fusionarse y, para activar pipelines, se necesita un archivo .gitlab-ci.yml.

SKILL.md


Cargando

Habilidades relacionadas de Openclaw

METADATA

Github Stars: 0
forks: 0

Presentado*