OpenClaw で Copilot を使用する 3 つの方法
- 組み込みプロバイダー (github-copilot)
- Copilot SDK ハーネス Plugin (copilot)
- Copilot Proxy Plugin (copilot-proxy)
任意のフラグ
| コマンド | フラグ | 説明 |
|---|---|---|
openclaw models auth login-github-copilot | --yes | 確認なしで既存の認証プロファイルを上書きする |
openclaw models auth login --provider github-copilot --method device | --set-default | プロバイダー推奨のデフォルトモデルも適用する |
非対話型オンボーディング
デバイスログインフローには対話型 TTY が必要です。ヘッドレスセットアップでは、openclaw onboard --non-interactive で既存の GitHub OAuth アクセストークンをインポートします。
--auth-choice を省略することもできます。--github-copilot-token を渡すと、
GitHub Copilot プロバイダーの認証選択として推論されます。フラグを省略した場合、
オンボーディングは COPILOT_GITHUB_TOKEN、GH_TOKEN、次に GITHUB_TOKEN へフォールバックします。
COPILOT_GITHUB_TOKEN を設定したうえで --secret-input-mode ref を使用すると、
auth-profiles.json にプレーンテキストではなく環境変数ベースの
tokenRef を保存できます。
対話型 TTY が必要
対話型 TTY が必要
デバイスログインフローには対話型 TTY が必要です。非対話型スクリプトや CI パイプラインではなく、
ターミナルで直接実行してください。
モデルの利用可否はプランに依存します
モデルの利用可否はプランに依存します
Copilot モデルの利用可否は GitHub プランに依存します。モデルが
拒否された場合は、別の ID (例:
github-copilot/gpt-5.5) を試してください。現在のモデル一覧については、
GitHub の Copilot プランごとの対応モデル
を参照してください。Copilot API からのライブカタログ更新
Copilot API からのライブカタログ更新
デバイスログイン (または環境変数) の認証パスで GitHub トークンが解決されると、
OpenClaw は
${baseUrl}/models (VS Code Copilot が使用するものと同じエンドポイント)
からオンデマンドでモデルカタログを更新するため、ランタイムは
アカウントごとの権限と正確なコンテキストウィンドウをマニフェストの変更なしで追跡できます。
新しく公開された Copilot モデルは OpenClaw のアップグレードなしで表示され、
コンテキストウィンドウは実際のモデルごとの制限を反映します
(例: gpt-5.x シリーズは 400k、内部
claude-opus-*-1m バリアントは 1M)。検出が無効な場合、ユーザーに GitHub 認証プロファイルがない場合、トークン交換に
失敗した場合、または /models HTTPS 呼び出しでエラーが発生した場合、同梱の静的カタログが表示上のフォールバックとして残ります。
オプトアウトして、静的マニフェストカタログのみに依存するには (オフライン / エアギャップ環境):トランスポートの選択
トランスポートの選択
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 認証を解決します。
複数の変数が設定されている場合、OpenClaw は最も優先度の高いものを使用します。
デバイスログインフロー (
| 優先度 | 変数 | 注記 |
|---|---|---|
| 1 | COPILOT_GITHUB_TOKEN | 最高優先度、Copilot 固有 |
| 2 | GH_TOKEN | GitHub CLI トークン (フォールバック) |
| 3 | GITHUB_TOKEN | 標準の GitHub トークン (最低) |
openclaw models auth login-github-copilot) は
そのトークンを認証プロファイルストアに保存し、すべての環境変数より優先されます。トークン保存
トークン保存
ログインは GitHub トークンを認証プロファイルストア (プロファイル ID
github-copilot:github) に保存し、OpenClaw の実行時に短命の Copilot API
トークンと交換します。トークンを手動で管理する必要はありません。メモリ検索埋め込み
GitHub Copilot は メモリ検索 の埋め込みプロバイダーとしても機能できます。 Copilot サブスクリプションがあり、ログイン済みであれば、 OpenClaw は別個の API キーなしで埋め込みに使用できます。設定
GitHub Copilot 埋め込みを使用するには、memorySearch.provider を明示的に設定します。
GitHub トークンが利用可能な場合、OpenClaw は Copilot API から利用可能な埋め込みモデルを検出し、
最適なものを自動的に選択します。
仕組み
- OpenClaw が GitHub トークンを解決します (環境変数または認証プロファイルから)。
- それを短命の Copilot API トークンと交換します。
- Copilot
/modelsエンドポイントを照会して、利用可能な埋め込みモデルを検出します。 - 最適なモデルを選択します (優先順:
text-embedding-3-small,text-embedding-3-large,text-embedding-ada-002)。 - 埋め込みリクエストを Copilot
/embeddingsエンドポイントへ送信します。
関連
モデル選択
プロバイダー、モデル参照、フェイルオーバー動作の選択。
OAuth と認証
認証の詳細と認証情報の再利用ルール。