Skill Sentry CLI para OpenClaw

Descripción General del Skill Sentry CLI de OpenClaw

El skill Sentry CLI conecta OpenClaw con Sentry — la plataforma líder en monitoreo de errores y seguimiento de rendimiento — a través de la herramienta oficial sentry-cli. Una vez instalado, tu agente OpenClaw puede gestionar releases, subir source maps, consultar incidencias, registrar despliegues y monitorear tareas programadas, todo mediante lenguaje natural.

El monitoreo de errores es fundamental para las aplicaciones en producción, pero gestionar releases y depurar incidencias a menudo implica comandos CLI repetitivos. El skill Sentry CLI de OpenClaw simplifica este flujo de trabajo. En lugar de memorizar los subcomandos de sentry-cli releases o subir source maps manualmente después de cada compilación, simplemente describe lo que necesitas y deja que el agente se encargue del resto.

Flujo de trabajo típico:

1. Pide a OpenClaw que cree un nuevo release y suba los source maps después de una compilación.
2. El agente ejecuta sentry-cli releases new, sube los maps y finaliza el release.
3. Recibes un resumen de confirmación con la versión del release y el estado de la subida — sin pasos manuales.

Requisitos Previos del Skill Sentry CLI

Antes de instalar el skill Sentry CLI, asegúrate de tener:

• OpenClaw instalado y en ejecución (v1.0+)
• Sentry CLI instalado — guía de instalación
• Una cuenta de Sentry con acceso a los proyectos que deseas gestionar
• Un token de autenticación de Sentry con los permisos adecuados
• clawhub CLI instalado para la gestión de skills

Verifica tu configuración:

# Verificar la versión de OpenClaw
openclaw --version

# Verificar la versión de Sentry CLI
sentry-cli --version

# Verificar la autenticación de Sentry
sentry-cli info

Instalación de Sentry CLI

Elige el método que se adapte a tu entorno:

# 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

Cómo Instalar el Skill Sentry CLI

Instala el skill Sentry CLI con un solo comando:

npx clawhub@latest install sentry-cli

Para verificar la instalación:

clawhub list

Deberías ver sentry-cli en la lista de skills instalados. Previsualiza el skill antes de instalarlo con clawhub inspect sentry-cli.

Configuración del Skill Sentry CLI

El skill Sentry CLI requiere un token de autenticación para interactuar con la API de Sentry. Puedes usar un token de organización (recomendado para CI/CD) o un token de autenticación personal.

Creación de un Token de Autenticación

1. Ve a sentry.io/settings/auth-tokens y crea un nuevo token.
2. Para la gestión de releases y la subida de source maps, otorga estos permisos:

| Permiso | Propósito | |---------|-----------| | project:releases | Crear y gestionar releases | | org:read | Leer datos de la organización | | project:read | Leer información del proyecto | | project:write | Subir source maps y archivos de depuración |

Configuración del Entorno

# Establecer el token de autenticación de Sentry
export SENTRY_AUTH_TOKEN=sntrys_your_token_here

# Establecer tu organización y proyecto (opcional, evita flags por comando)
export SENTRY_ORG=your-org-slug
export SENTRY_PROJECT=your-project-slug

# Para instancias de Sentry autoalojadas
export SENTRY_URL=https://sentry.your-company.com/

Importante: Nunca incluyas tokens directamente en archivos de configuración. Usa variables de entorno o un gestor de secretos como 1Password. Limita los permisos de los tokens al mínimo necesario — usa tokens de organización en lugar de tokens personales siempre que sea posible.

Ejemplos de Uso del Skill Sentry CLI

1. Crear un Release Después de un Despliegue

Tú: "Crea un nuevo release de Sentry para la versión 2.4.0 con los commits desde el último release, sube los source maps de la carpeta ./dist y finalízalo."

El agente ejecuta una secuencia 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 y sentry-cli releases finalize 2.4.0. Confirma cada paso e informa el número total de archivos subidos.

2. Verificar Errores Recientes Después de un Despliegue

Tú: "Muéstrame las incidencias sin resolver de las últimas 24 horas en nuestro proyecto frontend, ordenadas por frecuencia."

El agente consulta Sentry para obtener las incidencias recientes sin resolver, filtra por el proyecto y la ventana de tiempo especificados, y devuelve una tabla resumen con los títulos de las incidencias, el conteo de eventos, los usuarios afectados y los enlaces a cada incidencia en el panel de Sentry.

3. Registrar un Despliegue

Tú: "Registra un despliegue en producción para el release 2.4.0."

El agente ejecuta sentry-cli releases deploys 2.4.0 new -e production para registrar el despliegue. Sentry entonces rastrea las tasas de error antes y después de este despliegue, habilitando el monitoreo de salud de deploys en el panel de Sentry.

4. Monitorear una Tarea Programada

Tú: "Configura el monitoreo de Sentry para nuestro script de respaldo nocturno de base de datos que se ejecuta a las 2am."

El agente envuelve el comando de respaldo con sentry-cli monitors run, configurándolo para reportar check-ins a Sentry Crons. Si la tarea falla o no se ejecuta en el horario previsto, Sentry envía una alerta.

Seguridad y Mejores Prácticas

El skill Sentry CLI interactúa con tus datos de monitoreo de errores y tu pipeline de releases. Sigue estas directrices para mantener la seguridad:

• Usa tokens de organización en lugar de tokens personales. Los tokens de organización están limitados a una sola organización y pueden revocarse de forma independiente sin afectar tu acceso personal.
• Otorga los permisos mínimos necesarios. Para monitoreo de solo lectura, org:read y project:read son suficientes. Solo añade project:releases y project:write cuando necesites gestión de releases.
• Rota los tokens regularmente. Establece una fecha de expiración en los tokens de autenticación y rótalos al menos cada 90 días.
• Protege los datos sensibles de errores. Las incidencias de Sentry pueden contener datos personales, trazas de pila o detalles del entorno. Ten precaución al compartir resúmenes o registros generados por el agente.
• Usa .sentryclirc con cuidado. Si usas un archivo de configuración, asegúrate de que esté en .gitignore y no se suba al control de versiones.
• Revisa las acciones de release antes de confirmar. Siempre verifica la versión del release y el proyecto de destino antes de finalizar un release o subir source maps para evitar publicar en el proyecto equivocado.

Solución de Errores Comunes

"error: API request failed — 401 Unauthorized"

Tu token de autenticación falta, ha expirado o no tiene los permisos requeridos.

1. Verifica la autenticación con sentry-cli info.
2. Comprueba que SENTRY_AUTH_TOKEN esté configurado en tu entorno.
3. Confirma que el token tenga los permisos necesarios en sentry.io/settings/auth-tokens.

# Verificación rápida de autenticación
sentry-cli info

"error: Could not find organization"

El slug de la organización no coincide con tu cuenta de Sentry, o el token no tiene acceso a esa organización.

1. Verifica el slug de la organización con sentry-cli organizations list.
2. Comprueba que SENTRY_ORG coincida con una organización a la que tu token tenga acceso.
3. Para instancias autoalojadas, asegúrate de que SENTRY_URL apunte al servidor correcto.

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

Los archivos de source maps no se encuentran en el directorio de subida, o la ruta es incorrecta.

1. Confirma que el directorio de salida de la compilación contenga archivos .map.
2. Verifica que tu herramienta de compilación esté configurada para generar source maps.
3. Usa una ruta absoluta o verifica la ruta relativa desde tu directorio de trabajo actual.

# Listar archivos en el directorio de compilación para verificar
ls -la ./dist/*.map