OpenClawでGitHub Copilotを導入：5分でAIモデルを接続・設定する方法

開発中にAIアシスタントを活用しようとすると、複数のツールやAPIキーの管理に頭を悩ませることがよくありますよね。特に環境ごとに認証情報を切り替えたり、設定を同期させたりする作業は、本来のコーディング時間を削ってしまう大きな障壁になりがちです。

OpenClawは、GitHub Copilotとシームレスに連携することで、こうした認証の煩わしさを解消し、開発者が本来の作業に集中できる環境を提供します。

GitHub Copilot

GitHub Copilotは、GitHubが提供するAIコーディングアシスタントです。お使いのGitHubアカウントとプランに応じて、Copilotのモデルにアクセスできます。OpenClawでは、主に2つの方法でCopilotをモデルプロバイダーとして利用可能です。

OpenClawでCopilotを利用する2つの方法

OpenClawでCopilotを利用するには、以下のいずれかの方法を選択してください。

1. 組み込みプロバイダー (github-copilot) ネイティブのデバイスログインフローを使用してGitHubトークンを取得し、OpenClawの実行時にCopilot APIトークンと交換します。これはデフォルトであり、VS Codeを必要としない最もシンプルな方法です。

   1. ログインコマンドを実行します。

      openclaw models auth login-github-copilot

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

   2. デフォルトモデルを設定します。

      openclaw models set github-copilot/claude-opus-4.6

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

      {
        agents: {
          defaults: { model: { primary: "github-copilot/claude-opus-4.6" } },
        },
      }

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

   VS Codeで既にCopilot Proxyを実行している場合や、経由させる必要がある場合に選択してください。プラグインを有効にし、VS Code拡張機能を実行し続ける必要があります。

オプションのフラグ

コマンド実行時に便利なオプションフラグが用意されています。

Flag	Description
--yes	確認プロンプトをスキップします
--set-default	プロバイダーが推奨するデフォルトモデルも適用します

# Skip confirmation
openclaw models auth login-github-copilot --yes

# Login and set the default model in one step
openclaw models auth login --provider github-copilot --method device --set-default

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

• モデルの利用可否はプランに依存 Copilotモデルの利用可否は、お使いのGitHubプランに依存します。モデルが拒否された場合は、別のID（例: github-copilot/gpt-4.1）を試してください。

• トランスポートの選択 ClaudeモデルIDは自動的にAnthropic Messagesトランスポートを使用します。GPT、o-series、およびGeminiモデルはOpenAI Responsesトランスポートを維持します。OpenClawはモデル参照に基づいて適切なトランスポートを自動選択します。

• 環境変数の解決順序 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トークンと交換されます。手動でトークンを管理する必要はありません。

インタラクティブなTTYが必要です。ログインコマンドは、ヘッドレススクリプトやCIジョブの中ではなく、ターミナルで直接実行してください。

メモリ検索の埋め込み (Memory search embeddings)

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

自動検出

memorySearch.providerが"auto"（デフォルト）の場合、GitHub Copilotは優先度15で試行されます（ローカル埋め込みの後、OpenAIや他の有料プロバイダーの前）。GitHubトークンが利用可能な場合、OpenClawはCopilot APIから利用可能な埋め込みモデルを検出し、最適なものを自動的に選択します。

明示的な設定

{
  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と認証

さらにサポートが必要な場合は、AI Setup Assistantをご利用ください。