OpenClaw Vercel AI Gateway 插件参考用单个 API Key 接入多模型统一网关【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw本文围绕 OpenClaw 的 Vercel AI Gateway 插件参考文档展开覆盖插件的分发渠道、安装配置步骤、模型 ID 简写归一化、守护进程环境配置与 Thinking 等级等核心内容并结合插件源码剖析模型目录自动发现、动态模型解析与推理档位的底层实现帮助读者完成从安装到审计该插件的完整闭环。插件概览与分发信息Vercel AI Gateway 插件为 OpenClaw 增加了一个模型提供方provider通过单一端点统一访问上游各厂商的数百个模型。根据插件参考文档 vercel-ai-gateway 插件参考其核心元信息如下属性值功能摘要为 OpenClaw 增加 Vercel AI Gateway 模型提供方支持适用场景安装、配置或审计 vercel-ai-gateway 插件分发包名openclaw/vercel-ai-gateway-provider安装渠道npm 或 ClawHubclawhub:openclaw/vercel-ai-gateway-provider注册的 Providervercel-ai-gateway从 package.json 可以看到更完整的分发约束插件当前版本为2026.9.3要求宿主版本minHostVersion: 2026.6.9、插件 API 兼容版本pluginApi: 2026.9.3并同时发布到 ClawHub 与 npmpublishToClawHub: true、publishToNpm: true默认安装渠道为 npmdefaultChoice: npm。此外插件清单 openclaw.plugin.json 中声明了enabledByDefault: true即该插件默认启用activation.onStartup为false不会在启动时强制激活模型目录发现策略声明为refreshable可刷新的实时发现。该参考文档为自动生成文件头部注释标明由pnpm plugins:inventory:gen重建手工维护内容仅限 manual 标记区间内因此文中信息与仓库源码保持一致适合作为审计入口。快速上手四步完成接入参考文档关联的提供方指南 Vercel AI gateway 给出了完整的接入流程其核心属性为属性值Providervercel-ai-gateway安装包openclaw/vercel-ai-gateway-provider认证环境变量AI_GATEWAY_API_KEYAPI 协议Anthropic Messages 兼容Base URLhttps://ai-gateway.vercel.sh模型目录通过/v1/models自动发现第 1 步安装插件openclaw plugins install openclaw/vercel-ai-gateway-provider第 2 步配置 API Keyopenclaw onboard --auth-choice ai-gateway-api-key这里的ai-gateway-api-key并不是随意起的名字而是插件清单中providerAuthChoices注册的choiceId。从 openclaw.plugin.json 可以看到该选项的完整声明包括认证方法api-key、选项键aiGatewayApiKey、CLI 标志--ai-gateway-api-key key以及appGuidedSecret: true引导式密钥录入。清单同时声明了该 provider 需要的环境变量setup: { providers: [ { id: vercel-ai-gateway, envVars: [AI_GATEWAY_API_KEY] } ] }第 3 步设置默认模型{ agents: { defaults: { model: { primary: vercel-ai-gateway/anthropic/claude-opus-4.6 }, }, }, }这个默认模型引用与源码常量一致onboard.ts 中定义了VERCEL_AI_GATEWAY_DEFAULT_MODEL_REF vercel-ai-gateway/anthropic/claude-opus-4.6并注册到插件的manifestAuth.defaultModel。applyVercelAiGatewayConfig通过createAliasOnlyPresetAppliers生成应用器在 onboard 流程中把该引用写入配置。第 4 步验证模型可用openclaw models list --provider vercel-ai-gateway由于 OpenClaw 会自动发现 Gateway 的/v1/models目录上述命令以及聊天中的/models vercel-ai-gateway都会包含当前可用的模型引用例如vercel-ai-gateway/openai/gpt-5.5、vercel-ai-gateway/moonshotai/kimi-k2.6等。非交互式接入示例对于自动化部署或脚本化场景指南提供了完整的非交互命令一次性完成鉴权选择与密钥注入openclaw onboard --non-interactive --accept-risk --skip-health \ --mode local \ --auth-choice ai-gateway-api-key \ --ai-gateway-api-key $AI_GATEWAY_API_KEY其中--ai-gateway-api-key正是插件清单providerAuthChoices中声明的cliOption属于插件级 CLI 扩展参数。模型 ID 简写与归一化OpenClaw 在运行时会归一化 Claude 简写模型引用简写输入归一化后的模型引用vercel-ai-gateway/claude-opus-4.6vercel-ai-gateway/anthropic/claude-opus-4.6vercel-ai-gateway/opus-4.6vercel-ai-gateway/anthropic/claude-opus-4-6配置中两种写法都可以使用OpenClaw 会自动解析出规范的anthropic/...引用。这套行为由 openclaw.plugin.json 中的modelIdNormalization声明驱动aliases: { opus-4.6: claude-opus-4-6, sonnet-4.6: claude-sonnet-4-6 }, prefixWhenBareAfterAliasStartsWith: [ { modelPrefix: claude-, prefix: anthropic } ]即裸别名如opus-4.6先被替换为完整模型名claude-opus-4-6再对以claude-开头的裸模型名自动补上上游前缀anthropic。清单还声明了定价透传策略openRouter与liteLLM两种定价源均使用passthroughProviderModel: true直接按透传模型计价。高级配置守护进程的环境变量可见性如果 OpenClaw Gateway 以守护进程方式运行launchd/systemd必须确保AI_GATEWAY_API_KEY对该进程可见。仅在交互式 shell 中 export 的密钥除非显式导入环境否则对 launchd/systemd 守护进程不可见。正确做法是把密钥写入~/.openclaw/.env或通过env.shellEnv注入。Provider 路由机制Vercel AI Gateway 按模型引用前缀中的上游厂商名路由请求vercel-ai-gateway/anthropic/claude-opus-4.6经由 Anthropic 路由vercel-ai-gateway/openai/gpt-5.5经由 OpenAI 路由vercel-ai-gateway/moonshotai/kimi-k2.6经由 MoonshotAI 路由。一个AI_GATEWAY_API_KEY即可认证所有上游厂商这是该网关单端点多模型的核心价值。Thinking 等级/think选项在 OpenClaw 能识别上游前缀时跟随上游模型的推理配置vercel-ai-gateway/anthropic/...使用 Claude 的 thinking profile包括 Claude 4.6 模型的自适应adaptive默认档可信的vercel-ai-gateway/openai/...引用gpt-5.2及更新版本外加 Codex 变体直至gpt-5.1-codex额外暴露/think xhigh档其他命名空间引用保持标准推理等级除非其目录元数据声明了更高档位。源码级实现剖析以下实现细节均位于 extensions/vercel-ai-gateway 目录下与上述文档行为一一对应。插件入口与 provider 注册入口文件 index.ts 通过插件 SDK 的defineSingleProviderPluginEntry注册单一 provider关键钩子包括catalog.buildProvider以discoveryMode: strict构建实时 provider调用buildVercelAiGatewayProvidercatalog.buildStaticProvider静态目录兜底buildStaticVercelAiGatewayProviderresolveDynamicModel对未收录的模型 ID 做动态解析resolveThinkingProfile解析/think推理档位。模型目录静态兜底 实时发现models.ts 实现了两层目录策略静态兜底目录内置 4 个精选模型的完整元数据如anthropic/claude-opus-4.61M 上下文、128K 输出、含输入/输出/缓存读写的每百万 token 单价、openai/gpt-5.4系列与moonshotai/kimi-k2.6见 models.ts#L45-L99。静态目录的作用是保证离线或发现失败时仍有基础能力描述可用。实时发现discoverVercelAiGatewayModels通过 SDK 的buildLiveModelProviderConfig请求${base}/v1/modelsmodels.ts#L207-L229关键参数为缓存 TTL 60 秒、请求超时 5 秒fetch 经过fetchWithSsrFGuardSSRF 防护与withTrustedEnvProxyGuardedFetchMode双重守卫。对每个返回的模型行buildDiscoveredModelDefinition做如下归一化models.ts#L162-L205丢弃type非language的条目上下文窗口与最大输出 token 依次取响应字段 → 静态兜底 → 默认值默认200_000上下文、128_000输出定价字段input/output/input_cache_read/input_cache_write经toPerMillionCost换算为每百万 token 计价非法值回退为 0全零时回退到静态兜底或默认零成本tags中声明reasoning即视为推理模型声明vision即开放[text, image]输入模态。动态模型解析与输入模态provider-catalog.ts 中的resolveVercelAiGatewayModel对任意模型 ID包括实时目录里未预置的都能构造出可用的模型定义固定api: anthropic-messages与baseUrl: https://ai-gateway.vercel.sh并从 thinking profile 的存在性推导reasoning标志。输入模态判定分三级动态元数据声明了 image 优先采信否则内置图像模型清单VERCEL_AI_GATEWAY_IMAGE_MODEL_IDS覆盖 gpt-5.x 系列或匹配anthropic/claude-(opus|sonnet|haiku)-前缀的模型开放图像输入其余仅文本。测试用例 index.test.ts 验证了仅存在于实时目录的模型 ID 也能被内嵌 runner 正确解析断言其api、baseUrl与 provider 归属。Thinking profile 的实现thinking.ts 是/think行为的最终裁决者resolveVercelAiGatewayThinkingProfile按前缀分流OpenAI 前缀剥掉openai/前缀后若模型命中VERCEL_OPENAI_XHIGH_MODEL_IDS白名单thinking.ts#L20-L31包含gpt-5.5、gpt-5.4系列、gpt-5.2与 Codex 变体至gpt-5.1-codex则返回基础档off/minimal/low/medium/high外加xhighAnthropic 前缀剥掉anthropic/前缀后委托resolveClaudeThinkingProfile且仅当该 profile 含有 Vercel 特定档位adaptive/xhigh/max或自定义默认档时才接管避免用基础 profile 遮蔽目录元数据对应 thinking.ts#L71-L74 的注释说明其他前缀返回undefined交由通用推理等级处理。小结与延伸阅读该插件以一个环境变量、一个端点换取多厂商模型的统一接入安装渠道为 npm/ClawHub 双通道认证仅依赖AI_GATEWAY_API_KEY模型目录 60 秒 TTL 实时刷新并带静态兜底Claude 简写引用与/think xhigh等高级能力均由插件清单与源码精确声明。如需继续深入可阅读关联的提供方文档 Vercel AI gateway以及插件目录下的 provider-catalog.test.ts、thinking.test.ts 查看完整的边界测试覆盖。【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考