Providers

GitHub Copilot

GitHub Copilot は GitHub の AI コーディングアシスタントです。GitHub アカウントとプランで利用可能な Copilot モデルへのアクセスを提供します。OpenClaw では、Copilot をモデル プロバイダーまたはエージェントランタイムとして、3 つの異なる方法で使用できます。

OpenClaw で Copilot を使用する 3 つの方法

組み込みプロバイダー(github-copilot)

ネイティブのデバイスログインフローを使用して GitHub トークンを取得し、OpenClaw の実行時に Copilot API トークンと交換します。VS Code を必要としないため、これはデフォルトかつ最も簡単な方法です。

  • ログインコマンドを実行する

    bash
    openclaw models auth login-github-copilot

    URL にアクセスしてワンタイムコードを入力するよう求められます。完了するまで ターミナルを開いたままにしてください。

  • デフォルトモデルを設定する

    bash
    openclaw models set github-copilot/claude-opus-4.7

    または設定ファイルで指定します。

    json5
    {  agents: {    defaults: { model: { primary: "github-copilot/claude-opus-4.7" } },  },}
  • Copilot SDK ハーネス Plugin(copilot)

    選択した github-copilot/* モデルについて、GitHub の Copilot CLI と SDK に低レベルのエージェントループを管理させる場合は、外部の @openclaw/copilot Plugin をインストールします。

    bash
    openclaw plugins install @openclaw/copilot

    次に、モデルまたはプロバイダーでこのランタイムの使用を明示的に有効にします。

    json5
    {  agents: {    defaults: {      model: "github-copilot/gpt-5.5",      models: {        "github-copilot/gpt-5.5": {          agentRuntime: { id: "copilot" },        },      },    },  },}

    これらのエージェントターンで、ネイティブの Copilot CLI セッション、SDK が管理するスレッド 状態、および Copilot が管理する Compaction を使用する場合に選択してください。明示的な agentRuntime オプトインがなければ、github-copilot/* モデルは引き続き 組み込みプロバイダーを使用します。ランタイムの完全な契約については、Copilot SDK ハーネスを参照してください。

    Copilot Proxy Plugin(copilot-proxy)

    Copilot Proxy VS Code 拡張機能をローカルブリッジとして使用します。OpenClaw は プロキシの /v1 エンドポイント(デフォルトは http://localhost:3000/v1)と通信し、設定した モデルリストを使用します。

    copilot-proxy Plugin は OpenClaw に同梱されており、デフォルトで有効です。 次のコマンドでベース URL とモデル ID を設定します。

    bash
    openclaw models auth login --provider copilot-proxy --set-default

    GitHub Enterprise(データ所在地)

    組織がデータ所在地対応の GitHub Enterprise テナント( your-org.ghe.com などの *.ghe.com ホスト)を使用している場合、Copilot は公開 github.com ではなく、テナントローカルのエンドポイント上にあります。OpenClaw ではこれを 正式な認証選択肢として提供しているため、URL を手動で編集する必要はありません。

  • Enterprise の認証選択肢を選ぶ

    オンボーディングまたは openclaw models auth で、 GitHub Copilot (Enterprise / data residency) を選択します。Enterprise ドメイン (例: your-org.ghe.com)の入力を求められ、その後、そのテナントに対してデバイス ログインが実行されます。

    テナントルート(your-org.ghe.com)のみを入力してください。api.your-org.ghe.comcopilot-api.your-org.ghe.com などの派生サービスホストは使用できません。 OpenClaw がテナントルートからこれらのエンドポイントを自動的に導出します。

    bash
    openclaw models auth login --provider github-copilot --method device-enterprise
  • ドメインを設定に永続化する

    選択したホストはプロバイダーのパラメーターに保存されるため、以降のトークン更新と 補完は自動的にそのテナントを対象とします。

    json5
    {  models: {    providers: {      "github-copilot": { params: { githubDomain: "your-org.ghe.com" } },    },  },}
  • デバイスフロー、トークン交換、補完は、それぞれ https://your-org.ghe.com/login/device/codehttps://api.your-org.ghe.com/copilot_internal/v2/tokenhttps://copilot-api.your-org.ghe.com に解決されます。データ所在地対応トークンには テナントスタンプが含まれ、プロキシヒントは含まれないため、補完のベース URL は公開エンドポイントではなく テナントの Copilot ホストにフォールバックします。

    オプションのフラグ

    コマンド フラグ 説明
    openclaw models auth login-github-copilot --yes 確認せずに既存の認証プロファイルを上書きする
    openclaw models auth login --provider github-copilot --method device --set-default プロバイダーが推奨するデフォルトモデルも適用する
    bash
    # 再ログインの確認をスキップopenclaw models auth login-github-copilot --yes # 1 回の操作でログインしてデフォルトモデルを設定openclaw models auth login --provider github-copilot --method device --set-default

    非対話型オンボーディング

    デバイスログインフローには対話型 TTY が必要です。ヘッドレス環境でセットアップするには、 既存の GitHub OAuth アクセストークンを openclaw onboard --non-interactive でインポートします。

    bash
    openclaw onboard --non-interactive --accept-risk \  --auth-choice github-copilot \  --github-copilot-token "$COPILOT_GITHUB_TOKEN" \  --skip-channels --skip-health

    --auth-choice を省略することもできます。--github-copilot-token を渡すと、 GitHub Copilot プロバイダーの認証選択肢が推論されます。このフラグを省略すると、オンボーディングは COPILOT_GITHUB_TOKENGH_TOKENGITHUB_TOKEN の順にフォールバックします。 COPILOT_GITHUB_TOKEN を設定した状態で --secret-input-mode ref を使用すると、 auth-profiles.json にプレーンテキストで保存する代わりに、環境変数を参照する tokenRef を保存できます。

    対話型 TTY が必要

    デバイスログインフローには対話型 TTY が必要です。非対話型スクリプトや CI パイプラインではなく、 ターミナルで直接実行してください。

    利用可能なモデルはプランに依存

    利用可能な Copilot モデルは GitHub プランによって異なります。モデルが 拒否された場合は、別の ID(例: github-copilot/gpt-5.5)を試してください。現在のモデル一覧については、 GitHub の Copilot プランごとの対応モデル を参照してください。

    Copilot API からライブカタログを更新

    デバイスログイン(または環境変数)による認証パスで GitHub トークンが解決されると、 OpenClaw は必要に応じて ${baseUrl}/models(VS Code Copilot が使用するものと同じエンドポイント)から モデルカタログを更新します。これにより、マニフェストを頻繁に変更することなく、 ランタイムがアカウントごとの利用資格と正確なコンテキストウィンドウを追跡できます。 新しく公開された Copilot モデルは OpenClaw をアップグレードしなくても表示されるようになり、 コンテキストウィンドウにはモデルごとの実際の上限(例: gpt-5.x シリーズでは 400k、 内部の claude-opus-*-1m バリアントでは 1M)が反映されます。

    検出が無効な場合、ユーザーに GitHub 認証プロファイルがない場合、トークン交換に 失敗した場合、または /models HTTPS 呼び出しでエラーが発生した場合は、 同梱の静的カタログが表示用のフォールバックとして維持されます。オプトアウトして、 静的なマニフェストカタログのみを使用するには(オフライン環境やエアギャップ環境)、 次のように設定します。

    json5
    {  plugins: {    entries: {      "github-copilot": {        config: { discovery: { enabled: false } },      },    },  },}
    トランスポートの選択

    Claude モデル ID では Anthropic Messages トランスポートが自動的に使用されます。 Gemini モデルでは OpenAI Chat Completions トランスポートが使用され、GPT および o-series モデルでは引き続き OpenAI Responses トランスポートが使用されます。OpenClaw はモデル参照に基づいて 適切なトランスポートを選択します。

    リクエストの互換性

    OpenClaw は Copilot トランスポートで Copilot IDE 形式のリクエストヘッダー (VS Code のエディター/Plugin バージョンと vscode-chat 統合 ID)を送信し、 ツール結果に続くターンをエージェント開始としてマークし、ターンに画像入力が含まれる場合は Copilot ビジョンヘッダーを設定します。

    環境変数の解決順序

    OpenClaw は次の優先順位で環境変数から Copilot 認証を解決します。

    優先順位 変数 備考
    1 COPILOT_GITHUB_TOKEN 最高優先度、Copilot 専用
    2 GH_TOKEN GitHub CLI トークン(フォールバック)
    3 GITHUB_TOKEN 標準 GitHub トークン(最低優先度)

    複数の変数が設定されている場合、OpenClaw は最も優先順位の高いものを使用します。 デバイスログインフロー(openclaw models auth login-github-copilot)では トークンが認証プロファイルストアに保存され、すべての環境変数より優先されます。

    トークンの保存

    ログインによって GitHub トークンが認証プロファイルストア(プロファイル ID github-copilot:github)に保存され、OpenClaw の実行時に有効期間の短い Copilot API トークンと交換されます。トークンを手動で管理する必要はありません。

    メモリ検索の埋め込み

    GitHub Copilot は、メモリ検索の埋め込みプロバイダーとしても使用できます。 Copilot サブスクリプションがあり、ログイン済みであれば、OpenClaw は別の API キーなしで Copilot を埋め込みに使用できます。

    設定

    GitHub Copilot の埋め込みを使用するには、memory.search.provider を明示的に設定します。 GitHub トークンを利用できる場合、OpenClaw は Copilot API から利用可能な埋め込みモデルを検出し、 最適なモデルを自動的に選択します。

    json5
    {  memory: {    search: {      provider: "github-copilot",      // オプション: 自動検出されたモデルを上書き      model: "text-embedding-3-small",    },  },}

    仕組み

    1. OpenClaw が GitHub トークンを解決します(環境変数または認証プロファイルから)。
    2. 有効期間の短い Copilot API トークンと交換します。
    3. Copilot の /models エンドポイントに問い合わせて、利用可能な埋め込みモデルを検出します。
    4. 最適なモデルを選択します(優先順位: text-embedding-3-smalltext-embedding-3-largetext-embedding-ada-002)。
    5. Copilot の /embeddings エンドポイントに埋め込みリクエストを送信します。

    利用可能なモデルは GitHub プランによって異なります。利用可能な埋め込みモデルがない場合、 OpenClaw は Copilot をスキップして次のプロバイダーを試します。

    関連項目

    Was this useful?
    On this page

    On this page