跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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

使用原生设备登录流程获取 GitHub token，然后在 OpenClaw 运行时将其交换为 Copilot API token。这是默认且最简单的路径， 因为它不需要 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" } },
  },
}

​
可选标志

标志描述
--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 access token，可以在 headless 设置期间通过 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。请直接在 终端中运行它，不要在非交互式脚本或 CI 流水线中运行。
Copilot 模型可用性取决于你的 GitHub 套餐。如果某个模型被 拒绝，请尝试另一个 ID（例如 github-copilot/gpt-4.1）。
一旦设备登录（或环境变量）认证路径解析出 GitHub token， OpenClaw 会按需从 ${baseUrl}/models （与 VS Code Copilot 使用的相同端点）刷新模型目录，因此运行时可以跟踪 每个账户的权限和准确的上下文窗口，而无需改动清单。 新发布的 Copilot 模型无需 OpenClaw 升级即可显示，并且上下文窗口会反映真实的单模型限制 （例如 gpt-5.x 系列为 400k，内部 claude-opus-*-1m 变体为 1M）。当设备发现被禁用、用户没有 GitHub 认证配置文件、token 交换 失败，或 /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 启用提供商级 Responses continuation，除非 该行为已针对 Copilot 的 API 完成验证。
OpenClaw 会按以下优先级顺序从环境变量解析 Copilot 认证：
优先级变量说明
1COPILOT_GITHUB_TOKEN最高优先级，Copilot 专用
2GH_TOKENGitHub CLI token（回退）
3GITHUB_TOKEN标准 GitHub token（最低）
当设置了多个变量时，OpenClaw 会使用优先级最高的那个。 设备登录流程（openclaw models auth login-github-copilot）会将 其 token 存储在认证配置文件存储中，并优先于所有环境 变量。
登录会在认证配置文件存储中保存 GitHub token，并在 OpenClaw 运行时将其交换为 Copilot API token。你无需手动管理 token。
设备登录命令需要交互式 TTY。当你需要 headless 设置时，请使用非交互式 新手引导。

​
记忆搜索嵌入

GitHub Copilot 也可以作为 记忆搜索的嵌入提供商。如果你有 Copilot 订阅并且 已登录，OpenClaw 可以在无需单独 API key 的情况下将其用于嵌入。

​
自动检测

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

​
显式配置

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

​
工作原理

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

​
相关内容

模型选择

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

OAuth 和认证

认证详情和凭据复用规则。