Habilidades do GitLab para Openclaw

Gerencie projetos, issues, merge requests e pipelines de CI/CD do GitLab com uma única ferramenta de linha de comando em Python.

weiguang1017
v0.1.1
Oct 8, 2026
0
2.6k
0

Instalar e Baixar

1. ClawHub CLI

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

npx clawhub@latest install gitlab-devops-skill

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

O GitLab Skills permite que um agente de programação com IA trabalhe com o GitLab por meio da GitLab REST API v4 e da interface de linha de comando scripts/gitlab_cli.py incluída. Use-o para encontrar e inspecionar projetos, listar ou criar issues e merge requests, mesclar MRs elegíveis e inspecionar ou acionar pipelines de CI/CD no GitLab.com ou em instâncias autogerenciadas compatíveis.

Como um dos Openclaw Skills para fluxos de trabalho de desenvolvimento, ele retorna os resultados dos comandos como JSON para automação e criação de scripts confiáveis. As credenciais são lidas de variáveis de ambiente ou de um arquivo de configuração local opcional; as operações de escrita exigem a confirmação do usuário sobre o projeto e a branch de destino antes da execução.

Casos de uso do Habilidades do GitLab

  • Encontre projetos por termo de pesquisa ou inspecione um projeto usando seu ID numérico ou o caminho group/subgroup/project.
  • Revise issues abertas ou crie uma issue para acompanhar um bug ou uma tarefa.
  • Liste merge requests, abra um MR de uma branch de origem para uma branch de destino ou mescle um MR pronto.
  • Verifique a atividade do pipeline para uma branch ou ref e determine se ele foi concluído com sucesso.
  • Acione um pipeline em uma ref quando o projeto tiver um arquivo .gitlab-ci.yml.
  • Automatize tarefas do GitLab.com ou de um GitLab autogerenciado por meio de um agente de IA, fluxo de trabalho no terminal ou script.

Como o Habilidades do GitLab funciona

  1. Leia a URL da instância GitLab e o token API das variáveis de ambiente GITLAB_URL e GITLAB_TOKEN ou de ~/.devops-skills/gitlab.json.
  2. Execute scripts/gitlab_cli.py com um comando compatível e um identificador de projeto. Use um ID numérico de projeto ou um caminho como group/subgroup/project.
  3. Antes de emitir o comando, verifique a versão do GitLab por meio de /api/v4/version; instâncias anteriores ao GitLab 9.0 são rejeitadas, a menos que a verificação de versão seja explicitamente ignorada.
  4. Envie a operação solicitada à GitLab REST API v4. As operações de leitura recuperam informações de projetos, issues, MRs ou pipelines; as operações de escrita criam issues ou MRs, mesclam MRs ou acionam pipelines.
  5. Retorne o resultado como JSON em stdout. Em caso de falha, encerre com um status diferente de zero. As operações de mesclagem e pipeline estão sujeitas aos requisitos de projeto, branch, MR e configuração de CI do GitLab.

Configuração do Habilidades do GitLab

  1. Crie um token de acesso do GitLab em Configurações do usuário → Tokens de acesso e conceda o escopo api.
  2. Configure a URL e o token do GitLab como variáveis de ambiente ou use o arquivo de configuração opcional em ~/.devops-skills/gitlab.json. Não coloque o token diretamente nos argumentos da linha de comando.
  3. Use um ambiente Python com a dependência requests instalada. A documentação da skill recomenda chamar o CLI com o caminho absoluto do Python fornecido, quando disponível.
  4. Execute um comando do CLI com um ID ou caminho de projeto. Confirme com o usuário o projeto e a branch de destino antes de qualquer operação de escrita.
export GITLAB_URL="https://gitlab.com"  # Para GitLab autogerenciado, use a URL da instância
export GITLAB_TOKEN="<access-token>"    # Requer o escopo api

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

# Se requests estiver ausente, instale-o no mesmo ambiente 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

O CLI oferece suporte ao GitLab.com e a instâncias autogerenciadas do GitLab 9.0+ usando a REST API v4. Para obter detalhes sobre configuração, campos e solução de problemas, consulte references/USAGE.md.

Esquema de Dados e Taxonomia de Habilidades do GitLab

A skill usa recursos da API do GitLab e não documenta um banco de dados local nem arquivos de projeto gerados. As respostas do CLI são gravadas como JSON em stdout; falhas são indicadas por um código de saída diferente de zero.

Recurso ou arquivo Finalidade
scripts/gitlab_cli.py CLI Python incluído para operações com projetos, issues, MRs e pipelines.
~/.devops-skills/gitlab.json Arquivo de configuração local opcional para as configurações de conexão do GitLab.
references/USAGE.md Documentação detalhada de configuração, campos e solução de problemas.
Projeto GitLab O destino é identificado por um ID numérico ou pelo caminho group/subgroup/project codificado para URL.
Issues Listadas ou criadas para um projeto; a criação aceita um título e uma descrição.
Merge requests Listados, criados a partir de branches de origem e destino ou mesclados pelo número do MR quando elegíveis.
Pipelines Listados por projeto e ref ou acionados para uma ref quando o projeto contém .gitlab-ci.yml.

Os metadados de conexão incluem a URL da instância GitLab e o token de acesso. Mantenha o token no ambiente ou na configuração local, em vez de passá-lo como argumento do CLI.

Recursos avançados do Habilidades do GitLab

  • Oferece suporte ao GitLab.com e a instâncias autogerenciadas do GitLab 9.0+ por meio da REST API v4; os caminhos dos projetos são codificados pelo CLI.
  • Verifica a versão do GitLab antes de executar comandos. Defina GITLAB_SKIP_VERSION_CHECK=1 ou DEVOPS_SKILLS_SKIP_VERSION_CHECK=1 para ignorar a verificação quando necessário.
  • Emite JSON em stdout e usa códigos de saída diferentes de zero em caso de falha, tornando os resultados adequados para automação posterior.
  • Abrange fluxos de leitura e escrita em projetos, issues, merge requests e pipelines de CI/CD.
  • As operações de escrita — criar issues ou MRs, mesclar MRs e acionar pipelines — exigem a confirmação do usuário sobre o projeto e a branch de destino. Um MR precisa estar apto para mesclagem, e o acionamento de pipelines exige um arquivo .gitlab-ci.yml.

SKILL.md


Carregamento

Habilidades relacionadas do Openclaw

METADATA

Github Stars: 0
forks: 0

Apresentou*