English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

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 clawhub:@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 が必要な場合に選択します。完全なランタイム契約については Copilot SDK ハーネスを参照してください。

    Copilot Proxy Plugin (copilot-proxy)

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

    任意のフラグ

    フラグ 説明
    --yes 確認プロンプトをスキップします
    --set-default プロバイダー推奨のデフォルトモデルも適用します
    bash
    # Skip confirmationopenclaw models auth login-github-copilot --yes # Login and set the default model in one stepopenclaw models auth login --provider github-copilot --method device --set-default

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

    Copilot 用の 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_TOKEN、GH_TOKEN、次に GITHUB_TOKEN にフォールバックします。 COPILOT_GITHUB_TOKEN を設定したうえで --secret-input-mode ref を使用すると、 平文ではなく環境変数に基づく tokenRef が auth-profiles.json に保存されます。

    対話型 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 トランスポートを自動的に使用します。GPT、 o-series、Gemini モデルは OpenAI Responses トランスポートを維持します。OpenClaw は モデル参照に基づいて正しいトランスポートを選択します。

    リクエスト互換性

    OpenClaw は、組み込み Compaction、ツール結果、画像フォローアップターンを含め、 Copilot トランスポートで Copilot IDE 形式のリクエストヘッダーを送信します。 その動作が Copilot の API に対して検証されていない限り、Copilot でプロバイダーレベルの Responses 継続は有効にしません。

    環境変数の解決順序

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

    優先度 変数 備考
    1 COPILOT_GITHUB_TOKEN 最優先、Copilot 固有
    2 GH_TOKEN GitHub CLI トークン（フォールバック）
    3 GITHUB_TOKEN 標準 GitHub トークン（最低）

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

    トークン保存

    ログインは GitHub トークンを認証プロファイルストアに保存し、OpenClaw の実行時に Copilot API トークンと交換します。トークンを手動で管理する必要はありません。

    メモリ検索埋め込み

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

    設定

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

    json5
    {  agents: {    defaults: {      memorySearch: {        provider: "github-copilot",        // Optional: override the auto-discovered model        model: "text-embedding-3-small",      },    },  },}

    仕組み

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

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

    関連

    モデル選択

    プロバイダー、モデル参照、フェイルオーバー動作の選択。
    OAuth と認証

    認証の詳細と資格情報の再利用ルール。
    Was this useful?
    On this page

    On this page