Sentry CLI Skill für OpenClaw

OpenClaw Sentry CLI Skill Übersicht

Der Sentry CLI Skill verbindet OpenClaw mit Sentry — der führenden Plattform für Fehlerüberwachung und Performance-Tracking — über das offizielle sentry-cli-Tool. Nach der Installation kann Ihr OpenClaw-Agent Releases verwalten, Source Maps hochladen, Probleme abfragen, Deployments registrieren und Cron-Jobs überwachen — alles in natürlicher Sprache.

Fehlerüberwachung ist entscheidend für Produktionsanwendungen, aber die Verwaltung von Releases und das Debuggen von Problemen erfordert oft repetitive CLI-Befehle. Der OpenClaw Sentry CLI Skill optimiert diesen Workflow. Anstatt sich sentry-cli releases-Unterbefehle zu merken oder nach jedem Build manuell Source Maps hochzuladen, beschreiben Sie einfach, was Sie brauchen, und lassen den Agent den Rest erledigen.

Typischer Workflow:

1. Bitten Sie OpenClaw, nach einem Build einen neuen Release zu erstellen und Source Maps hochzuladen.
2. Der Agent führt sentry-cli releases new aus, lädt die Maps hoch und finalisiert den Release.
3. Sie erhalten eine Bestätigungszusammenfassung mit der Release-Version und dem Upload-Status — keine manuellen Schritte erforderlich.

Voraussetzungen für den Sentry CLI Skill

Stellen Sie vor der Installation des Sentry CLI Skills sicher, dass Sie Folgendes haben:

• OpenClaw installiert und ausgeführt (v1.0+)
• Sentry CLI installiert — Installationsanleitung
• Ein Sentry-Konto mit Zugriff auf die Projekte, die Sie verwalten möchten
• Einen Sentry-Auth-Token mit den entsprechenden Berechtigungen
• clawhub CLI installiert für die Skill-Verwaltung

Überprüfen Sie Ihre Einrichtung:

# OpenClaw-Version prüfen
openclaw --version

# Sentry CLI-Version prüfen
sentry-cli --version

# Sentry-Authentifizierung überprüfen
sentry-cli info

Sentry CLI installieren

Wählen Sie die Methode, die zu Ihrer Umgebung passt:

# macOS / Linux (automatisches Installationsskript)
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

So Installieren Sie den Sentry CLI Skill

Installieren Sie den Sentry CLI Skill mit einem einzigen Befehl:

npx clawhub@latest install sentry-cli

Um die Installation zu überprüfen:

clawhub list

Sie sollten sentry-cli in der Liste der installierten Skills sehen. Prüfen Sie den Skill vor der Installation mit clawhub inspect sentry-cli.

Sentry CLI Skill Konfiguration

Der Sentry CLI Skill benötigt einen Authentifizierungs-Token für die Interaktion mit der Sentry-API. Sie können entweder einen Organisations-Token (empfohlen für CI/CD) oder einen persönlichen Auth-Token verwenden.

Auth-Token erstellen

1. Gehen Sie zu sentry.io/settings/auth-tokens und erstellen Sie einen neuen Token.
2. Für Release-Verwaltung und Source-Map-Uploads gewähren Sie diese Berechtigungen:

| Berechtigung | Zweck | |-------|---------| | project:releases | Releases erstellen und verwalten | | org:read | Organisationsdaten lesen | | project:read | Projektinformationen lesen | | project:write | Source Maps und Debug-Dateien hochladen |

Umgebungseinrichtung

# Sentry-Auth-Token setzen
export SENTRY_AUTH_TOKEN=sntrys_your_token_here

# Organisation und Projekt festlegen (optional, vermeidet Flags pro Befehl)
export SENTRY_ORG=your-org-slug
export SENTRY_PROJECT=your-project-slug

# Für selbst gehostete Sentry-Instanzen
export SENTRY_URL=https://sentry.your-company.com/

Wichtig: Speichern Sie Tokens niemals fest in Konfigurationsdateien. Verwenden Sie Umgebungsvariablen oder einen Geheimnis-Manager wie 1Password. Beschränken Sie Tokens auf die minimal erforderlichen Berechtigungen — verwenden Sie Organisations-Tokens statt persönlicher Tokens, wenn möglich.

Sentry CLI Skill Anwendungsbeispiele

1. Release nach einem Deploy erstellen

Du: "Erstelle einen neuen Sentry-Release für Version 2.4.0 mit Commits seit dem letzten Release, lade Source Maps aus dem Ordner ./dist hoch und finalisiere ihn."

Der Agent führt eine Reihe von Befehlen aus: 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 und sentry-cli releases finalize 2.4.0. Er bestätigt jeden Schritt und meldet die Gesamtanzahl der hochgeladenen Dateien.

2. Aktuelle Fehler nach einem Deploy prüfen

Du: "Zeige mir die ungelösten Probleme der letzten 24 Stunden in unserem Frontend-Projekt, sortiert nach Häufigkeit."

Der Agent fragt Sentry nach aktuellen ungelösten Problemen ab, filtert nach dem angegebenen Projekt und Zeitfenster und gibt eine Übersichtstabelle mit Problemtiteln, Ereignisanzahlen, betroffenen Benutzern und Links zu jedem Problem im Sentry-Dashboard zurück.

3. Deployment registrieren

Du: "Registriere ein Produktions-Deployment für Release 2.4.0."

Der Agent führt sentry-cli releases deploys 2.4.0 new -e production aus, um das Deployment zu registrieren. Sentry verfolgt dann die Fehlerraten vor und nach diesem Deployment und ermöglicht so die Überwachung des Deploy-Zustands im Sentry-Dashboard.

4. Cron-Job überwachen

Du: "Richte eine Sentry-Überwachung für unser nächtliches Datenbank-Backup-Skript ein, das um 2 Uhr morgens läuft."

Der Agent umschließt den Backup-Befehl mit sentry-cli monitors run und konfiguriert ihn so, dass Check-ins an Sentry Crons gemeldet werden. Wenn der Job fehlschlägt oder seinen Zeitplan verfehlt, sendet Sentry eine Benachrichtigung.

Sicherheit und Best Practices

Der Sentry CLI Skill interagiert mit Ihren Fehlerüberwachungsdaten und Ihrer Release-Pipeline. Befolgen Sie diese Richtlinien für einen sicheren Umgang:

• Verwenden Sie Organisations-Tokens statt persönlicher Tokens. Organisations-Tokens sind auf eine einzelne Organisation beschränkt und können unabhängig widerrufen werden, ohne Ihren persönlichen Zugang zu beeinträchtigen.
• Gewähren Sie minimale Berechtigungen. Für schreibgeschützte Überwachung reichen org:read und project:read aus. Fügen Sie project:releases und project:write nur hinzu, wenn Sie Release-Verwaltung benötigen.
• Rotieren Sie Tokens regelmäßig. Setzen Sie ein Ablaufdatum für Auth-Tokens und rotieren Sie sie mindestens alle 90 Tage.
• Schützen Sie sensible Fehlerdaten. Sentry-Probleme können personenbezogene Daten, Stack-Traces oder Umgebungsdetails enthalten. Seien Sie vorsichtig beim Teilen von Zusammenfassungen oder Protokollen, die vom Agent generiert wurden.
• Verwenden Sie .sentryclirc mit Vorsicht. Wenn Sie eine Konfigurationsdatei verwenden, stellen Sie sicher, dass sie in .gitignore steht und nicht in die Versionskontrolle übertragen wird.
• Überprüfen Sie Release-Aktionen vor der Bestätigung. Verifizieren Sie immer die Release-Version und das Zielprojekt, bevor Sie einen Release finalisieren oder Source Maps hochladen, um eine Veröffentlichung im falschen Projekt zu vermeiden.

Fehlerbehebung Häufiger Probleme

"error: API request failed — 401 Unauthorized"

Ihr Auth-Token fehlt, ist abgelaufen oder verfügt nicht über die erforderlichen Berechtigungen.

1. Überprüfen Sie die Authentifizierung mit sentry-cli info.
2. Stellen Sie sicher, dass SENTRY_AUTH_TOKEN in Ihrer Umgebung gesetzt ist.
3. Bestätigen Sie, dass der Token die notwendigen Berechtigungen unter sentry.io/settings/auth-tokens hat.

# Schnelle Authentifizierungsprüfung
sentry-cli info

"error: Could not find organization"

Der Organisations-Slug stimmt nicht mit Ihrem Sentry-Konto überein, oder der Token hat keinen Zugriff auf diese Organisation.

1. Überprüfen Sie den Organisations-Slug mit sentry-cli organizations list.
2. Stellen Sie sicher, dass SENTRY_ORG mit einer Organisation übereinstimmt, auf die Ihr Token Zugriff hat.
3. Stellen Sie bei selbst gehosteten Instanzen sicher, dass SENTRY_URL auf den richtigen Server zeigt.

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

Die Source-Map-Dateien fehlen im Upload-Verzeichnis, oder der Pfad ist falsch.

1. Bestätigen Sie, dass das Build-Ausgabeverzeichnis .map-Dateien enthält.
2. Überprüfen Sie, ob Ihr Build-Tool für die Generierung von Source Maps konfiguriert ist.
3. Verwenden Sie einen absoluten Pfad oder überprüfen Sie den relativen Pfad von Ihrem aktuellen Arbeitsverzeichnis.

# Dateien im Build-Verzeichnis auflisten zur Überprüfung
ls -la ./dist/*.map