GitHub Copilot

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

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

openclaw models auth login-github-copilot

openclaw models set github-copilot/claude-sonnet-5

{
  agents: {
    defaults: { model: { primary: "github-copilot/claude-sonnet-5" } },
  },
}

openclaw plugins install @openclaw/copilot

{
  agents: {
    defaults: {
      model: "github-copilot/gpt-5.6-sol",
      models: {
        "github-copilot/gpt-5.6-sol": {
          agentRuntime: { id: "copilot" },
        },
      },
    },
  },
}

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

GitHub Enterprise（数据驻留）¶

如果你的组织使用采用数据驻留策略的 GitHub Enterprise 租户（*.ghe.com 主机，例如 your-org.ghe.com），Copilot 将位于租户本地端点之上，而不是公共的 github.com。OpenClaw 将其作为一等身份验证选项提供，因此你无需手动编辑 URL。

1. 选择 Enterprise 身份验证选项

在引导流程或 openclaw models auth 中，选择 GitHub Copilot（Enterprise / 数据驻留）。系统会提示你输入 Enterprise 域（例如 your-org.ghe.com），然后设备登录将针对该租户运行。

仅输入租户根域（your-org.ghe.com）。不接受派生服务主机，例如 api.your-org.ghe.com 或 copilot-api.your-org.ghe.com；OpenClaw 会自动从租户根域派生这些端点。

openclaw models auth login --provider github-copilot --method device-enterprise

2. 域会持久化到配置中

所选主机将存储在提供程序参数下，因此后续的账户验证和补全会自动面向该租户：

{
  models: {
    providers: {
      "github-copilot": { params: { githubDomain: "your-org.ghe.com" } },
    },
  },
}

设备流程和账户验证使用该租户的 GitHub 端点，Copilot 请求使用 https://copilot-api.your-org.ghe.com。这样，认证和推理都会保留在配置的数据驻留租户上，而不是公共端点上。

租户请求身份¶

OpenClaw 默认使用 copilot-developer-cli 请求身份，包括数据驻留租户。请先确认你的企业允许 Copilot CLI 以及所选模型。*.ghe.com 主机名并不表示采用不同的集成策略。

如果您的租户管理员或 GitHub 支持人员要求使用不同的身份，请使用现有的 provider 标头设置：

{
  models: {
    providers: {
      "github-copilot": {
        params: { githubDomain: "your-org.ghe.com" },
        headers: { "Copilot-Integration-Id": "vscode-chat" },
      },
    },
  },
}

provider 身份适用于设置期间的模型选择、实时模型发现、推理和嵌入。标头名称不区分大小写；request.headers 优先于 provider 的 headers。特定于嵌入的 memory.search.remote.headers 在嵌入发现和请求中仍然具有优先权。不相关的 provider 标头不会被转发到目录或嵌入端点。更改身份并不会授予对已被您组织策略禁用的模型或客户端的访问权限。

可选标志¶

# Skip the re-login 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。对于无头模式设置，请使用 openclaw onboard --non-interactive 导入现有的 GitHub OAuth 访问令牌：

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 provider 的认证选项。如果省略该标志，引导会回退到 COPILOT_GITHUB_TOKEN。通用的 GH_TOKEN 和 GITHUB_TOKEN 不会启用或认证该 provider。在设置了 COPILOT_GITHUB_TOKEN 的情况下使用 --secret-input-mode ref，可在认证配置文件存储中保存由环境变量支持的 tokenRef，而不是明文。

全新的非交互式设置在保存令牌之前会先验证令牌。当设置必须选择默认模型时，它还会检查实时 Copilot 模型目录。OpenClaw 会优先选择该 provider 当前的通用模型（前提是该模型已对该账户启用）；否则，它会选择确定性的合格后备模型。如果账户没有任何在选择器中可见且支持流式输出和工具调用的模型，设置将失败，且不会写入新的认证配置文件。显式配置的默认模型永远不会被替换。

记忆搜索嵌入¶

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

配置¶

显式设置 memory.search.provider 以使用 GitHub Copilot 嵌入。如果 GitHub 令牌可用，OpenClaw 会从 Copilot API 发现可用的嵌入模型，并自动选择最佳模型。

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

工作原理¶

1. OpenClaw 解析您的 GitHub 令牌（来自环境变量或身份验证配置文件）。
2. 验证 Copilot 访问权限并解析账户特定的 API 端点。
3. 查询 Copilot 的 /models 端点以发现可用的嵌入模型，超时时间为 10 秒，包括读取响应正文。
4. 选择最佳模型（优先顺序：text-embedding-3-small、text-embedding-3-large、text-embedding-ada-002）。
5. 向 Copilot 的 /embeddings 端点发送嵌入请求。

模型可用性取决于您的 GitHub 套餐。如果发现失败或没有可用的嵌入模型，OpenClaw 仅在您显式配置另一个提供程序时使用 memory.search.fallback。否则，设置会报告错误，而不是静默选择不同的提供程序。

相关¶

模型选择

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

OAuth 与身份验证

身份验证详细信息和凭据复用规则。