GitHub Copilot

GitHub Copilot 是 GitHub 的 AI 编程助手。它为您的 GitHub 账户和计划提供访问 Copilot 模型的权限。OpenClaw 可以通过两种不同的方式将 Copilot 用作模型提供商。

在 OpenClaw 中使用 Copilot 的两种方式

使用本机设备登录流程获取 GitHub 令牌，然后在 API 运行时将其交换为 Copilot OpenClaw 令牌。这是默认且最简单的路径，因为它不需要 VS Code。

运行登录命令
Terminal window
```
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 Proxy VS Code 扩展作为本地桥。OpenClaw 与代理的 /v1 端点通信，并使用您在那里配置的模型列表。

可选标志

标志	描述
`--yes`	跳过确认提示
`--set-default`	同时应用提供商推荐的默认模型

# Skip confirmation
openclaw models auth login-github-copilot --yes

# Login and set the default model in one step
openclaw models auth login --provider github-copilot --method device --set-default

非交互式新手引导

如果您已经拥有用于 Copilot 的 GitHub OAuth 访问令牌，请在无头设置期间使用 openclaw onboard --non-interactive 导入它：

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-4.1）。

从 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 } },
      },
    },
  },
}

Transport selection

Claude 模型 ID 会自动使用 Anthropic Messages 传输方式。GPT、o 系列和 Gemini 模型则保留 OpenAI Responses 传输方式。OpenClaw 会根据模型引用选择正确的传输方式。

Request compatibility

OpenClaw 在 Copilot 传输上发送类似 Copilot IDE 的请求头，包括内置的压缩、工具结果和图像后续轮次。除非已根据 Copilot 的 API 验证了该行为，否则它不会为 Copilot 启用提供商级别的 Responses 延续。

Environment variable resolution order

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

Priority	Variable	Notes
1	`COPILOT_GITHUB_TOKEN`	最高优先级，Copilot 专用
2	`GH_TOKEN`GitHubCLI	GitHub CLI 令牌（后备）
3	`GITHUB_TOKEN`GitHubOpenClaw	标准 GitHub 令牌（最低）

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

<Accordion title=“Token storage”GitHubAPIOpenClaw> 登录会将 GitHub 令牌存储在身份验证配置文件存储中，并在 OpenClaw 运行时将其交换为 Copilot API 令牌。您无需手动管理令牌。

Memory search embeddings

GitHub Copilot 也可以充当记忆搜索的嵌入提供商。如果您拥有 Copilot 订阅并已登录，OpenClaw 可以使用它进行嵌入，而无需单独的 API 密钥。

自动检测

当 memorySearch.provider 为 "auto"（默认值）时，GitHub Copilot 将在优先级 15 尝试使用——在本地嵌入之后，但在 OpenAI 和其他付费提供商之前。如果存在 GitHub 令牌，OpenClaw 会从 Copilot API 发现可用的嵌入模型并自动选择最佳的一个。

显式配置

{
  agents: {
    defaults: {
      memorySearch: {
        provider: "github-copilot",
        // Optional: override the auto-discovered model
        model: "text-embedding-3-small",
      },
    },
  },
}

工作原理

OpenClaw 解析您的 GitHub 令牌（来自环境变量或身份验证配置文件）。
将其交换为短期的 Copilot API 令牌。
查询 Copilot /models 端点以发现可用的嵌入模型。
选择最佳模型（首选 text-embedding-3-small）。
将嵌入请求发送到 Copilot /embeddings 端点。

模型可用性取决于您的 GitHub 计划。如果没有可用的嵌入模型，OpenClaw 将跳过 Copilot 并尝试下一个提供商。