OpenClaw 接入 Vercel AI Gateway统一模型网关的安装、鉴权与模型编排实战指南【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclawOpenClaw 通过官方插件openclaw/vercel-ai-gateway-provider将 Vercel AI Gateway 接入为vercel-ai-gateway模型提供方让你用一个AI_GATEWAY_API_KEY、一个统一端点访问 Anthropic、OpenAI、MoonshotAI 等数百个上游模型。本文完整梳理该插件的安装、鉴权、默认模型配置与验证流程并结合仓库源码深入讲解模型目录自动发现、模型 ID 归一化、思考thinking级别路由等底层实现帮助你快速完成网关接入并理解其工作机理。插件与提供方概览PropertyValueProvidervercel-ai-gatewayPackageopenclaw/vercel-ai-gateway-providerAuthAI_GATEWAY_API_KEYAPIAnthropic Messages compatibleBase URLhttps://ai-gateway.vercel.shModel catalogAuto-discovered via/v1/models从源码看该插件的入口文件 extensions/vercel-ai-gateway/index.ts 通过defineSingleProviderPluginEntry注册提供方其中PROVIDER_ID固定为vercel-ai-gateway插件清单 extensions/vercel-ai-gateway/openclaw.plugin.json 显示它默认启用enabledByDefault: true、随需激活activation.onStartup: false并声明了模型目录采用refreshable可刷新的发现模式。一个值得注意的细节插件把 API 类型声明为Anthropic Messages 兼容api: anthropic-messages这意味着无论上游模型来自哪家厂商OpenClaw 都通过 Anthropic Messages 协议与 Vercel AI Gateway 交互由网关在幕后完成协议转换。这是该插件实现统一访问的核心机制。快速上手四步接入1. 安装插件并重启网关openclaw plugins install openclaw/vercel-ai-gateway-provider openclaw gateway restart插件可通过 npm 或 ClawHub 两种途径安装clawhub:openclaw/vercel-ai-gateway-provider具体可参见插件参考文档 docs/plugins/reference/vercel-ai-gateway.md。安装后需要重启 Gateway 进程使插件生效。2. 设置 API Keyopenclaw onboard --auth-choice ai-gateway-api-key--auth-choice ai-gateway-api-key对应插件清单中声明的鉴权方式providerAuthChoices中choiceId: ai-gateway-api-key。该鉴权项还映射了一个 CLI 选项--ai-gateway-api-key key用于非交互式场景传入密钥。插件清单中同时声明了所需环境变量AI_GATEWAY_API_KEYsetup.providers[].envVars。3. 设置默认模型{ agents: { defaults: { model: { primary: vercel-ai-gateway/anthropic/claude-opus-4.6 }, }, }, }默认模型引用在插件源码 extensions/vercel-ai-gateway/onboard.ts 中也有体现VERCEL_AI_GATEWAY_DEFAULT_MODEL_REF vercel-ai-gateway/anthropic/claude-opus-4.6并配套一个别名Vercel AI Gateway用于引导onboard流程中的预设应用。4. 验证模型可用性openclaw models list --provider vercel-ai-gateway由于 OpenClaw 会自动发现网关的/v1/models目录因此无论是/models vercel-ai-gateway聊天命令还是上面的openclaw models list --provider vercel-ai-gateway都会包含当前的模型引用例如vercel-ai-gateway/openai/gpt-5.5、vercel-ai-gateway/moonshotai/kimi-k2.6。非交互式接入示例在 CI、脚本或容器初始化等场景下可以使用完全非交互的 onboard 命令一次性完成接入openclaw 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以本地模式运行 Gateway--auth-choice ai-gateway-api-key选择 Vercel AI Gateway API Key 鉴权方式--ai-gateway-api-key $AI_GATEWAY_API_KEY直接传入密钥与插件清单中cliFlag: --ai-gateway-api-key对应避免交互式输入。模型 ID 简写与归一化OpenClaw 会在运行时对 Claude 系列模型的简写引用做归一化处理Shorthand inputNormalized model 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两种形式都可以直接写进配置OpenClaw 会自动解析出规范的anthropic/...引用。这一行为的底层实现位于插件清单 extensions/vercel-ai-gateway/openclaw.plugin.json 的modelIdNormalization段aliases定义了opus-4.6 - claude-opus-4-6、sonnet-4.6 - claude-sonnet-4-6的别名映射prefixWhenBareAfterAliasStartsWith规定当裸模型 ID 在别名展开后以claude-开头时自动补上anthropic前缀从而得到anthropic/claude-opus-4-6这类带上游厂商命名空间的规范引用。也就是说补全anthropic前缀与把.归一化为-两步共同完成了上表中的归一化结果。高级配置守护进程下的环境变量如果 OpenClaw Gateway 以守护进程方式运行macOS 的 launchd 或 Linux 的 systemd必须确保AI_GATEWAY_API_KEY对该进程可见。警告仅在交互式 shell 中导出的密钥对 launchd/systemd 守护进程是不可见的除非显式导入该环境。请将密钥写入~/.openclaw/.env或通过env.shellEnv配置注入确保 Gateway 进程能够读取到它。上游路由Provider routingVercel AI Gateway 会根据模型引用中的前缀将每个请求路由到对应的上游厂商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即可对全部上游提供方完成鉴权无需为每家厂商分别维护密钥。从源码看插件对模型的输入能力判断也遵循同样的按前缀区分逻辑在 extensions/vercel-ai-gateway/provider-catalog.ts 中OpenAI 的gpt-5.x系列含gpt-5.3-codex、gpt-5.2-codex、gpt-5.1-codex等以及匹配anthropic/claude-(opus|sonnet|haiku)-正则的模型会被标记为支持[text, image]多模态输入。思考级别Thinking levels/think选项会跟随 OpenClaw 可识别的上游模型前缀vercel-ai-gateway/anthropic/...使用 Claude 思考画像thinking profileClaude 4.6 系列模型默认采用自适应adaptive思考级别受信任的vercel-ai-gateway/openai/...引用gpt-5.2及更新版本外加向下兼容至gpt-5.1-codex的 Codex 变体会额外开放/think xhigh级别其他带命名空间的引用除非其目录元数据声明了更多级别否则保持标准推理级别。该逻辑实现在 extensions/vercel-ai-gateway/thinking.ts 中BASE_OPENAI_THINKING_LEVELS定义了 OpenAI 基础思考级别off / minimal / low / medium / highVERCEL_OPENAI_XHIGH_MODEL_IDS列表gpt-5.5、gpt-5.5-pro、gpt-5.4、gpt-5.4-pro、gpt-5.4-mini、gpt-5.4-nano、gpt-5.3-codex、gpt-5.2、gpt-5.2-codex、gpt-5.1-codex命中后会追加xhigh级别对于anthropic/前缀调用resolveClaudeThinkingProfile解析 Claude 专属画像只有当 Claude 画像带有上游专属默认值或提升级别adaptive、xhigh、max时插件才接管思考画像解析否则回退到通用解析以避免遮蔽目录中的兼容性元数据。源码级深挖模型目录的自动发现机制文档中Auto-discovered via/v1/models背后有一套完整的发现管线位于 extensions/vercel-ai-gateway/models.ts端点与常量VERCEL_AI_GATEWAY_BASE_URL https://ai-gateway.vercel.sh发现端点拼接为${BASE_URL}/v1/models默认上下文窗口200_000默认最大输出128_000token默认成本字段均为 0缓存与超时发现结果缓存 TTL 为 60 秒VERCEL_AI_GATEWAY_DISCOVERY_CACHE_TTL_MS请求超时 5 秒VERCEL_AI_GATEWAY_DISCOVERY_TIMEOUT_MS避免冷启动阻塞严格模式插件的catalog.discoveryMode为strict即目录发现以必须可用为前提且获取请求通过fetchWithSsrFGuard做了 SSRF 防护、通过withTrustedEnvProxyGuardedFetchMode约束代理模式静态兜底目录插件内置了 4 个静态模型定义STATIC_VERCEL_AI_GATEWAY_MODEL_CATALOG作为发现失败或新模型的兜底元数据包括 Claude Opus 4.6100 万上下文窗口、GPT 5.4 / GPT 5.4 Pro20 万上下文窗口、Kimi K2.6262144 上下文窗口均带每百万 token 的成本参考值动态模型归一化buildDiscoveredModelDefinition会从网关返回的 JSON 中解析id / name / type / context_window / max_tokens / tags / pricing等字段type非language的条目会被过滤reasoning由tags中的reasoning标记或静态兜底决定vision能力由tags中的vision标记决定成本归一化网关返回的pricing.input / output / input_cache_read / input_cache_write通过toPerMillionCost换算为每百万 token的数值单位不一致时以静态兜底成本为准。正因为有了这套静态兜底 动态刷新的双层目录机制OpenClaw 才能在网关侧新增模型后自动感知refreshable同时在网关不可达时仍然能基于静态目录完成配置与模型引用解析。相关文档模型选择与提供方概念了解如何选择提供方、模型引用model ref与故障转移failover行为故障排查指南通用的故障排查与常见问题解答Vercel AI Gateway 插件参考插件的分发途径、暴露的 Provider 表面与安装说明。【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考