Providers

GitHub Copilot

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

在 OpenClaw 中使用 Copilot 的三種方式

內建供應商 (github-copilot)

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

  • 執行登入命令

    bash
    openclaw models auth login-github-copilot

    系統會提示你造訪一個 URL 並輸入一次性代碼。請保持 終端機開啟,直到流程完成。

  • 設定預設模型

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

    或在設定中:

    json5
    {  agents: {    defaults: { model: { primary: "github-copilot/claude-opus-4.7" } },  },}
  • Copilot SDK 控制框架外掛 (copilot)

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

    bash
    openclaw plugins install @openclaw/copilot

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

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

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

    Copilot Proxy 外掛 (copilot-proxy)

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

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

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

    GitHub Enterprise(資料落地)

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

  • 選擇 Enterprise 驗證選項

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

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

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

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

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

    選用旗標

    命令 旗標 說明
    openclaw models auth login-github-copilot --yes 不經提示即覆寫現有驗證設定檔
    openclaw models auth login --provider github-copilot --method device --set-default 同時套用供應商建議的預設模型
    bash
    # 略過重新登入確認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 存取權杖:

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

    json5
    {  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 探索可用的嵌入模型, 並自動選擇最佳模型。

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

    運作方式

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

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

    相關內容

    Was this useful?
    On this page

    On this page