Providers
GitHub Copilot
GitHub Copilot は GitHub の AI コーディングアシスタントです。GitHub アカウントとプランに応じた Copilot モデルへのアクセスを提供します。OpenClaw は Copilot をモデル provider として 2 つの方法で使用できます。
OpenClaw で Copilot を使用する 2 つの方法
組み込み provider (github-copilot)
ネイティブのデバイスログインフローを使って GitHub トークンを取得し、OpenClaw の実行時に Copilot API トークンと交換します。これは VS Code を必要としないため、デフォルトかつ最も簡単な方法です。
ログインコマンドを実行する
openclaw models auth login-github-copilotURL にアクセスしてワンタイムコードを入力するよう求められます。完了するまで ターミナルを開いたままにしてください。
デフォルトモデルを設定する
openclaw models set github-copilot/claude-opus-4.7または config で指定します。
{ agents: { defaults: { model: { primary: "github-copilot/claude-opus-4.7" } }, },}Copilot Proxy plugin (copilot-proxy)
Copilot Proxy VS Code 拡張機能をローカルブリッジとして使用します。OpenClaw は
プロキシの /v1 エンドポイントと通信し、そこで設定したモデルリストを使用します。
任意のフラグ
| フラグ | 説明 |
|---|---|
--yes |
確認プロンプトをスキップします |
--set-default |
provider が推奨するデフォルトモデルも適用します |
# 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 を使ったヘッドレスセットアップ中にインポートします。
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 provider の認証選択が推論されます。このフラグを省略した場合、オンボーディングは
COPILOT_GITHUB_TOKEN、GH_TOKEN、次に GITHUB_TOKEN にフォールバックします。
COPILOT_GITHUB_TOKEN を設定したうえで --secret-input-mode ref を使用すると、
auth-profiles.json に平文で保存する代わりに、環境変数に裏付けられた tokenRef を保存します。
対話型 TTY が必要
デバイスログインフローには対話型 TTY が必要です。非対話型スクリプトや CI パイプラインではなく、 ターミナルで直接実行してください。
モデルの利用可否はプランに依存します
Copilot モデルの利用可否は GitHub プランに依存します。モデルが
拒否された場合は、別の ID(例: github-copilot/gpt-4.1)を試してください。
Copilot API からのライブカタログ更新
デバイスログイン(または環境変数)認証パスで GitHub トークンを解決すると、
OpenClaw は ${baseUrl}/models(VS Code Copilot が使用するものと同じエンドポイント)
からオンデマンドでモデルカタログを更新します。これにより、ランタイムは
manifest の変更なしにアカウントごとの権限と正確なコンテキストウィンドウを追跡します。
新しく公開された Copilot モデルは OpenClaw のアップグレードなしで表示され、
コンテキストウィンドウは実際のモデルごとの制限を反映します
(例: gpt-5.x シリーズは 400k、内部
claude-opus-*-1m バリアントは 1M)。
探索が無効な場合、ユーザーに GitHub 認証プロファイルがない場合、トークン交換が
失敗した場合、または /models HTTPS 呼び出しでエラーが発生した場合、バンドルされた静的カタログが
表示されるフォールバックとして残ります。オプトアウトして静的 manifest カタログのみに依存するには
(オフライン / エアギャップ環境):
{ plugins: { entries: { "github-copilot": { config: { discovery: { enabled: false } }, }, }, },}トランスポートの選択
Claude モデル ID は Anthropic Messages トランスポートを自動的に使用します。GPT、 o-series、および Gemini モデルは OpenAI Responses トランスポートを維持します。OpenClaw は model ref に基づいて正しいトランスポートを選択します。
リクエスト互換性
OpenClaw は、組み込みの Compaction、ツール結果、画像フォローアップターンを含め、 Copilot トランスポートで Copilot IDE スタイルのリクエストヘッダーを送信します。 その挙動が Copilot の API に対して検証されていない限り、Copilot で provider レベルの 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 は memory search の埋め込み provider としても機能します。 Copilot サブスクリプションがあり、ログイン済みであれば、OpenClaw は別個の API キーなしで 埋め込みに使用できます。
自動検出
memorySearch.provider が "auto"(デフォルト)の場合、GitHub Copilot は
優先度 15 で試行されます -- ローカル埋め込みの後、OpenAI やその他の有料
provider の前です。GitHub トークンが利用可能な場合、OpenClaw は Copilot API から
利用可能な埋め込みモデルを検出し、最適なものを自動的に選択します。
明示的な config
{ agents: { defaults: { memorySearch: { provider: "github-copilot", // Optional: override the auto-discovered model model: "text-embedding-3-small", }, }, },}仕組み
- OpenClaw が GitHub トークンを解決します(環境変数または認証プロファイルから)。
- それを短命の Copilot API トークンと交換します。
- Copilot
/modelsエンドポイントに問い合わせて、利用可能な埋め込みモデルを検出します。 - 最適なモデルを選択します(
text-embedding-3-smallを優先)。 - Copilot
/embeddingsエンドポイントに埋め込みリクエストを送信します。
モデルの利用可否は GitHub プランに依存します。利用可能な埋め込みモデルがない場合、 OpenClaw は Copilot をスキップし、次の provider を試します。