OpenClaw 接入 Vercel AI Gateway：统一多模型网关的安装、鉴权与模型路由实战

OpenClaw 接入 Vercel AI Gateway统一多模型网关的安装、鉴权与模型路由实战【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclawVercel AI Gateway 提供单一聚合端点让开发者通过一套 API 访问数百个上游模型。本文以 OpenClaw 官方 provider 插件openclaw/vercel-ai-gateway-provider为核心完整讲解安装、API Key 鉴权、默认模型配置、非交互式部署、模型 ID 简写归一化与think思考等级解析并辅以插件源码如 provider-catalog.ts、models.ts、thinking.ts验证底层行为。读完本文你可以把 OpenClaw 的 Agent 流量统一收敛到 Vercel AI Gateway用一把 Key 路由 Anthropic、OpenAI、MoonshotAI 等任意上游模型。一、插件概览与核心事实Vercel AI Gateway 以统一 API 聚合数百个模型OpenClaw 通过官方 provider 插件接入。插件注册的核心事实如下依据 docs/providers/vercel-ai-gateway.md 与 openclaw.plugin.json属性值Provider 标识vercel-ai-gateway包名openclaw/vercel-ai-gateway-provider鉴权环境变量AI_GATEWAY_API_KEYAPI 协议Anthropic Messages 兼容anthropic-messagesBase URLhttps://ai-gateway.vercel.sh模型目录通过/v1/models自动发现auto-discovered从 index.ts 的入口代码可以看到插件通过defineSingleProviderPluginEntry注册了 provider 的完整能力模型目录采用strict发现模式支持动态模型解析、thinking profile 解析并内置默认模型 ref见 onboard.ts 中VERCEL_AI_GATEWAY_DEFAULT_MODEL_REF vercel-ai-gateway/anthropic/claude-opus-4.6。同时 openclaw.plugin.json 表明该插件默认启用enabledByDefault: true、按需激活onStartup: false模型目录可刷新refreshable并声明了AI_GATEWAY_API_KEY环境变量。二、快速开始安装、鉴权、设默认模型、验证1. 安装插件openclaw plugins install openclaw/vercel-ai-gateway-provider安装包同时发布到 npm 与 ClawHub见 package.json 的install字段默认安装渠道为 npm。宿主版本要求2026.6.9。2. 配置 API Key交互式openclaw onboard --auth-choice ai-gateway-api-keyai-gateway-api-key是插件在 openclaw.plugin.json 的providerAuthChoices中注册的鉴权选项method为api-key对应 CLI flag--ai-gateway-api-keysecret 支持应用引导式录入appGuidedSecret: true。鉴权后凭据写入AI_GATEWAY_API_KEY。3. 设置默认模型在 OpenClaw 配置中指定默认模型例如默认使用 Claude Opus 4.6{ agents: { defaults: { model: { primary: vercel-ai-gateway/anthropic/claude-opus-4.6 }, }, }, }4. 验证模型可用openclaw models list --provider vercel-ai-gateway由于模型目录是自动发现的/models vercel-ai-gateway聊天命令与上述 CLI 都会展示当前模型 ref例如vercel-ai-gateway/openai/gpt-5.5、vercel-ai-gateway/moonshotai/kimi-k2.6。三、非交互式部署示例在 CI 或服务器环境中可跳过健康检查与风险确认完成一次性 onboardopenclaw onboard --non-interactive --accept-risk --skip-health \ --mode local \ --auth-choice ai-gateway-api-key \ --ai-gateway-api-key $AI_GATEWAY_API_KEY各参数含义--non-interactive完全非交互模式--accept-risk接受风险评估提示--skip-health跳过健康检查--mode local本地运行模式--auth-choice ai-gateway-api-key选择 Vercel AI Gateway API Key 鉴权方式--ai-gateway-api-key $AI_GATEWAY_API_KEY从环境变量注入 Key与 openclaw.plugin.json 中cliFlag: --ai-gateway-api-key的定义一致。四、模型 ID 简写与归一化OpenClaw 在运行时对 Claude 简写 ref 做归一化见 openclaw.plugin.json 的modelIdNormalization简写输入归一化后的模型 refvercel-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归一化规则包含两层opus-4.6、sonnet-4.6等别名映射为claude-opus-4-6、claude-sonnet-4-6以claude-开头的裸别名自动补anthropic前缀。两种写法都可在配置中使用OpenClaw 会自动解析为规范的anthropic/...ref。五、高级配置守护进程、路由与思考等级环境变量对守护进程的可见性若 OpenClaw Gateway 以守护进程launchd/systemd运行必须确保AI_GATEWAY_API_KEY对目标进程可见。仅在交互式 shell 中导出的 Key 对守护进程不可见需显式写入~/.openclaw/.env或通过env.shellEnv注入否则 Gateway 进程读不到 Key。Provider 路由机制Vercel AI Gateway 依据模型 ref 前缀把请求路由到对应上游。例如vercel-ai-gateway/anthropic/claude-opus-4.6→ Anthropicvercel-ai-gateway/openai/gpt-5.5→ OpenAIvercel-ai-gateway/moonshotai/kimi-k2.6→ MoonshotAI。一把AI_GATEWAY_API_KEY即可鉴权全部上游 provider。从源码看models.ts 的静态目录就包含anthropic/claude-opus-4.6、openai/gpt-5.4系列与moonshotai/kimi-k2.6等条目印证了多上游前缀并存的设计。思考thinking等级解析/think选项跟随 OpenClaw 可识别的上游前缀vercel-ai-gateway/anthropic/...使用 Claude thinking profileClaude 4.6 模型包含adaptive自适应默认等级受信任的vercel-ai-gateway/openai/...refgpt-5.2及更新以及低至gpt-5.1-codex的 Codex 变体额外开放/think xhigh其他带命名空间的 ref 保持标准思考等级除非目录元数据声明更多。源码实现位于 thinking.tsresolveVercelAiGatewayThinkingProfile先剥离受信任的openai/、anthropic/前缀再分别匹配VERCEL_OPENAI_XHIGH_MODEL_IDS列表与resolveClaudeThinkingProfile。测试 thinking.test.ts 验证了openai/gpt-5.4返回含xhigh的六级列表、anthropic/claude-opus-4.6返回含adaptive默认等级而openai/gpt-4.1与acme/gpt-5.4不受信任命名空间则返回undefined回落到通用解析。六、模型目录发现与静态兜底插件通过GET https://ai-gateway.vercel.sh/v1/models自动发现模型目录models.ts 中定义了关键运行时参数发现超时5000ms目录缓存 TTL60000ms动态模型未命中静态目录时的默认值上下文窗口200_000、最大输出128_000token、默认成本为 0。发现过程会解析 Vercel 返回的context_window、max_tokens、tags如reasoning、vision与pricing字段定价按每百万 token 归一化。插件还内置了anthropic/claude-opus-4.6、openai/gpt-5.4及-pro、moonshotai/kimi-k2.6四个静态兜底模型当动态发现不可用时可保证基本可用性。在静态目录之外provider-catalog.ts 还维护了一份图片能力模型 ID 白名单覆盖openai/gpt-5.5系列至gpt-5.1-codex以及 Claude opus/sonnet/haiku 前缀模型用于将input能力声明为[text, image]。对动态发现的模型如custom/provider-modelindex.test.ts 验证了运行时解析会返回api: anthropic-messages、baseUrl: https://ai-gateway.vercel.sh确保未收录模型也能以 Anthropic Messages 协议工作。七、相关文档导航模型选择、provider 与故障转移模型与 provider 概念通用故障排查与 FAQTroubleshooting插件源码extensions/vercel-ai-gateway 目录下的api.ts、models.ts、thinking.ts、onboard.ts、provider-catalog.ts及对应测试。【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考