提供商
GitHub Copilot
GitHub Copilot 是 GitHub 的 AI 编码助手。它让你可以使用你的 GitHub 账户和套餐所支持的 Copilot 模型。OpenClaw 可以通过三种不同方式将 Copilot 用作模型 提供商或 agent 运行时。
在 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 harness 插件 (copilot)
如果希望由 GitHub 的 Copilot CLI 和 SDK 为选定的
github-copilot/* 模型管理底层 agent 循环,请安装外部
@openclaw/copilot 插件。
openclaw plugins install @openclaw/copilot然后选择让某个模型或提供商使用该运行时:
{ agents: { defaults: { model: "github-copilot/gpt-5.5", models: { "github-copilot/gpt-5.5": { agentRuntime: { id: "copilot" }, }, }, }, },}如果你希望这些 agent 轮次使用原生 Copilot CLI 会话、由 SDK 管理的线程
状态以及由 Copilot 管理的压缩,请选择此方式。如果没有明确选择启用
agentRuntime,github-copilot/* 模型将继续使用
内置提供商。有关完整的运行时约定,请参阅 Copilot SDK harness。
Copilot Proxy 插件 (copilot-proxy)
将 Copilot Proxy VS Code 扩展用作本地桥接器。OpenClaw 与
该代理的 /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。数据驻留令牌带有
租户标记且没有代理提示,因此补全基础 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),
将工具结果的后续轮次标记为由 agent 发起,并在轮次包含图像输入时
设置 Copilot 视觉标头。
环境变量解析顺序
OpenClaw 按以下优先级顺序从环境变量解析 Copilot 身份验证:
| 优先级 | 变量 | 备注 |
|---|---|---|
| 1 | COPILOT_GITHUB_TOKEN |
最高优先级,Copilot 专用 |
| 2 | GH_TOKEN |
GitHub CLI 令牌(回退) |
| 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 并尝试下一个提供商。