Skill Sentry CLI pour OpenClaw

Présentation du Skill Sentry CLI d'OpenClaw

Le skill Sentry CLI connecte OpenClaw à Sentry — la plateforme leader de surveillance des erreurs et de suivi des performances — via l'outil officiel sentry-cli. Une fois installé, votre agent OpenClaw peut gérer les releases, télécharger les source maps, interroger les problèmes, enregistrer les déploiements et surveiller les tâches planifiées, le tout en langage naturel.

La surveillance des erreurs est essentielle pour les applications en production, mais la gestion des releases et le débogage des problèmes impliquent souvent des commandes CLI répétitives. Le skill OpenClaw Sentry CLI rationalise ce flux de travail. Au lieu de mémoriser les sous-commandes sentry-cli releases ou de télécharger manuellement les source maps après chaque build, décrivez simplement ce dont vous avez besoin et laissez l'agent s'en charger.

Flux de travail typique :

1. Demandez à OpenClaw de créer une nouvelle release et de télécharger les source maps après un build.
2. L'agent exécute sentry-cli releases new, télécharge les maps et finalise la release.
3. Vous recevez un résumé de confirmation avec la version de la release et le statut du téléchargement — aucune étape manuelle requise.

Prérequis pour le Skill Sentry CLI

Avant d'installer le skill Sentry CLI, assurez-vous d'avoir :

• OpenClaw installé et en cours d'exécution (v1.0+)
• Sentry CLI installé — guide d'installation
• Un compte Sentry avec accès aux projets que vous souhaitez gérer
• Un jeton d'authentification Sentry avec les portées appropriées
• clawhub CLI installé pour la gestion des skills

Vérifiez votre configuration :

# Vérifier la version d'OpenClaw
openclaw --version

# Vérifier la version de Sentry CLI
sentry-cli --version

# Vérifier l'authentification Sentry
sentry-cli info

Installation de Sentry CLI

Choisissez la méthode adaptée à votre environnement :

# macOS / Linux (installateur automatique)
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

Comment Installer le Skill Sentry CLI

Installez le skill Sentry CLI avec une seule commande :

npx clawhub@latest install sentry-cli

Pour vérifier l'installation :

clawhub list

Vous devriez voir sentry-cli dans la liste des skills installés. Prévisualisez le skill avant l'installation avec clawhub inspect sentry-cli.

Configuration du Skill Sentry CLI

Le skill Sentry CLI nécessite un jeton d'authentification pour interagir avec l'API Sentry. Vous pouvez utiliser soit un jeton d'organisation (recommandé pour le CI/CD), soit un jeton d'authentification personnel.

Création d'un Jeton d'Authentification

1. Rendez-vous sur sentry.io/settings/auth-tokens et créez un nouveau jeton.
2. Pour la gestion des releases et le téléchargement des source maps, accordez ces portées :

| Portée | Objectif | |--------|----------| | project:releases | Créer et gérer les releases | | org:read | Lire les données de l'organisation | | project:read | Lire les informations du projet | | project:write | Télécharger les source maps et les fichiers de débogage |

Configuration de l'Environnement

# Définir le jeton d'authentification Sentry
export SENTRY_AUTH_TOKEN=sntrys_your_token_here

# Définir votre organisation et projet (optionnel, évite les flags par commande)
export SENTRY_ORG=your-org-slug
export SENTRY_PROJECT=your-project-slug

# Pour les instances Sentry auto-hébergées
export SENTRY_URL=https://sentry.your-company.com/

Important : Ne codez jamais les jetons en dur dans les fichiers de configuration. Utilisez des variables d'environnement ou un gestionnaire de secrets tel que 1Password. Limitez les jetons aux permissions minimales requises — privilégiez les jetons d'organisation par rapport aux jetons personnels lorsque c'est possible.

Exemples d'Utilisation du Skill Sentry CLI

1. Créer une Release Après un Déploiement

Vous : "Crée une nouvelle release Sentry pour la version 2.4.0 avec les commits depuis la dernière release, télécharge les source maps depuis le dossier ./dist, et finalise-la."

L'agent exécute une séquence de commandes : 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, et sentry-cli releases finalize 2.4.0. Il confirme chaque étape et rapporte le nombre total de fichiers téléchargés.

2. Vérifier les Erreurs Récentes Après un Déploiement

Vous : "Montre-moi les problèmes non résolus des dernières 24 heures sur notre projet frontend, triés par fréquence."

L'agent interroge Sentry pour les problèmes non résolus récents, filtre par le projet et la fenêtre temporelle spécifiés, et renvoie un tableau récapitulatif avec les titres des problèmes, le nombre d'événements, les utilisateurs affectés et les liens vers chaque problème dans le tableau de bord Sentry.

3. Enregistrer un Déploiement

Vous : "Enregistre un déploiement en production pour la release 2.4.0."

L'agent exécute sentry-cli releases deploys 2.4.0 new -e production pour enregistrer le déploiement. Sentry suit ensuite les taux d'erreur avant et après ce déploiement, permettant la surveillance de la santé des déploiements dans le tableau de bord Sentry.

4. Surveiller une Tâche Planifiée

Vous : "Configure la surveillance Sentry pour notre script de sauvegarde de base de données nocturne qui s'exécute à 2h du matin."

L'agent encapsule la commande de sauvegarde avec sentry-cli monitors run, en la configurant pour signaler les check-ins à Sentry Crons. Si la tâche échoue ou manque son planning, Sentry envoie une alerte.

Sécurité et Bonnes Pratiques

Le skill Sentry CLI interagit avec vos données de surveillance des erreurs et votre pipeline de releases. Suivez ces recommandations pour rester en sécurité :

• Privilégiez les jetons d'organisation aux jetons personnels. Les jetons d'organisation sont limités à une seule organisation et peuvent être révoqués indépendamment sans affecter votre accès personnel.
• Accordez les portées minimales requises. Pour une surveillance en lecture seule, org:read et project:read sont suffisants. N'ajoutez project:releases et project:write que lorsque vous avez besoin de la gestion des releases.
• Effectuez une rotation régulière des jetons. Définissez une date d'expiration sur les jetons d'authentification et effectuez leur rotation au moins tous les 90 jours.
• Protégez les données d'erreur sensibles. Les problèmes Sentry peuvent contenir des données personnelles, des traces de pile ou des détails d'environnement. Soyez prudent lorsque vous partagez des résumés ou des logs générés par l'agent.
• Utilisez .sentryclirc avec précaution. Si vous utilisez un fichier de configuration, assurez-vous qu'il est dans .gitignore et qu'il n'est pas commité dans le contrôle de version.
• Vérifiez les actions de release avant de confirmer. Vérifiez toujours la version de la release et le projet cible avant de finaliser une release ou de télécharger des source maps pour éviter de publier dans le mauvais projet.

Résolution des Erreurs Courantes

"error: API request failed — 401 Unauthorized"

Votre jeton d'authentification est manquant, expiré ou ne dispose pas des portées requises.

1. Vérifiez l'authentification avec sentry-cli info.
2. Vérifiez que SENTRY_AUTH_TOKEN est défini dans votre environnement.
3. Confirmez que le jeton dispose des portées nécessaires sur sentry.io/settings/auth-tokens.

# Vérification rapide de l'authentification
sentry-cli info

"error: Could not find organization"

Le slug de l'organisation ne correspond pas à votre compte Sentry, ou le jeton n'a pas accès à cette organisation.

1. Vérifiez le slug de l'organisation avec sentry-cli organizations list.
2. Vérifiez que SENTRY_ORG correspond à une organisation à laquelle votre jeton a accès.
3. Pour les instances auto-hébergées, assurez-vous que SENTRY_URL pointe vers le bon serveur.

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

Les fichiers source map sont absents du répertoire de téléchargement, ou le chemin est incorrect.

1. Confirmez que le répertoire de sortie du build contient des fichiers .map.
2. Vérifiez que votre outil de build est configuré pour générer des source maps.
3. Utilisez un chemin absolu ou vérifiez le chemin relatif depuis votre répertoire de travail actuel.

# Lister les fichiers dans le répertoire de build pour vérifier
ls -la ./dist/*.map