Vercel AI 网关
Vercel AI Gateway 提供了一个统一 API,让你可以通过单个端点访问数百个模型。
| 属性 | 值 |
|---|---|
| Provider | vercel-ai-gateway |
| 包 | @openclaw/vercel-ai-gateway-provider |
| 认证 | AI_GATEWAY_API_KEY |
| API | Anthropic Messages 兼容 |
| 基础 URL | https://ai-gateway.vercel.sh |
| 模型目录 | 通过 /v1/models 自动发现 |
Tip
OpenClaw 会自动发现 Gateway 的 /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。
快速开始¶
1. 安装插件
安装会自动应用于正在运行的 Gateway;否则将在下次启动时生效。参见 应用更改并检查。
2. 设置 API 密钥
3. 设置默认模型
4. 验证模型是否可用
非交互式示例¶
openclaw onboard --non-interactive --accept-risk --skip-health \
--mode local \
--auth-choice ai-gateway-api-key \
--ai-gateway-api-key "$AI_GATEWAY_API_KEY"
模型 ID 简写¶
OpenClaw 在运行时规范化 Claude 简写模型引用:
| 简写输入 | 规范化模型引用 |
|---|---|
vercel-ai-gateway/claude-opus-4.6 |
vercel-ai-gateway/anthropic/claude-opus-4.6 |
vercel-ai-gateway/opus-4.6 |
vercel-ai-gateway/anthropic/claude-opus-4-6 |
Tip
在配置中使用任一形式均可;OpenClaw 会自动解析规范的 anthropic/... 引用。
高级配置¶
守护进程的环境变量
如果 OpenClaw Gateway 作为守护进程(launchd/systemd)运行,请确保该进程可以访问 AI_GATEWAY_API_KEY。
Warning
仅在交互式 shell 中导出的密钥不会被 launchd/systemd 守护进程看到,除非显式导入该环境。请在 ~/.openclaw/.env 中或通过 env.shellEnv 设置密钥,以确保 gateway 进程能够读取它。
提供商路由
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 即可对所有上游提供商进行认证。
思考级别
当 OpenClaw 识别出上游模型前缀时,/think 选项会遵循该前缀。vercel-ai-gateway/anthropic/... 使用 Claude 思考配置,包括 Claude 4.6 模型的自动适应默认值。受信任的 vercel-ai-gateway/openai/... 引用(gpt-5.2 及更新版本,以及低至 gpt-5.1-codex 的 Codex 变体)会公开 /think xhigh。其他带命名空间的引用将保持标准推理级别,除非其目录元数据声明了更多级别。
应用归属
发往 ai-gateway.vercel.sh 的请求会携带 Vercel 文档中描述的应用归属请求头:HTTP-Referer: https://openclaw.ai 和 X-Title: OpenClaw。这也适用于 baseUrl 指向 AI Gateway 的自定义 provider id。自定义代理 baseUrl 不会获得任何归属请求头。
相关¶
选择提供商、模型引用和故障转移行为。
常规故障排查和常见问题解答。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw