跳转到主要内容

​
GitHub Copilot

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/gpt-4o
或者在配置中：
{
  agents: { defaults: { model: { primary: "github-copilot/gpt-4o" } } },
}

​
可选标志

Flag描述
--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
设备登录流程需要交互式 TTY。请直接在终端中运行，不要在非交互式脚本或 CI 流水线中运行。
Copilot 模型的可用性取决于你的 GitHub 套餐。如果某个模型被拒绝，请尝试另一个 ID（例如 github-copilot/gpt-4.1）。
Claude 模型 ID 会自动使用 Anthropic Messages 传输方式。GPT、o-series 和 Gemini 模型继续使用 OpenAI Responses 传输方式。OpenClaw 会根据模型 ref 选择正确的传输方式。
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。请直接在终端中运行登录命令，不要在无头脚本或 CI 作业中运行。

​
Memory search 嵌入

GitHub Copilot 也可以用作 memory search 的嵌入提供商。如果你拥有 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",
      },
    },
  },
}

​
工作原理

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

​
相关内容

模型选择

选择提供商、模型 ref 和故障转移行为。

OAuth 和认证

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