
>**核心功能**：将你的 **GitHub Copilot 订阅**转化为 OpenClaw 的通用模型提供商，直接调用 GPT-4o, Claude 3.5 Sonnet 等顶级模型。
**认证方式**：原生支持 **GitHub Device Flow**（设备授权流），无需手动查找 Token，安全且便捷。
**适用场景**：开发者希望复用现有的 Copilot 订阅额度，或在本地 IDE 之外使用 Copilot 模型进行代码生成、文档编写和逻辑推理。


----

## 🚀 一、两种集成模式


OpenClaw 提供了两种使用 GitHub Copilot 的方式，请根据你的工作流选择：

### 模式 A：原生提供商 (`github-copilot`) ⭐ **推荐**


- **原理**：OpenClaw 内置了 GitHub 设备登录流程。它会自动获取 GitHub Token，并在运行时动态交换为 Copilot API Token。

- **优势**：
	- **独立运行**：不需要启动 VS Code 或任何插件。
	- **配置简单**：一条命令即可完成认证。
	- **官方路径**：直接使用 GitHub API，延迟更低。

- **适用**：绝大多数用户，特别是希望在终端或服务器环境中使用的场景。


### 模式 B：Copilot Proxy 插件 (`copilot-proxy`)


- **原理**：依赖 VS Code 中的 **Copilot Proxy** 扩展作为本地桥梁。OpenClaw 通过 HTTP 请求该扩展暴露的 `/v1` 接口。

- **要求**：必须安装 VS Code 扩展并保持其运行状态。

- **适用**：已经在使用 Copilot Proxy 进行其他工具链集成的用户，或需要特定路由策略的场景。


>**本文重点介绍模式 A（原生提供商）**，因为它是最简单且推荐的默认路径。


----

## 🔐 二、快速认证 (CLI 设置)


OpenClaw 使用标准的 **GitHub Device Flow** 进行认证，过程类似于在电视或游戏机上登录 GitHub。

### 1. 执行登录命令


在终端中运行：

```
openclaw models auth login-github-copilot
```
### 2. 完成授权


1. 终端会显示一个 **URL** (通常是 `https://github.com/login/device`) 和一个 **一次性代码** (例如 `A1B2-C3D4`)。

2. 在浏览器中打开该 URL。

3. 输入代码并确认授权 OpenClaw 访问你的 Copilot 权限。

4. 回到终端，等待提示 `Login successful`。


>💡 **注意**：此过程需要交互式终端 (TTY)。请勿在后台脚本中直接运行，除非你处理了交互逻辑。


### 3. (可选) 高级参数


- **指定配置文件 ID** (适合多账号切换)：```
	openclaw models auth login-github-copilot --profile-id github-copilot:work
	```

- **静默确认** (如果已有缓存凭证)：```
	openclaw models auth login-github-copilot --yes
	```


----

## ⚙️ 三、配置默认模型


认证成功后，你需要选择一个可用的模型。Copilot 提供的模型列表取决于你的订阅计划 (Individual, Business, Enterprise)。

### 1. 设置默认模型


使用 CLI 快速设置：

```
# 设置为 GPT-4o (通常可用)
openclaw models set github-copilot/gpt-4o

# 或者尝试其他可用模型，如 GPT-4.1 或 Claude 变体
openclaw models set github-copilot/gpt-4.1
```
### 2. 手动修改配置 (`openclaw.json`)


你也可以直接在配置文件中指定：

```
{
  "agents": {
    "defaults": {
      "model": {
        // 格式：github-copilot/<model-id>
        "primary": "github-copilot/gpt-4o"
      }
    }
  }
}
```
### 📋 常见可用模型 ID


具体可用性请以 `openclaw models list` 输出为准


- `github-copilot/gpt-4o` (最常用)

- `github-copilot/gpt-4.1`

- `github-copilot/claude-3-5-sonnet` (部分计划可用)

- `github-copilot/o1-preview`


----

## 🔄 四、工作原理与令牌管理


理解底层机制有助于排查问题：


1. **存储 GitHub Token**：登录命令会将你的 GitHub OAuth Token 加密存储在 OpenClaw 的认证配置库中。

2. **动态交换**：每次 OpenClaw 发起请求时，它会使用存储的 GitHub Token 向 GitHub API 请求临时的 **Copilot API Token**。

3. **自动刷新**：如果临时 Token 过期，OpenClaw 会自动重新交换，无需用户再次登录。

4. **权限隔离**：OpenClaw 仅请求 Copilot 所需的最低权限，不会获取你的代码仓库读写权限（除非你额外授权）。


----

## ⚠️ 五、常见问题与注意事项


|问题|原因|解决方案|
|:-:|:-:|:-:|
|**Model not found / 404**|模型 ID 错误或不在你的计划内|运行 `openclaw models list` 查看实际可用的模型 ID；尝试切换到 `gpt-4o` 或 `gpt-4.1`。|
|**Login failed / Timeout**|网络问题或未在规定时间内完成网页授权|重新运行登录命令；确保能访问 `github.com`。|
|**Copilot subscription expired**|订阅已过期或未激活|检查 GitHub 账户的 Copilot 订阅状态。|
|**Rate limit exceeded**|触发了 Copilot 的使用限制|Copilot 有每分钟/每天的请求上限。稍后重试，或升级企业计划。|
|**Requires interactive TTY**|在非交互环境运行登录命令|必须在本地终端运行登录命令。登录后，生成的凭证可用于后台服务。|


----

## 💡 六、最佳实践


1. **定期检查模型列表**：GitHub 可能会调整 Copilot 提供的模型阵容。定期运行 `openclaw models list --provider github-copilot` 以发现新模型。

2. **多账号管理**：如果你同时拥有个人版和企业版账号，可以使用 `--profile-id` 创建多个认证配置文件，并根据任务切换。```
	# 登录个人号
	openclaw models auth login-github-copilot --profile-id personal
	# 登录企业号
	openclaw models auth login-github-copilot --profile-id enterprise
	```

3. **成本监控**：虽然 Copilot 是包月制，但仍有速率限制 (Rate Limits)。对于高频自动化任务，请监控是否触发限流，必要时考虑切换到按量付费的官方 API Key。

4. **结合其他工具**：Copilot 模型特别擅长代码生成。在 OpenClaw 的 Agent 提示词中明确“你是一个资深工程师”，能最大化发挥其能力。


----

## 🔗 七、相关资源


- **GitHub Copilot 文档**: https://docs.github.com/en/copilot 

- **OpenClaw 模型列表命令**: `openclaw models list`

- **Copilot Proxy 插件**: [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=...)(如需使用模式 B)


通过简单的几步配置，你就可以让 OpenClaw 化身为你强大的 Copilot 助手，充分利用现有的订阅价值！👨‍💻✨

核心功能：将你的 GitHub Copilot 订阅转化为 OpenClaw 的通用模型提供商，直接调用 GPT-4o, Claude 3.5 Sonnet 等顶级模型。

OpenClaw 集成 GitHub Copilot 完全指南

将你的 GitHub Copilot 订阅转化为 OpenClaw 的通用模型提供商，直接调用 GPT-4o, Claude 3.5 Sonnet 等顶级模型。

开发工具

人工智能

后端

OpenClaw支持将GitHub Copilot订阅转化为通用AI模型服务，直接调用GPT-4o、Claude3.5等顶级模型。提供原生设备授权流认证，无需手动管理Token，支持终端和服务器环境使用。两种集成模式可选，推荐原生提供商模式，简单高效。支持多账号管理，自动刷新Token，开发者可复用Copilot订阅进行代码生成和文档编写。

服务器

路由

GitHub

Agent

4核4G3M云服务器 新用户低至38元/年！

2026新春采购季

organization

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

OpenClaw支持将GitHub Copilot订阅转化为通用AI模型服务，直接调用GPT-4o、Claude3.5等顶级模型。提供原生设备授权流认证，无需手动管理Token，支持终端和服务器环境使用。两种集成模式可选，推荐原生提供商模式，简单高效。支持多账号管理，自动刷新Token，开发者可复用Copilot订阅进...

OpenClaw 集成 GitHub Copilot 完全指南-腾讯云开发者社区-腾讯云

OpenClaw 集成 GitHub Copilot 完全指南

OpenClaw 集成 GitHub Copilot 完全指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐