Vercel AI 网关

Vercel AI Gateway 提供统一的 API，通过单个端点访问数百个模型。

属性	值
提供商	`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. 安装插件

openclaw plugins install @openclaw/vercel-ai-gateway-provider

安装会自动应用于正在运行的 Gateway；否则将在下次启动时生效。参见应用更改并检查。

2. 设置 API 密钥

openclaw onboard --auth-choice ai-gateway-api-key

3. 设置默认模型

{
  agents: {
    defaults: {
      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
    },
  },
}

4. 验证模型可用

openclaw models list --provider vercel-ai-gateway

非交互式示例¶

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 的自定义提供商 ID。自定义代理 baseUrl 不会获得归属头。

模型选择

选择提供商、模型引用和故障转移行为。

故障排除

通用故障排除和常见问题。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw