GitHub Copilot

GitHub Copilot 是 GitHub 的 AI 程式設計助理。它可讓你的 GitHub 帳戶依據方案存取 Copilot 模型。OpenClaw 能以三種不同方式，將 Copilot 用作模型 供應商或代理程式執行階段。

​

在 OpenClaw 中使用 Copilot 的三種方式

內建供應商 (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.7
   

   或在設定中：

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

Copilot SDK 控制框架外掛 (copilot)

若要讓 GitHub 的 Copilot 命令列介面與 SDK 為所選的 github-copilot/* 模型管理底層代理程式迴圈，請安裝外部 @openclaw/copilot 外掛。

openclaw plugins install @openclaw/copilot

接著選擇讓模型或供應商使用此執行階段：

{
  agents: {
    defaults: {
      model: "github-copilot/gpt-5.5",
      models: {
        "github-copilot/gpt-5.5": {
          agentRuntime: { id: "copilot" },
        },
      },
    },
  },
}

若要讓這些代理程式回合使用原生 Copilot 命令列介面工作階段、由 SDK 管理的執行緒 狀態，以及由 Copilot 管理的壓縮，請選擇此方式。若未明確選擇使用 agentRuntime，github-copilot/* 模型會繼續使用 內建供應商。完整執行階段合約請參閱 Copilot SDK 控制框架。

Copilot Proxy 外掛 (copilot-proxy)

使用 Copilot Proxy VS Code 擴充功能作為本機橋接器。OpenClaw 會與 Proxy 的 /v1 端點（預設為 http://localhost:3000/v1）通訊，並使用你 設定的模型清單。

copilot-proxy 外掛隨 OpenClaw 提供，且預設啟用。 使用下列命令設定基底 URL 與模型 ID：

openclaw models auth login --provider copilot-proxy --set-default

如果你已在 VS Code 中執行 Copilot Proxy，或需要透過它進行路由， 請選擇此方式。VS Code 擴充功能必須持續執行。

​

GitHub Enterprise（資料落地）

如果你的組織使用具備資料落地功能的 GitHub Enterprise 租用戶（例如 your-org.ghe.com 這類 *.ghe.com 主機），Copilot 會位於租用戶本機的 端點，而非公用的 github.com。OpenClaw 將此項目提供為 一級驗證選項，因此你不必手動編輯 URL。

1. 選擇 Enterprise 驗證選項

   在初始設定或 openclaw models auth 中，選擇 GitHub Copilot (Enterprise / data residency)。系統會提示你輸入 Enterprise 網域（例如 your-org.ghe.com），接著針對該租用戶 執行裝置登入。

   請只輸入租用戶根網域（your-org.ghe.com）。不接受 api.your-org.ghe.com 或 copilot-api.your-org.ghe.com 等衍生服務主機； OpenClaw 會自動從租用戶根網域衍生這些端點。

   openclaw models auth login --provider github-copilot --method device-enterprise
   
2. 網域會持久儲存至設定

   所選主機會儲存在供應商參數下，讓後續的權杖重新整理 與補全自動以該租用戶為目標：

   {
     models: {
       providers: {
         "github-copilot": { params: { githubDomain: "your-org.ghe.com" } },
       },
     },
   }
   

裝置流程、權杖交換和補全會分別解析至 https://your-org.ghe.com/login/device/code、 https://api.your-org.ghe.com/copilot_internal/v2/token 和 https://copilot-api.your-org.ghe.com。資料落地權杖帶有 租用戶戳記且不含 Proxy 提示，因此補全基底 URL 會改用 租用戶的 Copilot 主機，而非公用端點。

切換網域時一律會重新執行裝置登入。如果你已有儲存的 Copilot 權杖，並選擇不同網域（公用 github.com ↔ *.ghe.com 租用戶，或從一個租用戶切換到另一個租用戶），OpenClaw 不會重複使用現有權杖， 而是強制重新登入，確保權杖的範圍符合要寫入 設定的網域。針對相同網域重新執行登入時，仍會提供重複使用目前 權杖的選項。切換回公用 github.com 會清除持久儲存的 githubDomain，使設定回復為預設值。

COPILOT_GITHUB_DOMAIN 環境變數會覆寫所有會解析網域的 Copilot 路徑所解析出的網域， 包括 Enterprise 裝置登入 （--method device-enterprise）、獨立的 openclaw models auth login-github-copilot 捷徑、權杖重新整理、嵌入， 以及補全。對於完全無頭或 CI 設定，請將其設為你的 *.ghe.com 主機。 若要使用公用 github.com，請勿設定此變數（且不要加入設定參數）。 登入會持久儲存其簽發權杖所用的網域（針對公用 github.com 登入時則會清除）， 因此即使之後取消設定環境變數，路由仍會維持正確。

​

選用旗標

命令	旗標	說明
openclaw models auth login-github-copilot	--yes	不經提示即覆寫現有驗證設定檔
openclaw models auth login --provider github-copilot --method device	--set-default	同時套用供應商建議的預設模型

# 略過重新登入確認
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 存取權杖：

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 呼叫發生錯誤時，隨附的靜態目錄仍會作為 可見的備援。若要停用此功能並完全依賴靜態資訊清單目錄 （離線／實體隔離情境）：

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

傳輸方式選擇

Claude 模型 ID 會自動使用 Anthropic Messages 傳輸方式。 Gemini 模型會使用 OpenAI Chat Completions 傳輸方式；GPT 和 o 系列 模型則繼續使用 OpenAI Responses 傳輸方式。OpenClaw 會根據模型參照 選擇正確的傳輸方式。

請求相容性

OpenClaw 會在 Copilot 傳輸中傳送 Copilot IDE 樣式的請求標頭 （VS Code 編輯器／外掛版本和 vscode-chat 整合 ID）， 將工具結果的後續回合標記為由代理程式起始，並在回合包含圖片輸入時設定 Copilot 視覺標頭。

環境變數解析順序

OpenClaw 會依下列優先順序，從環境變數解析 Copilot 驗證：

優先順序	變數	備註
1	COPILOT_GITHUB_TOKEN	最高優先順序，Copilot 專用
2	GH_TOKEN	GitHub 命令列介面權杖（備援）
3	GITHUB_TOKEN	標準 GitHub 權杖（最低優先順序）

設定多個變數時，OpenClaw 會使用優先順序最高的變數。 裝置登入流程（openclaw models auth login-github-copilot）會將 其權杖儲存在驗證設定檔儲存區中，且優先於所有環境 變數。

權杖儲存

登入會將 GitHub 權杖儲存在驗證設定檔儲存區中（設定檔 ID github-copilot:github），並在 OpenClaw 執行時將其交換為短效 Copilot API 權杖。你不需要手動管理權杖。

​

記憶搜尋嵌入

GitHub Copilot 也可作為記憶搜尋的嵌入供應商。 如果你訂閱了 Copilot 且已登入，OpenClaw 無需另外的 API 金鑰 即可使用它來產生嵌入。

​

設定

明確將 memory.search.provider 設為使用 GitHub Copilot 嵌入。如果有可用的 GitHub 權杖，OpenClaw 會從 Copilot API 探索可用的嵌入模型， 並自動選擇最佳模型。

{
  memory: {
    search: {
      provider: "github-copilot",
      // 選用：覆寫自動探索的模型
      model: "text-embedding-3-small",
    },
  },
}

​

運作方式

1. OpenClaw 解析你的 GitHub 權杖（來自環境變數或驗證設定檔）。
2. 將其交換為短效 Copilot API 權杖。
3. 查詢 Copilot /models 端點，以探索可用的嵌入模型。
4. 選擇最佳模型（偏好順序：text-embedding-3-small、 text-embedding-3-large、text-embedding-ada-002）。
5. 將嵌入請求傳送至 Copilot /embeddings 端點。

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

​

相關內容

模型選擇

選擇供應商、模型參照與容錯移轉行為。

OAuth 與驗證

驗證詳細資訊與認證資訊重複使用規則。