Openclaw向けGitHub CLI

gh CLIを使用して、PRチェック、ランナーログ、カスタムAPIクエリなどのGitHub操作を実行するための高性能なOpenclaw Skills統合です。

khurramjamil12
v1.0.0
Jun 16, 2026
0
510
0

インストール&ダウンロード

1. ClawHub CLI

レジストリから直接スキルをインストールする最速の方法です。

npx clawhub@latest install github-1

2. 手動インストール

スキルフォルダを以下のいずれかの場所にコピーしてください

グローバル
~/.openclaw/skills/
ワークスペース
<project>/skills/

優先順位:ワークスペース > ローカル > バンドル

3. プロンプトのインストール

このプロンプトをOpenClawにコピーするだけで、自動的にインストールされます。

Clawhubを使って github-1 をインストールして。Clawhubがインストールされていない場合は、先にインストールしてください(npm i -g clawhub)。

ダウンロードをご希望ですか?

ZIPアーカイブで生のスキルファイルを取得します。

GitHub CLI とは?

GitHub CLI skillは、AIコーディングエージェントがターミナルから離れることなくGitHubリポジトリと直接対話できるようにします。公式の gh CLIツールを活用することで、このスキルはpull requests、issues、GitHub Actionsワークフロー実行のシームレスな管理を実現します。これは、現代のOpenclaw Skills構成に不可欠な機能である、CIステータスの確認やリポジトリメタデータの取得を行うための、自動化された開発パイプラインの架け橋として機能します。

ローカルのgitリポジトリ内で実行する場合でも、対象リポジトリを明示的に指定してリモートクエリを実行する場合でも、このスキルは堅牢なコマンドラインファーストのインターフェースを提供します。開発者や自動化エージェントは、複雑なクエリの実行、カスタムJSON/jqセレクターによる出力のフィルタリング、CI/CD障害のリアルタイムデバッグが可能となり、ソフトウェア開発ライフサイクル全体が効率化されます。

GitHub CLI のユースケース

  • 特定のpull requestsの継続的インテグレーション(CI)ステータスの確認。
  • 失敗したワークフロー実行およびactionsログの監視、一覧表示、デバッグ。
  • 高度なJQフィルタリングを使用したGitHub APIからの複雑なリポジトリデータの直接クエリ。
  • 自動化されたJSON出力パースによるリポジトリissuesの管理と一覧表示。
  • ローカルのgitコンテキストおよびリモートのマルチリポジトリ設定全体での開発ワークフローの標準化。

GitHub CLI の仕組み

  1. コマンドの初期化: エージェントがGitHub CLIコマンド(例: gh pr, gh issue, gh run または gh api)をトリガーします。
  2. コンテキスト解決: ツールはローカルのgitディレクトリ内で実行されているかを確認します。そうでない場合は、明示的に指定された --repo owner/repo フラグを適用します。
  3. APIとCLIの実行: スキルはGitHubバックエンドと通信して要求されたリソースを取得するか、リポジトリイベントをトリガーします。
  4. 出力のパースとフィルタリング: スキルは構造化された --json 形式と --jq フィルタを活用して、正確なフィールド(PRステータスやissueタイトルなど)を抽出します。
  5. 結果の配信: クリーンで構造化されたメタデータやログ出力が、呼び出し元のエージェントやユーザー環境に返されます。

GitHub CLI のセットアップ

前提条件

公式のGitHub CLI (gh)がローカルマシンにインストールされ、認証されていることを確認してください。

# GitHub CLIのインストール (macOSの例)
brew install gh

# GitHubアカウントの認証
gh auth login

スキルの有効化

Openclaw Skillsワークスペースの設定にGitHubスキルの設定を追加してください。構成が完了すると、インタラクティブなコマンドを直接使用できるようになります。

# リポジトリをクエリしてインストールをテスト
gh repo view --repo owner/repo

GitHub CLI のデータスキーマとタクソノミー

構造化されたJSON出力スキーマ

Openclaw Skillsで --json および --jq フラグを使用する場合、基盤となるデータ構造は公式のGitHub APIペイロードスキーマと直接一致します。以下は、一般的な戻りスキーマの内訳です。

コマンドタイプ サポートされている主要フィールド JQクエリの例
Pull Requests (gh pr) number, title, state, author .[] | .title
Workflow Runs (gh run) id, name, status, conclusion .workflow_runs[] | .id
Issues (gh issue) number, title, state, labels .[] | .title
GitHub API (gh api) カスタマイズ可能な動的ペイロード .title, .state

構造化されたクエリの応答はすべてJSON形式で出力されるため、自動化パイプラインへの取り込みが容易です。

GitHub CLI の高度な機能

  • きめ細やかなCI/CDのトラブルシューティング: ワークフロー実行ビューで --log-failed フラグを使用すると、失敗したステップのログのみを即座に分離・取得でき、帯域幅と画面のノイズを最小限に抑えられます。
  • GitHub API直接統合: gh api を使用して標準のCLI制限を回避し、複雑なリポジトリメタデータの取得のためにRESTおよびGraphQLクエリを直接実行します。
  • 高度なデータプロジェクション: 結合された --json とカスタムJQフィルタを活用して、ネストされたAPI応答をCLI内で直接フラット化し、最適化された形式に変換します。
  • コンテキスト非依存の実行: 明示的な --repo フラグの上書きをサポートし、物理的なgitクローンを必要とせずに、複数のリモートリポジトリにまたがって自動化ワークフローを拡張できます。

SKILL.md


ローディング

関連するOpenclawのスキル

特徴*