Providers
GitHub Copilot
GitHub Copilot 是 GitHub 的 AI 程式設計助理。它可讓你的 GitHub 帳戶依據方案存取 Copilot 模型。OpenClaw 能以三種不同方式,將 Copilot 用作模型 供應商或代理程式執行階段。
在 OpenClaw 中使用 Copilot 的三種方式
內建供應商 (github-copilot)
使用原生裝置登入流程取得 GitHub 權杖,然後在 OpenClaw 執行時將其交換為 Copilot API 權杖。這是預設且最簡單的方式, 因為不需要 VS Code。
執行登入命令
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 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-defaultGitHub 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.com 或 copilot-api.your-org.ghe.com 等衍生服務主機;
OpenClaw 會自動從租用戶根網域衍生這些端點。
openclaw models auth login --provider github-copilot --method device-enterprise網域會持久儲存至設定
所選主機會儲存在供應商參數下,讓後續的權杖重新整理 與補全自動以該租用戶為目標:
{ 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 主機,而非公用端點。
選用旗標
| 命令 | 旗標 | 說明 |
|---|---|---|
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", }, },}運作方式
- OpenClaw 解析你的 GitHub 權杖(來自環境變數或驗證設定檔)。
- 將其交換為短效 Copilot API 權杖。
- 查詢 Copilot
/models端點,以探索可用的嵌入模型。 - 選擇最佳模型(偏好順序:
text-embedding-3-small、text-embedding-3-large、text-embedding-ada-002)。 - 將嵌入請求傳送至 Copilot
/embeddings端點。
模型可用性取決於你的 GitHub 方案。如果沒有可用的嵌入模型, OpenClaw 會略過 Copilot 並嘗試下一個供應商。