OpenClaw 集成 GitHub Copilot 詳細(xì)指南

發(fā)布時(shí)間：2026-03-30 10:59:51 作者：前端大波

本文介紹了將GitHub Copilot集成到OpenClaw的方法,包括前提條件、安裝步驟、兩種集成方式（內(nèi)置GitHub Copilot提供商和CopilotProxy插件）,并提供了常用CLI命令和常見(jiàn)問(wèn)題排查，感興趣的朋友跟隨小編一起看看吧

OpenClaw 集成 GitHub Copilot 指南

本文檔介紹如何將 GitHub Copilot 作為模型提供商集成到 OpenClaw 中，實(shí)現(xiàn)通過(guò) GitHub 賬戶調(diào)用 Copilot 模型能力。

什么是 OpenClaw

OpenClaw 是一個(gè)開(kāi)源的 AI 助手平臺(tái)，提供自托管的 AI 網(wǎng)關(guān)（Gateway）和代理（Agent）能力。它支持多種模型提供商（Anthropic、OpenAI、Google、GitHub Copilot 等），并能通過(guò) Telegram、Discord、WhatsApp、iMessage 等多種渠道進(jìn)行對(duì)話交互。

核心特性：

自托管 AI Gateway，支持多模型調(diào)度與故障轉(zhuǎn)移
支持 30+ 種模型提供商
支持插件、技能（Skills）擴(kuò)展
支持多平臺(tái)（macOS / Linux / Windows / Docker / Kubernetes）

什么是 GitHub Copilot

GitHub Copilot 是 GitHub 推出的 AI 編程助手，基于用戶的 GitHub 賬戶和訂閱計(jì)劃，提供 GPT-4o、GPT-4.1、Claude 等多種大模型能力。將其接入 OpenClaw 后，可以免費(fèi)或低成本地使用這些模型來(lái)驅(qū)動(dòng) AI 助手。

前提條件

在開(kāi)始集成之前，請(qǐng)確保滿足以下條件：

條件	說(shuō)明
GitHub 賬戶	需要已訂閱 GitHub Copilot（個(gè)人版、商業(yè)版或企業(yè)版均可）
Node.js	推薦 Node 24，最低支持 Node 22.14+
交互式終端（TTY）	認(rèn)證步驟需要在可交互的終端中執(zhí)行，不支持純腳本/CI 環(huán)境
操作系統(tǒng)	macOS / Linux / WSL2（推薦）/ Windows 原生

檢查 Node.js 版本：

node --version

安裝 OpenClaw

macOS / Linux / WSL2

curl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell)

iwr -useb https://openclaw.ai/install.ps1 | iex

通過(guò) npm 安裝

npm install -g openclaw@latest

通過(guò) pnpm 安裝

pnpm add -g openclaw@latest
pnpm approve-builds -g   # pnpm 需要顯式批準(zhǔn)含構(gòu)建腳本的包

安裝完成后運(yùn)行引導(dǎo)程序

openclaw onboard --install-daemon

引導(dǎo)程序會(huì)幫助你選擇模型提供商、配置 API Key，并啟動(dòng) Gateway，整個(gè)過(guò)程約 2 分鐘。

驗(yàn)證安裝

openclaw --version       # 確認(rèn) CLI 已安裝
openclaw doctor          # 檢查配置是否正常
openclaw gateway status  # 確認(rèn) Gateway 正在運(yùn)行（默認(rèn)監(jiān)聽(tīng)端口 18789）

兩種集成方式

OpenClaw 提供兩種方式集成 GitHub Copilot，根據(jù)實(shí)際使用場(chǎng)景選擇：

方式	適用場(chǎng)景	是否需要 VS Code
內(nèi)置 `github-copilot` 提供商	大多數(shù)場(chǎng)景，最簡(jiǎn)便	不需要
Copilot Proxy 插件	已在 VS Code 中運(yùn)行 Copilot Proxy，或需要通過(guò)代理路由	需要（需保持運(yùn)行）

方式一：內(nèi)置 GitHub Copilot 提供商（推薦）

這是最簡(jiǎn)單的集成方式，使用 GitHub 的設(shè)備授權(quán)（Device Flow）獲取訪問(wèn)令牌，無(wú)需安裝 VS Code。

第一步：執(zhí)行登錄命令

在可交互的終端中運(yùn)行（不能在 CI/腳本中執(zhí)行）：

openclaw models auth login-github-copilot

第二步：完成設(shè)備授權(quán)

命令執(zhí)行后，終端會(huì)輸出類似以下信息：

Visit: https://github.com/login/device
Enter code: XXXX-XXXX
Waiting for authorization...

使用瀏覽器訪問(wèn) https://github.com/login/device
輸入終端中顯示的一次性驗(yàn)證碼
在 GitHub 頁(yè)面授權(quán) OpenClaw 訪問(wèn)你的 Copilot
授權(quán)完成后，保持終端開(kāi)啟，等待命令自動(dòng)完成

注意： 請(qǐng)勿關(guān)閉終端，直到命令輸出成功提示。

可選參數(shù)

指定自定義 Profile ID（適合管理多個(gè) GitHub 賬號(hào)）：

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

跳過(guò)確認(rèn)提示（自動(dòng)接受）：

openclaw models auth login-github-copilot --yes

方式二：Copilot Proxy 插件

如果你已經(jīng)在 VS Code 中安裝并運(yùn)行了 Copilot Proxy 擴(kuò)展，可以讓 OpenClaw 通過(guò)該代理的 /v1 端點(diǎn)訪問(wèn) Copilot 模型。

前提： VS Code 中的 Copilot Proxy 擴(kuò)展必須處于運(yùn)行狀態(tài)，OpenClaw 才能正常調(diào)用。

啟用插件

在 OpenClaw 配置文件中啟用 copilot-proxy 插件：

{
  plugins: {
    "copilot-proxy": {
      enabled: true,
      baseUrl: "http://localhost:<代理端口>/v1"  // 替換為 Copilot Proxy 實(shí)際監(jiān)聽(tīng)地址
    }
  }
}

設(shè)置默認(rèn)模型

登錄成功后，將 GitHub Copilot 提供的模型設(shè)置為默認(rèn)模型：

# 設(shè)置 GPT-4o 為主模型
openclaw models set github-copilot/gpt-4o
# 或使用 GPT-4.1
openclaw models set github-copilot/gpt-4.1

查看當(dāng)前可用模型：

openclaw models list

查看模型狀態(tài)和認(rèn)證信息：

openclaw models status

配置文件示例

手動(dòng)編輯配置文件（位于 ~/.openclaw/config.json5）：

最簡(jiǎn)配置

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

配置主模型 + 備用模型（故障轉(zhuǎn)移）

{
  agents: {
    defaults: {
      model: {
        primary: "github-copilot/gpt-4o",
        fallbacks: [
          "github-copilot/gpt-4.1",
          "openai/gpt-4o"  // 可選：其他提供商作為最終備用
        ]
      }
    }
  }
}

指定 Profile ID（多賬號(hào)場(chǎng)景）

{
  agents: {
    defaults: {
      model: {
        primary: "github-copilot/gpt-4o"
      }
    }
  },
  auth: {
    profiles: [
      {
        id: "github-copilot:work",
        provider: "github-copilot"
      }
    ]
  }
}

配置模型允許列表（限制可用模型）

{
  agents: {
    defaults: {
      model: {
        primary: "github-copilot/gpt-4o"
      },
      models: {
        "github-copilot/gpt-4o": { alias: "Copilot GPT-4o" },
        "github-copilot/gpt-4.1": { alias: "Copilot GPT-4.1" }
      }
    }
  }
}

模型管理

常用 CLI 命令速查

# 查看當(dāng)前模型狀態(tài)
openclaw models status
# 列出所有配置的模型
openclaw models list
# 列出所有可用模型（包含完整目錄）
openclaw models list --all
# 切換主模型
openclaw models set github-copilot/gpt-4o
# 添加備用模型
openclaw models fallbacks add github-copilot/gpt-4.1
# 查看備用模型列表
openclaw models fallbacks list
# 刪除備用模型
openclaw models fallbacks remove github-copilot/gpt-4.1
# 添加模型別名
openclaw models aliases add "copilot" github-copilot/gpt-4o

在對(duì)話中切換模型

在 Control UI 或支持的頻道中，可以使用斜杠命令臨時(shí)切換模型：

/model                          # 打開(kāi)模型選擇器
/model list                     # 列出可用模型
/model github-copilot/gpt-4o    # 切換到指定模型
/model status                   # 查看當(dāng)前模型詳細(xì)狀態(tài)

常見(jiàn)問(wèn)題排查

1. 模型被拒絕訪問(wèn)（“Model rejected”）

原因： 當(dāng)前 GitHub Copilot 訂閱計(jì)劃不支持該模型。

解決方案：

# 嘗試切換到其他 Copilot 模型
openclaw models set github-copilot/gpt-4.1
# 查看訂閱計(jì)劃支持的模型
openclaw models list --provider github-copilot

2. 登錄命令報(bào)錯(cuò)"requires interactive TTY"

原因： 在非交互式終端（如 CI 流水線、SSH 無(wú) TTY 會(huì)話）中執(zhí)行了登錄命令。

解決方案： 在本機(jī)的普通終端窗口中直接執(zhí)行登錄命令，不要通過(guò)腳本調(diào)用。

3. 命令執(zhí)行后提示"openclaw: command not found"