Git

git forge の issue および pull-request のコメントを通じてエージェントと会話し、PR ライフサイクル、レビューコメント、CI の結果、リリースを含むリポジトリイベントを、イベントごとのルーティングテーブルを通じて提示します。チャネルは provider seam を中心に構築されています。provider フィールドで forge を選択します。GitHub、Gitea、Forgejo は組み込みの provider です。追加の forge は、汎用チャネルを変更することなく、兄弟 provider としてドロップインできます。

ZeroClaw は初めてですか？ まずは クイックスタート でエージェントを起動し、次に コンセプト に目を通して、このページが前提とする用語（agent、peer group、autonomy、SOP）を確認してください。

GitHub プロバイダーでは、ZeroClaw は GitHub App として認証し、アプリ自身のボットアイデンティティ（your-app[bot]）として返信するため、アプリがインストールされている任意のリポジトリで動作します。個人アクセストークンや共有ユーザーアカウントは不要です。

Gitea/Forgejoプロバイダーを使用する場合、ZeroClawはパーソナルアクセストークンを使ってインスタンスのGitea互換APIに対して認証を行い、トークン所有者として応答します。

ビルドに関する注意: Git チャネルは標準の配布アーティファクトに含まれていますが、軽量な Cargo のデフォルトには含まれていません。カスタムソースビルドでは channel-git を追加する必要があります。デフォルト機能を無効にするビルドでは、agent-runtime も追加する必要があります。channel-git 機能には、接続されているすべての forge プロバイダーが取り込まれるため、1 つのバイナリですべてのサポート対象 forge に対応できます。プロバイダーごとに小さいビルドサブセットを選択することはできません。

エージェントと対話できるユーザー

受信側の送信者は、バインドされたエージェントに対して解決されたピアセットに照らして制御されます。これはエージェントが所属する peer_groups 設定から導出されます。照合では先頭の @ を取り除き、チャネルのネイティブな送信者識別子に対して大文字・小文字を区別せずに行われます。空のセットはすべてを拒否し、"*" を含むセットはすべてを受け入れます。それ以外の場合は、リストに記載された外部ピア（およびピアエージェント）のみが受け入れられます。これはゲートウェイのペアリング（gateway.require_pairing）とは別物であり、ペアリングはチャットチャネルの送信者ではなく HTTP/WebSocket クライアントを認証します。

git 用のピアグループは channel を git に設定し、external_peers に許可された送信者をリストし（git の場合、コメント作者の forge ユーザー名（ログイン）; ["*"] は誰でも受け入れます）、オプションでクロスエージェントディスパッチ用のピア agents、ignore ブロックリスト、および output_modality（mirror、voice、または text）を指定します。フィールドリファレンスについては Peer Groups を参照してください。

この設定の場所:

動作方法

• ポーリング、ウェブフックではない。 チャネルは since カーソルに基づき、新しいイシュー、プルリクエスト、コメントを forge の REST API に対してポーリングします。デーモンには公開 URL、トンネル、インバウンドの露出は不要であり、NAT の背後で動作します。
• Issue スコープの会話。 同じ Issue または PR 上のすべてのメッセージは1つの会話スレッドを共有し、エージェントはその Issue へのコメントとして返信します。
• ストリーミング返信。 エージェントは下書きコメントを投稿し、応答が成長するにつれてその場で編集します（編集は forge の悪用制限を守るため ≥ 2 秒間隔で行われます）。
• リアクション。 確認リアクションはフォージのリアクションセットにマッピングされます（GitHub の場合: 👀 → eyes、✅ → +1、⚠️ → confused、…）。マッピングできない絵文字はスキップされます。
• コールドスタート。 デーモン起動前に作成されたイベントは処理されないため、再起動しても履歴を再生できません。その反面、デーモンが停止している間に投稿されたコメントは見逃されるため、アプリを再度メンションしてください。
• コメントの編集は無視されます。 新しく作成されたコメントとイシュー/PR のオープニング投稿のみがエージェントをトリガーします。

認証情報

各プロバイダーは認証方法が異なり、それぞれに完全なステップバイステップのウォークスルーがあります:

• GitHub は GitHub App として認証します（App ID と生成された秘密鍵）。GitHub App の作成 を参照してください。
• Gitea / Forgejo は、パーソナルアクセストークンを使用してインスタンスの Gitea 互換 API に対して認証します。Gitea / Forgejo トークンの作成 (Codeberg) を参照してください。

設定

お好みのサーフェスでチャネルフィールドを設定します。

スキーマから直接取得した、完全なフィールドリファレンス:

zeroclaw config set channels.git.<alias>.access_token    # マスクされた入力、暗号化して保存

export ZEROCLAW_channels__git__<alias>__access_token=

zeroclaw config set channels.git.<alias>.api_base_url <value>

export ZEROCLAW_channels__git__<alias>__api_base_url=

zeroclaw config set channels.git.<alias>.app_id <value>

export ZEROCLAW_channels__git__<alias>__app_id=

zeroclaw config set channels.git.<alias>.events <value>

export ZEROCLAW_channels__git__<alias>__events=

zeroclaw config set channels.git.<alias>.events_backbone <value>

export ZEROCLAW_channels__git__<alias>__events_backbone=

zeroclaw config set channels.git.<alias>.excluded_tools <value>

export ZEROCLAW_channels__git__<alias>__excluded_tools=

zeroclaw config set channels.git.<alias>.installation_id <value>

export ZEROCLAW_channels__git__<alias>__installation_id=

zeroclaw config set channels.git.<alias>.listen_to_bots <value>

export ZEROCLAW_channels__git__<alias>__listen_to_bots=

zeroclaw config set channels.git.<alias>.mention_only <value>

export ZEROCLAW_channels__git__<alias>__mention_only=

zeroclaw config set channels.git.<alias>.poll_interval_secs <value>

export ZEROCLAW_channels__git__<alias>__poll_interval_secs=

zeroclaw config set channels.git.<alias>.private_key    # マスクされた入力、暗号化して保存

export ZEROCLAW_channels__git__<alias>__private_key=

zeroclaw config set channels.git.<alias>.private_key_path <value>

export ZEROCLAW_channels__git__<alias>__private_key_path=

zeroclaw config set channels.git.<alias>.provider <value>

export ZEROCLAW_channels__git__<alias>__provider=

zeroclaw config set channels.git.<alias>.proxy_url <value>

export ZEROCLAW_channels__git__<alias>__proxy_url=

zeroclaw config set channels.git.<alias>.repos <value>

export ZEROCLAW_channels__git__<alias>__repos=

default エイリアスは、通常最初に使用するインスタンスです。また、単発送信の解決先でもあります。zeroclaw channel send --channel-id git は特に default エイリアスを検索するため、すべての送信が異なる名前のエイリアスに紐付いたエージェントから行われるのでない限り、インスタンス名は default にしてください。repos を空のままにすると、認証情報から参照できるすべてのリポジトリがポーリングされます。レート使用量を抑えるには、明示的なリポジトリ一覧を設定してください。ほかのボットアカウントからのコメントを処理する場合にのみ listen_to_bots を設定してください。未知の provider 値は、暗黙のフォールバックではなく、明確な起動時エラーになります。

クレデンシャルのセットアップはプロバイダーごとに異なり、それぞれ独自の暗号化されたシークレットを持ちます。両方のウォークスルーがエンドツーエンドでそれをカバーしています:

• GitHub: App ID と秘密鍵。GitHub App の作成 を参照。
• Gitea / Forgejo: アクセストークンと API ベース URL。Gitea / Forgejo トークンの作成 (Codeberg) を参照。

イベントとルーティング

会話を超えて、チャネルはリポジトリのアクティビティを型付きイベントに正規化し、設定に従って各イベントタイプをルーティングします。イベントを sop にルーティングすると、トリガーマッチングと承認ゲートを備えた決定論的で監査可能な手順である Standard Operating Procedure にディスパッチされます。Git SOP fan-in ページでは、forge イベントが SOP 実行になる正確な仕組みが詳しく説明されています。

既知のイベントタイプ: issue_comment.created, issues.opened, pull_request.opened, pull_request.closed, pull_request.merged, pull_request_review_comment.created, workflow_run.completed, workflow_run.failed, release.published.

• デフォルト。 events テーブルがない場合、チャネルは会話的に動作します: issue_comment.created、issues.opened、および pull_request.opened はメッセージとして配信されます（上記のとおりメンションゲートされます）; それ以外はすべて無視されます。空でないテーブルに存在しないイベントタイプには、同じタイプごとのデフォルトが適用されます: workflow_run.failed をリストしても会話はオフになりません。message = true も sop もないエントリは、そのイベントタイプを明示的に無効化します。
• イベントタイプをルーティングすることは、それにサブスクライブすることです。 チャンネルはテーブルからポーリングする API エンドポイントを導出します。レビューコメント、リリース、Actions の実行は、それぞれのイベントタイプがルーティングされている場合にのみ取得されるため、未設定のチャンネルのコストは以前とまったく同じです。GitHub は現在、リストされているすべてのイベントタイプをカバーしています。Gitea/Forgejo プロバイダーは、issue コメント、issue/PR のオープン、PR のクローズ/マージ遷移、リリース、返信、編集、削除、リアクションをカバーします。
• sop ルーティング。 sop ルートは、トピック git.<alias>:<event_type> と構造化された JSON ペイロードを持つ、チャネル由来の SOP イベントを発行します。ルーティングされたイベントはチャットとして配信されるのではなく、SOP ingress によって消費されます。チャネルとインスタンスを指定する channel トリガー（channel = "git"、alias = "main"）を使用して SOP.toml でこれにマッチさせます。git.<alias>:<event_type> 文字列はチャネルによって生成されるイベントトピックであり、トリガーフィールドではありません。さらに絞り込むには、オプションの condition を使用します。例: $.event_type == "pull_request.opened" または $.repo == "octo/repo"。
• ルートごとのメンション ゲーティング。 mention_only ゲートは、メッセージパス上の会話イベントに適用されます。sop-routed イベントはこれをスキップします。pr-triage にルーティングされた PR は、作成者がアプリにメンションしたかどうかにかかわらずキャプチャされます。ライフサイクル/CI/リリース イベントにはメンション サーフェスがなく、ゲートされません。アプリ自身のアクティビティは常にドロップされます。他のボットのアクティビティは listen_to_bots に従います。すべての配信は、作成者のログインに対するピアグループ許可リストを通過します。
• 返信サーフェス。 コメント、issue、および PR イベントは、それぞれの issue/PR スレッドに返信します。Workflow-run イベントは、forge が関連する PR を報告した場合、その実行に関連付けられた PR に返信します。それ以外の場合、およびリリースについては、ターゲットはリポジトリそのものとなり、エージェントはプラットフォーム上で返信できません（それらを SOP にルーティングするか、他のツールを通じて対応してください）。
• Events API バックボーン（オプション、GitHub）。 events_backbone = true はさらに ETag 条件付きリクエストで /repos/{owner}/{repo}/events をポーリングします（リポジトリごとにティックあたり1リクエスト。アイドル状態のリポジトリは 304 を返し、コストはほぼゼロです）。注意点: フィードは最大約5分の遅延があり、ペイロードは削減されており、Actions イベントはここに現れません: ワークフロー実行は常に専用エンドポイントを使用します。フィードと対象エンドポイントの両方で表面化した内容は重複排除されるため、組み合わせても安全です。Gitea/Forgejo は現在このオプションを無視します。

運用上の注意

• レート予算: GitHub では、各インストールに 5,000 リクエスト/時間が付与されます。会話型のデフォルトはポーリングティックごとにリポジトリあたり 2 リクエストを消費します（30 秒間隔で 5 リポジトリ ≈ 1,200/時間）。追加でルーティングされる各エンドポイントファミリー（レビューコメント、リリース、Actions runs）はリポジトリあたりティックごとに 1 を追加し、Events API のバックボーンは 1 つの条件付きリクエストを追加します（アイドル状態のリポジトリでの 304s は実質的に無料です）。Gitea/Forgejo のレート制限はインスタンスに依存します。レート制限の応答時、チャネルは制限ウィンドウがリセットされるまでバックオフします。
• 多数のリポジトリ: repos が空で、認証情報が 100 を超えるリポジトリを参照できる場合、最初のページのみがポーリングされます（GitHub では警告がログに記録されます）。その場合は repos を明示的にリストしてください。

安全性

公開リポジトリの Issues および PR コメントは敵対的な入力です。mention_only = true を維持し、peer group で送信者をゲートしてください（空の peer セットは全員を拒否し、["*"] は誰でも受け入れます）。公開向けリポジトリでは autonomy を Supervised 以下に保ってください。これは social channels と同じガイダンスです。

関連ドキュメント

• 認証情報を設定する: GitHub App の作成 · Gitea / Forgejo トークンの作成 (Codeberg)
• エージェントに到達できるユーザー: ピアグループ
• エージェントが実行できること: セキュリティと自律性 · 自律性レベル
• イベント駆動自動化: 標準運用手順 · Git SOP ファンイン
• 全体像: エージェント · チャンネルの概要