首页 资讯 下载 教程 Skills 社群

GitHub Copilot 代理接入指南

概述

如果你已订阅 GitHub Copilot(Individual、Business 或 Enterprise),可以通过 OpenClaw 的 github-copilot 提供者直接复用订阅额度调用 GPT-4o 等模型,无需单独申请 OpenAI API Key,也不产生额外按量计费。OpenClaw 支持两种接入路径:原生设备登录(无需 VS Code)和通过 VS Code Copilot 插件的代理模式。

快速开始

方式一:原生设备登录(推荐)

在终端直接运行认证命令,会触发 GitHub 的设备授权流程:

openclaw models auth login-github-copilot

根据终端提示,访问 GitHub 设备授权页面并输入验证码完成登录。Token 获取后会存储在 OpenClaw 的认证配置中,运行时自动兑换为 Copilot API Token。

注意:此命令需要交互式终端(TTY),请直接在终端中运行,不要通过管道或脚本调用。

如需绑定特定工作账户,可指定 profile ID:

openclaw models auth login-github-copilot --profile-id github-copilot:work

方式二:VS Code Copilot 代理

安装 Copilot Proxy VS Code 扩展后,扩展会在本地启动一个 /v1 兼容的代理服务,OpenClaw 通过提供者标识符 copilot-proxy 连接该本地代理。

配置参数

登录完成后,设置默认模型:

openclaw models set github-copilot/gpt-4o

或在配置文件中手动指定:

{
  agents: {
    defaults: {
      model: { primary: "github-copilot/gpt-4o" },
    },
  },
}

支持的模型

可用模型取决于你的 GitHub Copilot 订阅层级:

  • github-copilot/gpt-4o — GPT-4o,标准可用
  • github-copilot/gpt-4.1 — GPT-4.1,部分订阅可用
  • github-copilot/claude-sonnet-4-6 — Claude Sonnet(Copilot 企业版可能包含)

若某个模型 ID 被拒绝,可以尝试替代名称。运行以下命令查看当前账户下可用的模型:

openclaw models list | grep github-copilot

注意事项

订阅层级影响可用模型:GitHub Copilot Individual、Business 和 Enterprise 三个层级所能访问的模型有所不同,高级模型通常仅在 Business/Enterprise 层级开放。

Token 自动刷新:设备登录获取的 GitHub Token 由 OpenClaw 在运行时自动兑换为 Copilot API Token,整个刷新过程对用户透明,无需手动续期。

使用条款:通过此方式调用的模型受 GitHub Copilot 服务条款约束,与直接使用 OpenAI API 存在一定差异,请在商业项目中注意合规。

网络要求:需要能正常访问 github.com 及 Copilot API 端点,中国大陆用户可能需要配置代理。