openclaw-cn 接入 Copilot Proxy：在 VS Code 内启用本地 Copilot 模型提供方

人工智能AI Agent即时通讯后端本地部署语音【免费下载链接】openclaw-cn中文社区版OpenClaw同原版保持定期更新已内置钉钉、企业微信、飞书、QQ、微信以及国内网络环境优化。你的专属个人AI助手。支持所有操作系统和平台。项目地址https://gitcode.com/gh_mirrors/op/openclaw-cn点击查看免费下载本文面向希望复用 VS Code 中 Copilot Proxy 扩展所暴露的模型能力、为 openclaw-cnClawdbot补充模型提供方的开发者。文中基于仓库内 copilot-proxy 插件 及 插件主实现完整讲解该插件的作用、启用流程、认证配置、默认参数与自动生成的配置结构并给出源码级实现细节与常见问题排查建议。读完即可在本地将 openclaw-cn 的默认模型切换到由 Copilot Proxy 转发的 GPT / Claude / Gemini 等模型上。插件定位连接 VS Code 与 openclaw-cn 的模型桥openclaw-cn 本身以“Provider 插件Provider plugin”的形式抽象模型提供方任何模型来源都可以通过一个插件注册为 provider进而被 CLI、Agent 与 Gateway 统一调用。copilot-proxy正是这样一类插件它的官方定位是Provider plugin for theCopilot ProxyVS Code extension.也就是说它解决的是“VS Code 里的 Copilot Proxy 扩展已在本地启动但 openclaw-cn 还不知道怎么用它”的问题。该插件在 openclaw-cn 内部注册一个 id 为copilot-proxy的 provider使 Agent 可以像调用其他模型一样把请求发送到 VS Code 中 Copilot Proxy 扩展暴露的本地 HTTP 端点从而间接使用 Copilot 订阅所覆盖的模型如 gpt-5.2、claude-opus-4.5、gemini-3-pro 等。与仓库中其他模型插件如 openclaw 官方文档中的 models 说明不同copilot-proxy 不需要真正的 API Key本地代理本身就充当鉴权方插件侧只需要配置“代理地址 想暴露的模型 ID 列表”即可。第一步启用插件默认禁用openclaw-cn 中随发行包一起打包的插件bundled plugins默认是禁用的需要显式启用openclaw-cn plugins enable copilot-proxy启用成功后需要重启 Gateway使插件生效openclaw-cn gateway restart从实现上看这一步在底层写入的是配置中的插件条目。核心逻辑位于 src/plugins/enable.ts 的enablePluginInConfig它会将该插件的enabled置为true写入plugins.entries同时把它加入plugins.allow允许名单如果全局plugins.enabled false或该插件出现在plugins.deny中则启用会被拒绝并返回对应原因。因此若后续发现启用无效可先检查这两处配置是否拦截。启用后插件系统会在 Gateway 启动时加载本插件Provider 注册逻辑 会将copilot-proxy登记进 provider 注册表重复注册同一 id 会报 “provider already registered” 诊断错误。第二步交互式认证与模型配置启用并重启后执行认证命令openclaw-cn models auth login --provider copilot-proxy --set-default该命令需要交互式 TTY从 认证命令实现 中可看到非 TTY 环境会直接报错执行后会依次向你询问两项输入Copilot Proxy base URL默认值为http://localhost:3000/v1。输入时会即时校验 URL 合法性非法地址会提示Enter a valid URL并自动规范化去除首尾空白与末尾多余的/若不以/v1结尾则自动追加/v1。Model IDscomma-separated默认预填一组模型 ID见下文“默认模型列表”按逗号或换行分隔去重后作为该 provider 对外暴露的模型集合若一个模型 ID 都没有会提示Enter at least one model id。认证完成后--set-default会把默认模型设为copilot-proxy/第一个模型后续 Agent 未显式指定模型时将优先使用它。若不加--set-default则该模型只是“可用”而不会改变默认值命令输出会提示use --set-default to apply。认证流程在源码中的落地models auth login的完整处理链位于 src/commands/models/auth.ts 的modelsAuthLoginCommand通过resolvePluginProviders找到已加载的 provider 插件用--provider copilot-proxy精确匹配也支持别名匹配调用插件注册的 auth 方法run(ctx)得到ProviderAuthResult其中返回的profiles通过upsertAuthProfile写入本机认证档案credential 类型为tokentoken 值固定为占位符n/aprovider 为copilot-proxyprofileId 为copilot-proxy:local返回的configPatch通过mergeConfigPatch深度合并进主配置若指定--set-default调用applyDefaultModel把copilot-proxy/model设为agents.defaults.model.primary同时保留原有 fallbacks。整个过程结束后配置文件中会生成完整的 provider 与模型注册信息详见下节并打印 auth profile 与默认模型日志。自动写入的配置结构与参数详解认证命令不是简单存一个 Key而是把整套模型提供方配置合并进 openclaw-cn 主配置。合并后的效果等价于在配置中加入# 示意结构实际由 models auth login 自动生成 models: providers: copilot-proxy: baseUrl: http://localhost:3000/v1 apiKey: n/a api: openai-completions authHeader: false models: - { id: gpt-5.2, name: gpt-5.2, api: openai-completions, reasoning: false, input: [text, image], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 128000, maxTokens: 8192 } # ... 其余模型同理 agents: defaults: models: copilot-proxy/gpt-5.2: {} copilot-proxy/claude-opus-4.5: {} # ... 每个模型 ID 一个条目对应配置类型的定义可参见 src/config/types.models.tsModelProviderConfig支持baseUrl、apiKey、api、authHeader、headers、models等字段ModelDefinitionConfig则描述单个模型的contextWindow、maxTokens、cost、input、reasoning等能力指标。这也意味着你随时可以手动编辑models.providers.copilot-proxy来调整这些参数而不必重新执行认证命令。插件默认参数一览来自 index.ts参数默认值说明baseUrlhttp://localhost:3000/v1本地 Copilot Proxy 服务地址必须以/v1结尾输入时自动补全apiKeyn/a占位符配合authHeader: false使用不参与真实鉴权apiopenai-completions走 OpenAI 兼容的/v1/chat/completions协议authHeaderfalse不向代理附加鉴权请求头contextWindow128_000每个模型默认上下文窗口128K tokensmaxTokens8192每个模型默认单次最大生成长度cost全 0输入/输出/cache 计费均记 0即按订阅计费而非按量计费reasoningfalse默认不启用推理模式标记input[text, image]声明模型支持文本与图片输入默认模型列表认证命令默认预填以下模型 ID源码常量DEFAULT_MODEL_IDSgpt-5.2、gpt-5.2-codexgpt-5.1、gpt-5.1-codex、gpt-5.1-codex-maxgpt-5-miniclaude-opus-4.5、claude-sonnet-4.5、claude-haiku-4.5gemini-3-pro、gemini-3-flashgrok-code-fast-1需要注意这份列表只是插件允许暴露的“候选”模型实际能否调用取决于你的 Copilot 订阅计划且代理服务端必须能识别这些模型名。模型不可用或想增减条目时直接编辑models.providers.copilot-proxy.models即可插件源码的 notes 也明确提示了这一点。源码实现细节地址规范化、模型解析与模型定义copilot-proxy插件的全部逻辑都集中在 extensions/copilot-proxy/index.ts约 140 行无外部运行时依赖非常值得作为“最小 Provider 插件”范本阅读地址规范化normalizeBaseUrl先trim再循环去除尾部/最后确保以/v1结尾。所以输入http://localhost:3000/、http://localhost:3000或http://localhost:3000/v1/都会被统一成http://localhost:3000/v1。地址校验validateBaseUrl基于new URL()做合法性检查非法时返回Enter a valid URL直接作为 CLI 输入校验提示。模型解析parseModelIds按\n与,分割、逐项trim、过滤空串最后用Set去重。这意味着你可以粘贴一行逗号分隔的模型名也可以粘贴多行模型名。模型定义buildModelDefinition为每个模型生成符合 ModelDefinitionConfig 结构的条目id与name相同协议固定为openai-completions上下文窗口与最大输出 token 统一取默认值。注册方式register(api)调用api.registerProvider注册 id 为copilot-proxy的 provider其auth数组只有一项kind: custom的交互式认证方法id: local这正是上面models auth login所执行的交互流程。插件的元数据则由 openclaw.plugin.json声明插件 id、providers、空配置 schema与 package.json声明入口./index.ts共同构成。使用前提与注意事项综合 README 与源码中的 notes使用本插件有三个硬性前提Copilot Proxy 必须正在 VS Code 中运行。openclaw-cn 只是代理的客户端真正的模型鉴权与转发由 VS Code 扩展完成插件启动前未打开 VS Code / 未启动该扩展请求会失败。对应 defaultModel 的 notes 明确写着Start the Copilot Proxy VS Code extension before using these models.Base URL 必须包含/v1。因为 Copilot Proxy 暴露的是 OpenAI 兼容的/v1/chat/completions接口虽然插件会自动补全/v1但如果你手动编辑配置请务必保留该路径段。模型可用性取决于 Copilot 订阅计划。默认列表中的模型是否真实可用由你的订阅与代理端决定不可用时优先调整models.providers.copilot-proxy.models列表。常见问题排查plugins enable无效果检查主配置中plugins.enabled是否为false或plugins.deny是否包含copilot-proxy也可确认启用后是否重启了 Gateway。models auth login提示非 TTY 错误该命令必须在交互式终端中执行远程/脚本环境下无法完成交互输入。请求超时或连接拒绝确认 VS Code 已打开且 Copilot Proxy 扩展处于运行状态并核对baseUrl端口默认3000是否被占用或修改。某个模型不可用默认列表为候选集合实际可用模型取决于 Copilot 订阅计划在配置中增删models.providers.copilot-proxy.models即可。相关仓库路径速查插件 README启用、认证命令插件主实现默认值、交互认证、配置生成插件清单 与 package.json认证命令实现models auth login全流程插件启用逻辑plugins enable底层Provider 注册表registerProvider注册与去重模型配置类型ModelProviderConfig/ModelDefinitionConfig字段定义赞分享人工智能AI Agent即时通讯后端本地部署语音【免费下载链接】openclaw-cn中文社区版OpenClaw同原版保持定期更新已内置钉钉、企业微信、飞书、QQ、微信以及国内网络环境优化。你的专属个人AI助手。支持所有操作系统和平台。项目地址https://gitcode.com/gh_mirrors/op/openclaw-cn点击查看免费下载相关推荐在 Roo Code 中使用 VS Code Language Model API接入 GitHub Copilot 与其他扩展模型在 Roo Code 中使用 VS Code Language Model API接入 GitHub Copilot 与其他扩展模型 Roo Code 内置了人工智能AI Agent代码智能体开发工具工具调用MCP ClientsOpenClaw GitHub Copilot 代理运行时插件openclaw/copilot接入指南OpenClaw GitHub Copilot 代理运行时插件openclaw/copilot接入指南 OpenClaw 默认使用内嵌embeddedAI 应用AI Agent交互助手后端即时通讯网关在 VS Code 原生 Copilot Chat 中使用 OmniRouteOmniCopilot 扩展接入指南在 VS Code 原生 Copilot Chat 中使用 OmniRouteOmniCopilot 扩展接入指南 OmniRoute 是一个单端点接入多 p后端API网关LLM 网关人工智能大模型MCP 服务桌面应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考