# GitHub Copilot

> 使用设备流程或非交互式令牌导入，从 OpenClaw 登录 GitHub Copilot

- 网址：https://funcoding.ai/agents/openclaw/providers/github-copilot/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/providers/github-copilot

---
GitHub Copilot 是 GitHub 的 AI 编码助手。它让你可以使用你的 GitHub 账户和套餐所支持的 Copilot
模型。OpenClaw 可以通过三种不同方式将 Copilot 用作模型
提供商或 agent 运行时。

## 在 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 harness 插件 (copilot)**

如果希望由 GitHub 的 Copilot CLI 和 SDK 为选定的
`github-copilot/*` 模型管理底层 agent 循环，请安装外部
`@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" },
        },
      },
    },
  },
}
```

如果你希望这些 agent 轮次使用原生 Copilot CLI 会话、由 SDK 管理的线程
状态以及由 Copilot 管理的压缩，请选择此方式。如果没有明确选择启用
`agentRuntime`，`github-copilot/*` 模型将继续使用
内置提供商。有关完整的运行时约定，请参阅 [Copilot SDK harness](https://funcoding.ai/agents/openclaw/plugins/copilot/)。

**Copilot Proxy 插件 (copilot-proxy)**

将 **Copilot Proxy** VS Code 扩展用作本地桥接器。OpenClaw 与
该代理的 `/v1` 端点（默认 `http://localhost:3000/v1`）通信，并使用你
配置的模型列表。

`copilot-proxy` 插件随 OpenClaw 一起提供，并且默认启用。
使用以下命令配置基础 URL 和模型 ID：

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

<div class="callout callout-note">

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

</div>

## 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 会自动根据租户根域名派生这些端点。

```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/code`、
`https://api.your-org.ghe.com/copilot_internal/v2/token` 和
`https://copilot-api.your-org.ghe.com`。数据驻留令牌带有
租户标记且没有代理提示，因此补全基础 URL 会回退到
租户 Copilot 主机，而不是公共端点。

<div class="callout callout-note">

切换域名始终会重新运行设备登录。如果你已经存储了
Copilot 令牌并选择了不同域名（公共 `github.com` ↔ `*.ghe.com`
租户，或从一个租户切换到另一个租户），OpenClaw 不会复用现有令牌，
而是强制执行全新登录，确保令牌的作用域与写入
配置的域名一致。针对*同一*域名重新运行登录时，仍会提供复用当前
令牌的选项。切换回公共 `github.com` 会清除持久化的
`githubDomain`，使配置恢复为默认值。

</div>

<div class="callout callout-note">

`COPILOT_GITHUB_DOMAIN` 环境变量会覆盖所有解析 Copilot 域名的路径所解析出的域名，
包括 Enterprise 设备登录
（`--method device-enterprise`）、独立的
`openclaw models auth login-github-copilot` 快捷方式、令牌刷新、嵌入
和补全。对于完全无头或 CI 设置，请将其设为你的 `*.ghe.com` 主机。
如需使用公共 `github.com`，请不要设置它（配置参数也应不存在）。
登录会持久化签发令牌所对应的域名（针对公共
`github.com` 登录时则会将其清除），因此即使取消设置
环境变量，路由仍会保持正确。

</div>

## 可选标志

| 命令                                                                    | 标志            | 说明                                 |
| ---------------------------------------------------------------------- | --------------- | ------------------------------------ |
| `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_TOKEN`、`GH_TOKEN`，然后是 `GITHUB_TOKEN`。设置
`COPILOT_GITHUB_TOKEN` 后使用 `--secret-input-mode ref`，可存储由环境变量支持的
`tokenRef`，而不是在 `auth-profiles.json` 中存储明文。

<details>
<summary>需要交互式 TTY</summary>

设备登录流程需要交互式 TTY。请直接在
终端中运行，不要在非交互式脚本或 CI 流水线中运行。

</details>

<details>
<summary>模型可用性取决于你的套餐</summary>

Copilot 模型可用性取决于你的 GitHub 套餐。如果某个模型
被拒绝，请尝试其他 ID（例如 `github-copilot/gpt-5.5`）。有关当前模型列表，
请参阅 GitHub 的[每种 Copilot 套餐支持的模型](https://docs.github.com/en/copilot/reference/ai-models/supported-models#supported-ai-models-per-copilot-plan)。

</details>

<details>
<summary>从 Copilot API 实时刷新目录</summary>

设备登录（或环境变量）身份验证路径解析出 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 } },
      },
    },
  },
}
```

</details>

<details>
<summary>传输方式选择</summary>

Claude 模型 ID 自动使用 Anthropic Messages 传输方式。
Gemini 模型使用 OpenAI Chat Completions 传输方式；GPT 和 o 系列
模型继续使用 OpenAI Responses 传输方式。OpenClaw 根据模型引用
选择正确的传输方式。

</details>

<details>
<summary>请求兼容性</summary>

OpenClaw 在 Copilot 传输中发送 Copilot IDE 风格的请求标头
（VS Code 编辑器／插件版本和 `vscode-chat` 集成 ID），
将工具结果的后续轮次标记为由 agent 发起，并在轮次包含图像输入时
设置 Copilot 视觉标头。

</details>

<details>
<summary>环境变量解析顺序</summary>

OpenClaw 按以下优先级顺序从环境变量解析 Copilot 身份验证：

| 优先级 | 变量                  | 备注                           |
| ------ | --------------------- | ------------------------------ |
| 1      | `COPILOT_GITHUB_TOKEN` | 最高优先级，Copilot 专用       |
| 2      | `GH_TOKEN`            | GitHub CLI 令牌（回退）        |
| 3      | `GITHUB_TOKEN`        | 标准 GitHub 令牌（最低优先级） |

设置多个变量时，OpenClaw 使用优先级最高的变量。
设备登录流程（`openclaw models auth login-github-copilot`）将
令牌存储在身份验证配置文件存储中，并优先于所有环境变量。

</details>

<details>
<summary>令牌存储</summary>

登录流程会在身份验证配置文件存储中存储 GitHub 令牌（配置文件 ID
为 `github-copilot:github`），并在 OpenClaw 运行时将其兑换为短期有效的
Copilot API 令牌。你无需手动管理该令牌。

</details>

## 记忆搜索嵌入

GitHub Copilot 也可以用作
[记忆搜索](https://funcoding.ai/agents/openclaw/concepts/memory-search/)的嵌入提供商。如果你订阅了 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-small`、
   `text-embedding-3-large`、`text-embedding-ada-002`）。
5. 向 Copilot `/embeddings` 端点发送嵌入请求。

模型可用性取决于你的 GitHub 套餐。如果没有可用的嵌入模型，
OpenClaw 会跳过 Copilot 并尝试下一个提供商。

## 相关内容

- [模型选择](https://funcoding.ai/agents/openclaw/concepts/model-providers/)：选择提供商、模型引用和故障转移行为。
- [OAuth 和身份验证](https://funcoding.ai/agents/openclaw/gateway/authentication/)：身份验证详情和凭据复用规则。