Skip to main content
GitHub Copilot 是 GitHub 的 AI 编码助手。它为你的 GitHub 账户和套餐提供对 Copilot 模型的访问。OpenClaw 可以通过三种不同方式将 Copilot 作为模型 提供方或代理运行时使用。

​
在 OpenClaw 中使用 Copilot 的三种方式

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

运行登录命令

openclaw models auth login-github-copilot
系统会提示你访问一个 URL 并输入一次性代码。请保持终端打开直到完成。
2

设置默认模型

openclaw models set github-copilot/claude-opus-4.7
或在配置中：
{
  agents: {
    defaults: { model: { primary: "github-copilot/claude-opus-4.7" } },
  },
}

​
可选标志

FlagDescription
--yes跳过确认提示
--set-default同时应用提供方推荐的默认模型
# 跳过确认
openclaw models auth login-github-copilot --yes

# 一步完成登录并设置默认模型
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 一起使用，可在 auth-profiles.json 中存储基于环境变量的 tokenRef，而不是明文。
设备登录流程需要交互式 TTY。请直接在终端中运行，不要在非交互式脚本或 CI 流水线中运行。
Copilot 模型的可用性取决于你的 GitHub 套餐。如果某个模型被拒绝，请尝试另一个 ID（例如 github-copilot/gpt-5.5）。请参阅 GitHub 的 每个 Copilot 套餐支持的模型 了解当前模型列表。
一旦设备登录（或环境变量）认证路径解析出 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 传输。GPT、o-series 和 Gemini 模型则保持使用 OpenAI Responses 传输。OpenClaw 会根据模型引用选择正确的传输方式。
OpenClaw 会在 Copilot 传输上发送 Copilot IDE 风格的请求头，包括内置的压缩、工具结果和图像后续轮次。除非已针对 Copilot 的 API 验证过该行为，否则它不会为 Copilot 启用提供方级别的 Responses continuation。
OpenClaw 按以下优先级顺序从环境变量解析 Copilot 认证：
PriorityVariableNotes
1COPILOT_GITHUB_TOKEN最高优先级，Copilot 专用
2GH_TOKENGitHub CLI 令牌（回退）
3GITHUB_TOKEN标准 GitHub 令牌（最低）
当设置了多个变量时，OpenClaw 会使用优先级最高的那个。设备登录流程（openclaw models auth login-github-copilot）会将其令牌存储在认证配置文件存储中，并且优先于所有环境变量。
登录会将 GitHub 令牌存储在认证配置文件存储中，并在 OpenClaw 运行时将其交换为 Copilot API 令牌。你无需手动管理该令牌。
设备登录命令需要交互式 TTY。当你需要无头设置时，请使用非交互式引导。

​
记忆搜索嵌入

GitHub Copilot 也可以作为 memory search 的嵌入提供方。如果你有 Copilot 订阅并已登录，OpenClaw 可将其用于嵌入，而无需单独的 API 密钥。

​
Config

将 memorySearch.provider 明确设置为使用 GitHub Copilot 嵌入。如果有可用的 GitHub 令牌，OpenClaw 会从 Copilot API 发现可用的嵌入模型并自动选择最佳模型。 
{
  agents: {
    defaults: {
      memorySearch: {
        provider: "github-copilot",
        // 可选：覆盖自动发现的模型
        model: "text-embedding-3-small",
      },
    },
  },
}

​
工作原理

  1. OpenClaw 解析你的 GitHub 令牌（来自环境变量或认证配置文件）。
  2. 将其交换为短期有效的 Copilot API 令牌。
  3. 查询 Copilot /models 端点以发现可用的嵌入模型。
  4. 选择最佳模型（优先 text-embedding-3-small）。
  5. 向 Copilot /embeddings 端点发送嵌入请求。
模型可用性取决于你的 GitHub 套餐。如果没有可用的嵌入模型，OpenClaw 会跳过 Copilot 并尝试下一个提供方。

​
相关内容

模型选择

选择提供方、模型引用和故障转移行为。

OAuth 和认证

认证细节和凭据复用规则。