GitHub Copilot

使用设备流程或非交互式令牌导入，从 OpenClaw 登录 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-default

如果你已经在 VS Code 中运行 Copilot Proxy，或需要通过它进行路由，请选择此方式。VS Code 扩展必须保持运行。

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.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 主机，而不是公共端点。

切换域名始终会重新运行设备登录。如果你已经存储了 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），将工具结果的后续轮次标记为由 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 并尝试下一个提供商。

GitHub Copilot

在 OpenClaw 中使用 Copilot 的三种方式

GitHub Enterprise（数据驻留）

可选标志

非交互式新手引导

记忆搜索嵌入

配置

工作原理

相关内容