GitHub Copilot

GitHub Copilot 是 GitHub 的 AI 程式碼編寫助理。它提供對您 GitHub 帳戶和方案所對應的 Copilot 模型的存取權。OpenClaw 可以透過兩種不同的方式將 Copilot 作為模型提供者使用。

在 OpenClaw 中使用 Copilot 的兩種方式

使用原生的裝置登入流程取得 GitHub token，然後在 OpenClaw 執行時將其交換為 Copilot API token。這是預設且最簡單的路徑，因為它不需要 VS Code。

執行登入指令
Terminal window
```
openclaw models auth login-github-copilot
```
系統會提示您前往一個 URL 並輸入一次性代碼。請保持終端機開啟，直到完成為止。

設定預設模型

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

或在設定中：

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

使用 Copilot Proxy VS Code 擴充功能作為本機橋接器。OpenClaw 與 Proxy 的 /v1 端點通訊，並使用您在那裡設定的模型清單。

選用旗標

旗標	說明
`--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

非互動式入門

如果您已經有 Copilot 的 GitHub OAuth 存取 token，請在無頭設定期間使用 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 提供者驗證選擇。如果省略該旗標，入門流程會回退到 COPILOT_GITHUB_TOKEN、GH_TOKEN，然後是 GITHUB_TOKEN。使用 --secret-input-mode ref 並設定 COPILOT_GITHUB_TOKEN，以儲存由環境變數支援的 tokenRef，而不是在 auth-profiles.json 中儲存純文字。

需要互動式 TTY

裝置登入流程需要一個互動式 TTY。請直接在終端機中執行，而不是在非互動式腳本或 CI 管線中執行。

模型可用性取決於您的方案

Copilot 模型的可用性取決於您的 GitHub 方案。如果模型被拒絕，請嘗試另一個 ID（例如 github-copilot/gpt-4.1）。

從 Copilot API 即時更新目錄

一旦裝置登入（或環境變數）驗證路徑解析了 GitHub 權杖， OpenClaw 會視需要從 ${baseUrl}/models （與 VS Code Copilot 使用的端點相同）更新模型目錄，以便執行時期追蹤每個帳戶的權限和準確的上下文視窗，而不會造成清單的變動。新發布的 Copilot 模型無需升級 OpenClaw 即可顯示，且上下文視窗會反映實際的各模型限制（例如 gpt-5.x 系列為 400k，內部 claude-opus-*-1m 變體為 1M）。

當探索功能被停用、使用者沒有 GitHub 驗證設定檔、權杖交換失敗，或 /models HTTPS 呼叫發生錯誤時，捆綁的靜態目錄會作為可見的備案。若要選擇退出並完全依賴靜態清單目錄（離線 / 物理隔離場景）：

{
  plugins: {
    entries: {
      "github-copilot": {
        config: { discovery: { enabled: false } },
      },
    },
  },
}

傳輸選擇

Claude 模型 ID 會自動使用 Anthropic Messages 傳輸。GPT、 o-series 和 Gemini 模型會保留 OpenAI Responses 傳輸。OpenClaw 會根據模型參考選擇正確的傳輸方式。

請求相容性

OpenClaw 會在 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 金鑰。

自動偵測

當 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",
      },
    },
  },
}

運作方式

OpenClaw 解析您的 GitHub 權杖 (來自環境變數或驗證設定檔)。
將其交換為短期有效的 Copilot API 權杖。
查詢 Copilot /models 端點以探索可用的嵌入模型。
挑選最佳模型 (偏好 text-embedding-3-small)。
將嵌入請求傳送至 Copilot /embeddings 端點。

模型可用性取決於您的 GitHub 方案。如果沒有可用的嵌入模型，OpenClaw 將跳過 Copilot 並嘗試下一個供應商。