OpenClaw向け Sentry CLI スキル

OpenClaw Sentry CLI スキル概要

Sentry CLI スキルは、OpenClawを公式のsentry-cliツールを通じてSentry（業界をリードするエラーモニタリングおよびパフォーマンス追跡プラットフォーム）に接続します。インストール後、OpenClawエージェントはリリースの管理、ソースマップのアップロード、イシューの照会、デプロイメントの登録、cronジョブの監視を自然言語で行えるようになります。

エラーモニタリングは本番アプリケーションにとって不可欠ですが、リリース管理やイシューのデバッグには繰り返しのCLIコマンドが伴うことが多いです。OpenClaw Sentry CLIスキルはこのワークフローを効率化します。sentry-cli releasesのサブコマンドを覚えたり、ビルドのたびに手動でソースマップをアップロードする代わりに、必要なことを説明するだけでエージェントが残りを処理します。

一般的なワークフロー：

1. ビルド後にOpenClawに新しいリリースの作成とソースマップのアップロードを依頼します。
2. エージェントがsentry-cli releases newを実行し、マップをアップロードして、リリースを完了します。
3. リリースバージョンとアップロードステータスを含む確認サマリーが表示されます — 手動の手順は不要です。

Sentry CLI スキルの前提条件

Sentry CLIスキルをインストールする前に、以下を確認してください：

• OpenClawがインストール済みで稼働中であること（v1.0以上）
• Sentry CLIがインストール済みであること — インストールガイド
• 管理対象のプロジェクトにアクセスできるSentryアカウント
• 適切なスコープを持つSentry認証トークン
• スキル管理用のclawhub CLIがインストール済みであること

セットアップを確認します：

# OpenClawのバージョンを確認
openclaw --version

# Sentry CLIのバージョンを確認
sentry-cli --version

# Sentry認証を検証
sentry-cli info

Sentry CLIのインストール

お使いの環境に合った方法を選択してください：

# macOS / Linux（自動インストーラー）
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

Sentry CLI スキルのインストール方法

Sentry CLIスキルを1つのコマンドでインストールします：

npx clawhub@latest install sentry-cli

インストールを確認するには：

clawhub list

インストール済みスキルのリストにsentry-cliが表示されるはずです。インストール前にclawhub inspect sentry-cliでスキルをプレビューできます。

Sentry CLI スキルの設定

Sentry CLIスキルがSentry APIと通信するには、認証トークンが必要です。組織トークン（CI/CDに推奨）または個人認証トークンを使用できます。

認証トークンの作成

1. sentry.io/settings/auth-tokensにアクセスして新しいトークンを作成します。
2. リリース管理とソースマップのアップロードには、以下のスコープを付与してください：

| スコープ | 用途 | |-------|---------| | project:releases | リリースの作成と管理 | | org:read | 組織データの読み取り | | project:read | プロジェクト情報の読み取り | | project:write | ソースマップとデバッグファイルのアップロード |

環境設定

# Sentry認証トークンを設定
export SENTRY_AUTH_TOKEN=sntrys_your_token_here

# 組織とプロジェクトを設定（任意、コマンドごとのフラグ指定を省略可能）
export SENTRY_ORG=your-org-slug
export SENTRY_PROJECT=your-project-slug

# セルフホスト型Sentryインスタンスの場合
export SENTRY_URL=https://sentry.your-company.com/

重要： トークンを設定ファイルにハードコードしないでください。環境変数または1Passwordなどのシークレットマネージャーを使用してください。トークンのスコープは必要最小限の権限に設定し、可能な場合は個人トークンよりも組織トークンを使用してください。

Sentry CLI スキルの使用例

1. デプロイ後にリリースを作成

あなた：「バージョン2.4.0の新しいSentryリリースを作成して、前回のリリースからのコミットを含め、./distフォルダからソースマップをアップロードし、完了してください。」

エージェントは一連のコマンドを実行します：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、そしてsentry-cli releases finalize 2.4.0。各ステップを確認し、アップロードされたファイルの総数を報告します。

2. デプロイ後の最近のエラーを確認

あなた：「フロントエンドプロジェクトの過去24時間の未解決イシューを、発生頻度順に表示してください。」

エージェントはSentryに最近の未解決イシューを照会し、指定されたプロジェクトと時間範囲でフィルタリングして、イシューのタイトル、イベント数、影響を受けたユーザー数、Sentryダッシュボードの各イシューへのリンクを含むサマリーテーブルを返します。

3. デプロイメントの登録

あなた：「リリース2.4.0の本番デプロイメントを登録してください。」

エージェントはsentry-cli releases deploys 2.4.0 new -e productionを実行してデプロイを登録します。Sentryはこのデプロイメント前後のエラー率を追跡し、Sentryダッシュボードでデプロイヘルスの監視を可能にします。

4. cronジョブの監視

あなた：「毎晩午前2時に実行されるデータベースバックアップスクリプトのSentryモニタリングを設定してください。」

エージェントはバックアップコマンドをsentry-cli monitors runでラップし、Sentry Cronsにチェックインを報告するように設定します。ジョブが失敗したりスケジュールを逃した場合、Sentryがアラートを送信します。

セキュリティとベストプラクティス

Sentry CLIスキルはエラーモニタリングデータとリリースパイプラインにアクセスします。安全に使用するために以下のガイドラインに従ってください：

• 個人トークンよりも組織トークンを使用してください。 組織トークンは単一の組織にスコープされ、個人アクセスに影響を与えずに個別に失効させることができます。
• 必要最小限のスコープを付与してください。 読み取り専用の監視にはorg:readとproject:readで十分です。リリース管理が必要な場合のみproject:releasesとproject:writeを追加してください。
• トークンを定期的にローテーションしてください。 認証トークンに有効期限を設定し、少なくとも90日ごとにローテーションしてください。
• 機密性の高いエラーデータを保護してください。 Sentryのイシューには個人情報、スタックトレース、環境の詳細が含まれる場合があります。エージェントが生成したサマリーやログを共有する際は注意してください。
• .sentryclircの取り扱いに注意してください。 設定ファイルを使用する場合は、.gitignoreに含め、バージョン管理にコミットしないようにしてください。
• 確認前にリリースアクションを確認してください。 リリースの完了やソースマップのアップロード前に、リリースバージョンと対象プロジェクトを必ず確認し、誤ったプロジェクトへの公開を防いでください。

よくあるエラーのトラブルシューティング

"error: API request failed — 401 Unauthorized"

認証トークンが未設定、有効期限切れ、または必要なスコープが不足しています。

1. sentry-cli infoで認証を確認してください。
2. 環境にSENTRY_AUTH_TOKENが設定されていることを確認してください。
3. sentry.io/settings/auth-tokensでトークンに必要なスコープがあることを確認してください。

# 認証の簡易チェック
sentry-cli info

"error: Could not find organization"

組織スラッグがSentryアカウントと一致しないか、トークンにその組織へのアクセス権がありません。

1. sentry-cli organizations listで組織スラッグを確認してください。
2. SENTRY_ORGがトークンでアクセス可能な組織と一致していることを確認してください。
3. セルフホスト型インスタンスの場合、SENTRY_URLが正しいサーバーを指していることを確認してください。

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

ソースマップファイルがアップロードディレクトリに存在しないか、パスが正しくありません。

1. ビルド出力ディレクトリに.mapファイルが含まれていることを確認してください。
2. ビルドツールがソースマップを生成するように設定されていることを確認してください。
3. 絶対パスを使用するか、現在の作業ディレクトリからの相対パスを確認してください。

# ビルドディレクトリのファイルを一覧表示して確認
ls -la ./dist/*.map