Skill Sentry CLI para OpenClaw

Visão Geral do Skill Sentry CLI do OpenClaw

O skill Sentry CLI conecta o OpenClaw ao Sentry — a principal plataforma de monitoramento de erros e rastreamento de desempenho — através da ferramenta oficial sentry-cli. Uma vez instalado, seu agente OpenClaw pode gerenciar releases, enviar source maps, consultar problemas, registrar deployments e monitorar cron jobs, tudo através de linguagem natural.

O monitoramento de erros é essencial para aplicações em produção, mas gerenciar releases e depurar problemas frequentemente envolve comandos CLI repetitivos. O skill Sentry CLI do OpenClaw simplifica esse fluxo de trabalho. Em vez de memorizar subcomandos do sentry-cli releases ou enviar source maps manualmente após cada build, basta descrever o que você precisa e deixar o agente cuidar do resto.

Fluxo de trabalho típico:

1. Peça ao OpenClaw para criar um novo release e enviar source maps após um build.
2. O agente executa sentry-cli releases new, envia os maps e finaliza o release.
3. Você recebe um resumo de confirmação com a versão do release e o status do envio — sem etapas manuais necessárias.

Pré-requisitos para o Skill Sentry CLI

Antes de instalar o skill Sentry CLI, certifique-se de que você tem:

• OpenClaw instalado e em execução (v1.0+)
• Sentry CLI instalado — guia de instalação
• Uma conta Sentry com acesso aos projetos que você deseja gerenciar
• Um token de autenticação Sentry com os escopos apropriados
• clawhub CLI instalado para gerenciamento de skills

Verifique sua configuração:

# Verificar a versão do OpenClaw
openclaw --version

# Verificar a versão do Sentry CLI
sentry-cli --version

# Verificar a autenticação do Sentry
sentry-cli info

Instalando o Sentry CLI

Escolha o método que se adapta ao seu ambiente:

# macOS / Linux (instalador automático)
curl -sL https://sentry.io/get-cli/ | sh

# macOS (Homebrew)
brew install getsentry/tools/sentry-cli

# NPM
npm install -g @sentry/cli

# Windows (Scoop)
scoop install sentry-cli

Como Instalar o Skill Sentry CLI

Instale o skill Sentry CLI com um único comando:

npx clawhub@latest install sentry-cli

Para verificar a instalação:

clawhub list

Você deve ver sentry-cli na lista de skills instalados. Visualize o skill antes de instalar com clawhub inspect sentry-cli.

Configuração do Skill Sentry CLI

O skill Sentry CLI requer um token de autenticação para interagir com a API do Sentry. Você pode usar um token de organização (recomendado para CI/CD) ou um token de autenticação pessoal.

Criando um Token de Autenticação

1. Acesse sentry.io/settings/auth-tokens e crie um novo token.
2. Para gerenciamento de releases e envio de source maps, conceda estes escopos:

| Escopo | Finalidade | |--------|-----------| | project:releases | Criar e gerenciar releases | | org:read | Ler dados da organização | | project:read | Ler informações do projeto | | project:write | Enviar source maps e arquivos de depuração |

Configuração de Ambiente

# Definir o token de autenticação do Sentry
export SENTRY_AUTH_TOKEN=sntrys_your_token_here

# Definir sua organização e projeto (opcional, evita flags por comando)
export SENTRY_ORG=your-org-slug
export SENTRY_PROJECT=your-project-slug

# Para instâncias auto-hospedadas do Sentry
export SENTRY_URL=https://sentry.your-company.com/

Importante: Nunca insira tokens diretamente em arquivos de configuração. Use variáveis de ambiente ou um gerenciador de segredos como o 1Password. Limite os tokens às permissões mínimas necessárias — use tokens de organização em vez de tokens pessoais sempre que possível.

Exemplos de Uso do Skill Sentry CLI

1. Criar um Release Após o Deploy

Você: "Crie um novo release no Sentry para a versão 2.4.0 com commits desde o último release, envie os source maps da pasta ./dist e finalize-o."

O agente executa uma sequência de comandos: sentry-cli releases new 2.4.0, sentry-cli releases set-commits 2.4.0 --auto, sentry-cli sourcemaps upload --release=2.4.0 ./dist e sentry-cli releases finalize 2.4.0. Ele confirma cada etapa e reporta o número total de arquivos enviados.

2. Verificar Erros Recentes Após um Deploy

Você: "Mostre os problemas não resolvidos das últimas 24 horas no nosso projeto frontend, ordenados por frequência."

O agente consulta o Sentry em busca de problemas não resolvidos recentes, filtra pelo projeto e janela de tempo especificados, e retorna uma tabela resumida com títulos dos problemas, contagem de eventos, usuários afetados e links para cada problema no painel do Sentry.

3. Registrar um Deployment

Você: "Registre um deployment de produção para o release 2.4.0."

O agente executa sentry-cli releases deploys 2.4.0 new -e production para registrar o deploy. O Sentry então rastreia as taxas de erro antes e depois deste deployment, permitindo o monitoramento da saúde do deploy no painel do Sentry.

4. Monitorar um Cron Job

Você: "Configure o monitoramento do Sentry para nosso script de backup noturno do banco de dados que roda às 2h da manhã."

O agente encapsula o comando de backup com sentry-cli monitors run, configurando-o para reportar check-ins ao Sentry Crons. Se o job falhar ou perder seu agendamento, o Sentry envia um alerta.

Segurança e Boas Práticas

O skill Sentry CLI interage com seus dados de monitoramento de erros e pipeline de releases. Siga estas diretrizes para manter a segurança:

• Use tokens de organização em vez de tokens pessoais. Tokens de organização são limitados a uma única organização e podem ser revogados independentemente sem afetar seu acesso pessoal.
• Conceda os escopos mínimos necessários. Para monitoramento somente leitura, org:read e project:read são suficientes. Adicione project:releases e project:write apenas quando precisar de gerenciamento de releases.
• Rotacione os tokens regularmente. Defina uma data de expiração nos tokens de autenticação e rotacione-os pelo menos a cada 90 dias.
• Proteja dados sensíveis de erros. Os problemas do Sentry podem conter dados pessoais, stack traces ou detalhes do ambiente. Tenha cuidado ao compartilhar resumos ou logs gerados pelo agente.
• Use o .sentryclirc com cautela. Se você usar um arquivo de configuração, certifique-se de que ele está no .gitignore e não foi commitado no controle de versão.
• Revise as ações de release antes de confirmar. Sempre verifique a versão do release e o projeto alvo antes de finalizar um release ou enviar source maps para evitar publicar no projeto errado.

Solução de Erros Comuns

"error: API request failed — 401 Unauthorized"

Seu token de autenticação está ausente, expirado ou não possui os escopos necessários.

1. Verifique a autenticação com sentry-cli info.
2. Confirme que SENTRY_AUTH_TOKEN está definido no seu ambiente.
3. Verifique se o token possui os escopos necessários em sentry.io/settings/auth-tokens.

# Verificação rápida de autenticação
sentry-cli info

"error: Could not find organization"

O slug da organização não corresponde à sua conta Sentry, ou o token não tem acesso a essa organização.

1. Verifique o slug da organização com sentry-cli organizations list.
2. Confirme que SENTRY_ORG corresponde a uma organização que seu token pode acessar.
3. Para instâncias auto-hospedadas, certifique-se de que SENTRY_URL aponta para o servidor correto.

"error: No source maps found in the specified path"

Os arquivos de source map estão ausentes no diretório de envio, ou o caminho está incorreto.

1. Confirme que o diretório de saída do build contém arquivos .map.
2. Verifique se sua ferramenta de build está configurada para gerar source maps.
3. Use um caminho absoluto ou verifique o caminho relativo a partir do seu diretório de trabalho atual.

# Listar arquivos no diretório de build para verificação
ls -la ./dist/*.map