まだ OpenClaw をインストールしていませんか?
パソコンへの影響が心配?ClawTank なら60秒でクラウドデプロイ、ファイルへのリスクゼロ。
OpenClaw はサーバー上で24時間365日動作し、Telegram を通じてコミュニケーションする AI アシスタントです。OpenClaw GitHub 連携により、Issue のトリアージ、プルリクエストの要約、CI/CD パイプラインの監視、リリースの管理、注意が必要な場合のアラート通知が可能な完全な GitHub 自動化ツールになります。すべて自然言語で、すべてスマートフォンから操作できます。
このガイドでは、OpenClaw を GitHub に接続する方法、連携の設定、反復的なリポジトリ管理を排除するワークフローの構築まで、すべてのステップを解説します。
なぜ OpenClaw で GitHub を自動化するのか?
ほとんどの GitHub 自動化は、要件が変わると壊れる厳格な YAML ワークフローに依存しています。OpenClaw は異なるアプローチを取ります。自然言語を理解するため、やりたいことを平易な日本語で記述すれば、GitHub API の呼び出し、Webhook の処理、Telegram 通知を処理します。
OpenClaw GitHub 自動化の実際の使用例:
- 午前2時に新しい Issue が作成されます。OpenClaw がそれを読み、適切なラベルを付け、優先度を割り当て、起床時には Telegram に要約が届いています。
- 1,200行の変更を含む PR が提出されます。OpenClaw はサイズが大きすぎることを指摘し、分割を提案するコメントを投稿し、差分の要約を送信します。
- main ブランチで CI パイプラインが失敗します。OpenClaw がログを取得し、失敗したステップを特定し、エラーと直接リンク付きのメッセージを送ります。
YAML ファイル不要。Webhook の配線不要。OpenClaw に何を監視し、どう対応するかを伝えるだけです。
前提条件
OpenClaw GitHub 連携をセットアップする前に、以下を用意してください:
- 実行中の OpenClaw インスタンス — セルフホストまたは ClawTank にデプロイ済み。OpenClaw が到達可能で Telegram アカウントに接続されている必要があります。
- GitHub アカウント — 自動化したいリポジトリへのアクセス権限。
- リポジトリ管理者アクセス(オプション)— OpenClaw に Webhook を直接管理させたい場合のみ必要。ポーリングベースのセットアップでは不要です。
- Telegram 接続済み — OpenClaw はすべてのアラートと要約を Telegram 経由で送信するため、ボットがペアリングされ応答していることを確認してください。
OpenClaw がまだ実行されていない場合、最速の方法は ClawTank にデプロイすることです。2分以内に動作するインスタンスが得られます。
ステップバイステップセットアップ:OpenClaw を GitHub に接続する
OpenClaw GitHub 連携セットアップは、MCP(Model Context Protocol)GitHub サーバープラグインを使用します。これは OpenClaw が外部サービスに接続する標準的な方法です。
ステップ1:GitHub MCP プラグインをインストールする
サーバーに SSH 接続(または ClawTank ターミナルを使用)して実行します:
openclaw plugins install @anthropic/mcp-github
これにより GitHub MCP サーバーがインストールされ、OpenClaw が GitHub API(リポジトリ、Issue、プルリクエスト、Actions など)にアクセスできるようになります。
ステップ2:GitHub パーソナルアクセストークンを作成する
GitHub Settings > Developer settings > Personal access tokens > Fine-grained tokens に移動します。
Generate new token をクリックして設定します:
- Token name:
openclaw-github(または説明的な名前)
- Expiration: 90日推奨(後でローテーション可能)
- Repository access: OpenClaw に管理させたい特定のリポジトリを選択、または組織全体の自動化のために「All repositories」を選択
- Permissions:
- Issues: Read and write
- Pull requests: Read and write
- Actions: Read-only
- Contents: Read-only
- Metadata: Read-only(デフォルトで付与)
Generate token をクリックしてトークン値をコピーしてください。再表示はできません。
ステップ3:OpenClaw GitHub トークンを設定する
MCP サーバー設定を通じて OpenClaw にトークンを渡します:
openclaw config set mcpServers.github.env.GITHUB_TOKEN "ghp_your_token_here"
その後、新しいプラグインを読み込むために OpenClaw を再起動します:
openclaw restart
ステップ4:接続を確認する
OpenClaw の Telegram ボットにメッセージを送信します:
List open issues on my-org/my-repo
すべてが正しく設定されていれば、OpenClaw が GitHub API に問い合わせ、Issue を取得し、フォーマットされたリストで応答します。認証エラーが出た場合は、トークンの権限が正しく、有効期限が切れていないか再確認してください。
ステップ5:自動監視をセットアップする(オプション)
手動クエリだけでなく、OpenClaw にリポジトリを継続的に監視させるには、何を監視するか指示します:
Watch my-org/my-repo for new issues and PRs. Send me a
Telegram summary for each one within 5 minutes of creation.
OpenClaw は定期的にリポジトリをポーリングし始め、新しいものがあればアラートを送信します。両方のアプローチの詳細は、以下の「Webhook vs ポーリング」セクションを参照してください。
Issue の自動化
OpenClaw GitHub 自動化の最も強力な活用法の一つは、ハンズフリーの Issue 管理です。新しい Issue を手動でトリアージする代わりに、OpenClaw がコンテンツを読み、ラベルを適用し、優先度を割り当て、情報を提供します。
新しい Issue の自動トリアージ
Watch my-org/my-repo for new issues. When one is created:
1. Read the issue title and body
2. Add appropriate labels (bug, feature, question, docs)
3. If it looks like a bug, add a priority label (p0, p1, p2)
based on severity keywords
4. If the issue mentions a specific component, assign it to
the relevant team member
5. Send me a Telegram summary with the label decisions
OpenClaw は自然言語理解を使用して各 Issue を分析するため、キーワードベースの自動化が見逃すもの(「bug」という単語を使わずにクラッシュを説明するユーザーなど)も検出できます。
古い Issue のクリーンアップ
Every Monday at 9 AM, find issues in my-org/my-repo with
no activity for 30 days. Post a comment asking if the issue
is still relevant. If there is still no response after 7
more days, close the issue with a polite note.
毎週手動で監査することなく、Issue トラッカーをきれいに保てます。
緊急 Issue アラート
When a new issue is opened with the 'urgent' or 'p0' label,
immediately send me a Telegram alert with the title, author,
and a one-paragraph summary of the issue body. Include a
direct link so I can respond from my phone.
重複検出
When a new issue is opened, check if a similar issue already
exists (by title and description similarity). If you find a
likely duplicate, post a comment linking to the original
issue and add the 'possible-duplicate' label.
プルリクエストワークフロー
OpenClaw の Git 連携は、プルリクエストの自動化を処理し、日常的なコードレビューの手間を削減します。
Telegram での PR レビュー要約
When a PR is opened on my-org/my-repo, read the full diff
and send me a Telegram summary with:
- What changed in 2-3 sentences
- Number of files and lines modified
- Potential concerns or breaking changes
- Whether tests were added or modified
- A direct link to the PR
複数のリポジトリを管理する場合に特に有用です。一日中 GitHub 通知をチェックする代わりに、簡潔な要約が Telegram に直接配信されます。
ファイルパスによる PR の自動ラベル付け
When a PR is opened, add labels based on the files changed:
- Changes in /src/api/ → 'backend'
- Changes in /src/components/ → 'frontend'
- Changes in /tests/ → 'tests'
- Changes in /*.md → 'docs'
- Changes in /infra/ → 'infrastructure'
- Changes in package.json or lockfiles → 'dependencies'
PR サイズ警告
If a PR has more than 500 lines changed, post a friendly
comment suggesting it be broken into smaller PRs for easier
review. Include the line count and a list of the logical
groupings you would suggest.
大きな PR はレビューが難しく、バグが混入しやすくなります。このやさしいナッジにより、チームの PR を管理しやすい状態に保てます。
レビューリマインダー
If a PR has been open for more than 48 hours with no review,
send me a Telegram reminder with the PR title, author, and
how long it has been waiting.
CI/CD 監視
OpenClaw GitHub 自動化ツールを使用して CI/CD パイプラインを監視し、インテリジェントな失敗分析を取得します。単なる「ビルド失敗」ではなく、なぜ失敗したか、何を確認すべきかの要約が得られます。
ビルド失敗アラート
Monitor GitHub Actions on my-org/my-repo. When a workflow
fails on the main branch:
1. Fetch the workflow run logs
2. Identify the failing step
3. Summarize the error in 2-3 sentences
4. Send me a Telegram alert with the summary, the commit
that triggered it, and a direct link to the failed run
デプロイメント追跡
When the 'deploy' workflow completes successfully on main,
send me a Telegram message with the commit message, author,
deployment duration, and a confirmation that production is
updated.
ワークフロー所要時間追跡
Track how long CI workflow runs take on my-org/my-repo.
Every Friday afternoon, send me a summary:
- Average build time this week
- Slowest build (with link)
- Any builds that exceeded 10 minutes
- Week-over-week trend (faster or slower)
CI の速度低下を早期に検出することで、チーム全体のベロシティへの悪影響を防げます。
リリース管理
OpenClaw GitHub 連携でリリースの面倒な部分を自動化します。
リリースノートの自動生成
When I say 'release v1.2.3', do the following:
1. Find all PRs merged since the last GitHub release
2. Group them by label: Features, Bug Fixes, Docs, Other
3. Generate a formatted changelog
4. Create a GitHub release tagged v1.2.3 with the changelog
5. Send me the release URL on Telegram
バージョンバンプリマインダー
When 10 PRs have been merged since the last tagged release,
send me a Telegram message suggesting it might be time for
a new release. Include a count of features vs fixes merged.
プリリリースチェックリスト
Before I create a release, check:
- All CI workflows on main are passing
- No open PRs labeled 'release-blocker'
- No critical/p0 issues open
Report the results so I know if it is safe to ship.
マルチリポジトリワークフロー
複数のリポジトリを管理している場合、OpenClaw 自動化フレームワークは GitHub 組織全体にスケールします。
毎日のクロスリポジトリステータスレポート
Every morning at 8 AM, give me a status update across all
my repos:
- Open PRs awaiting my review
- Failed CI builds from the last 24 hours
- Issues assigned to me
- PRs I authored that are still open
Format it as a clean summary I can scan in 30 seconds.
組織ダッシュボード
List all repos in my-org with:
- Open PRs older than 7 days (title, author, days open)
- Failing CI on the default branch
- Issues with no assignee opened in the last week
クロスリポジトリ依存関係追跡
When a PR is merged in my-org/shared-lib, check if any
other repos in my-org depend on it. If they do, send me a
list of repos that may need to update their dependency.
上級編:Webhook vs ポーリング
OpenClaw が GitHub リポジトリを監視する方法は2つあります。違いを理解することで、セットアップに最適なアプローチを選択できます。
ポーリング(デフォルト)
OpenClaw は定期的に GitHub API にクエリを送信し、新しい Issue、PR、ワークフロー実行を確認します。これはデフォルトの動作で、トークン以外の追加設定は不要です。
メリット: セットアップが簡単、ファイアウォール内でも動作、パブリック URL 不要。
デメリット: わずかな遅延(ポーリング間隔により通常1〜5分)、API レート制限の消費。
Webhook
イベント発生時に GitHub が OpenClaw インスタンスに HTTP リクエストを送信します。ほぼリアルタイムの通知が可能です。
メリット: リアルタイムアラート、イベント検出に API レート制限を使用しない。
デメリット: パブリックにアクセス可能な URL が必要、追加設定が必要。
Webhook をセットアップするには、OpenClaw インスタンスがインターネットから到達可能である必要があります(ClawTank インスタンスはデフォルトで到達可能です)。OpenClaw に以下を指示します:
Set up a webhook for my-org/my-repo to receive push events,
issue events, and pull request events.
ほとんどのユーザーには、ポーリングが推奨される出発点です。1分未満の応答時間が必要な場合や API レート制限に達している場合は Webhook に切り替えてください。
セキュリティとトークン管理
OpenClaw GitHub トークンはリポジトリアクセスの鍵です。慎重に扱ってください。
最小権限の原則
ワークフローが実際に必要な権限のみを付与してください。監視とアラートのみ(書き込みなし)の場合は、以下の最小スコープを使用します:
- Issues: Read-only
- Pull requests: Read-only
- Actions: Read-only
- Contents: Read-only
OpenClaw に Issue の作成、コメントの投稿、ラベルの追加、リリースの管理をさせたい場合のみ、書き込み権限を追加してください。
トークンのローテーション
GitHub トークンは定期的にローテーションしてください。90日ごとが良いベースラインです。更新方法:
openclaw config set mcpServers.github.env.GITHUB_TOKEN "ghp_new_token"
openclaw restart
リポジトリの Issue 一覧を OpenClaw に問い合わせて、新しいトークンが機能することを確認してください。
細粒度トークン vs クラシックトークン
常に細粒度パーソナルアクセストークン(クラシックトークンではなく)を使用してください。細粒度トークンでは以下が可能です:
- 全体的なアクセスではなく、特定のリポジトリへのアクセスを制限
- リソースタイプごとにきめ細かい権限を設定
- 有効期限を設定
- GitHub の監査ログでトークン使用状況を確認
環境変数でのシークレット管理
OpenClaw GitHub トークンは、OpenClaw の MCP サーバー設定に保存され、コミットするソースコードや設定ファイルには含まれません。セルフホスティングの場合、サーバーのファイルシステムパーミッションが、権限のないユーザーが OpenClaw 設定ディレクトリを読み取れないようにしてください。
トラブルシューティング
OpenClaw GitHub 連携のセットアップまたは実行時によくある問題とその修正方法です。
「Authentication Failed」または 401 エラー
- トークンの有効期限切れ: 細粒度トークンには有効期限があります。新しいトークンを生成し、
openclaw config set で更新してください。
- トークンが取り消された: GitHub Settings > Personal access tokens でトークンがまだアクティブか確認してください。
- トークン形式の間違い:
ghp_ で始まるフルトークン文字列を使用していることを確認してください。
「Resource Not Accessible」または 403 エラー
- 権限不足: トークンに必要なスコープがありません。GitHub でトークンの権限を編集し、OpenClaw を再起動してください。
- リポジトリが含まれていない: トークン作成時に特定のリポジトリを選択した場合、クエリしようとしているリポジトリがそのリストに含まれていることを確認してください。
API レート制限の超過(429 エラー)
- GitHub は認証済みトークンに1時間あたり5,000リクエストを許可しています。短いポーリング間隔で多くのリポジトリを監視すると、この制限に達する可能性があります。
- 修正方法: ポーリング間隔を延長、監視するリポジトリ数を減らす、またはトラフィックの多いリポジトリには Webhook に切り替えてください。
OpenClaw が GitHub クエリに応答しない
- プラグインがインストールされていない:
openclaw plugins list を実行して GitHub MCP プラグインがインストールされていることを確認してください。
- 再起動が必要: 設定変更後は必ず
openclaw restart を実行してください。
- Telegram が接続されていない: GitHub クエリをテストする前に、Telegram ボットがペアリングされ応答していることを確認してください。
Webhook イベントが届かない
- URL に到達できない: OpenClaw インスタンスがインターネットからアクセス可能である必要があります。外部マシンから
curl でテストしてください。
- イベントタイプが間違っている: GitHub の Webhook 設定で必要なイベントが選択されていることを確認してください。
- ペイロード署名の不一致: Webhook シークレットを設定した場合、両側で一致していることを確認してください。
よくある質問
OpenClaw を GitHub にどう接続しますか?
openclaw plugins install @anthropic/mcp-github で GitHub MCP プラグインをインストールし、GitHub で細粒度パーソナルアクセストークンを作成し、openclaw config set mcpServers.github.env.GITHUB_TOKEN で OpenClaw 設定に追加し、再起動します。全プロセスは5分以内で完了します。
OpenClaw にはリポジトリへの書き込みアクセスが必要ですか?
いいえ。監視とアラートには読み取り専用アクセスで十分です。ラベルの追加、コメントの投稿、Issue の作成、リリースの管理を OpenClaw に行わせたい場合のみ書き込み権限が必要です。
OpenClaw は複数の GitHub リポジトリを監視できますか?
はい。トークンがアクセスできるリポジトリであれば何個でも監視できます。OpenClaw にどのリポジトリを監視するか伝えると、すべてのリポジトリの Issue、PR、CI を追跡します。組織全体の監視には、組織のすべてのリポジトリへのアクセスをトークンに付与してください。
OpenClaw の GitHub トークンはどう更新しますか?
openclaw config set mcpServers.github.env.GITHUB_TOKEN "ghp_new_token" の後に openclaw restart を実行してください。新しいトークンは再起動後すぐに有効になります。
OpenClaw は GitHub Enterprise で動作しますか?
はい。GitHub MCP プラグインは GitHub Enterprise Server インスタンスをサポートしています。トークンに加えて API ベース URL の設定が必要です。Enterprise 固有の設定については OpenClaw にヘルプを求めてください。
OpenClaw と GitHub Actions の違いは何ですか?
GitHub Actions は CI/CD プラットフォームで、ビルドスクリプト、テスト、デプロイメントパイプラインを実行します。OpenClaw はリポジトリを理解し Telegram を通じてコミュニケーションする AI アシスタントです。両者は補完関係にあります。OpenClaw は GitHub Actions ワークフローを監視し、失敗を要約してアラートを送信できますが、CI/CD パイプラインを置き換えるものではありません。OpenClaw は既存の GitHub セットアップの上にあるインテリジェントレイヤーと考えてください。
OpenClaw GitHub 連携を始める
ClawTank で OpenClaw をデプロイし、GitHub プラグインをインストールすれば、AI 搭載の GitHub 自動化ツールが数分で稼働します。CI パイプラインの監視、Issue のトリアージ、プルリクエストの要約、リリースの管理、すべて Telegram から、すべて自然言語で操作できます。
ClawTank にデプロイして、今すぐ OpenClaw を GitHub に接続しましょう。