跳转到主要内容
Vercel AI Gateway 提供统一 API，可通过单个端点访问数百个模型。
属性值
提供商vercel-ai-gateway
包@openclaw/vercel-ai-gateway-provider
凭证AI_GATEWAY_API_KEY
API兼容 Anthropic Messages
基础 URLhttps://ai-gateway.vercel.sh
模型目录通过 /v1/models 自动发现
OpenClaw 会自动发现 Gateway 网关 /v1/models 目录，因此 /models vercel-ai-gateway 聊天命令和 openclaw models list --provider vercel-ai-gateway 都会包含当前模型 ref，例如 vercel-ai-gateway/openai/gpt-5.5 和 vercel-ai-gateway/moonshotai/kimi-k2.6。

​
入门指南

1

安装插件

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

设置 API key

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 \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"

​
模型 ID 简写

OpenClaw 会在运行时规范化 Claude 简写模型 ref：
简写输入规范化后的模型 ref
vercel-ai-gateway/claude-opus-4.6vercel-ai-gateway/anthropic/claude-opus-4.6
vercel-ai-gateway/opus-4.6vercel-ai-gateway/anthropic/claude-opus-4-6
你可以在配置中使用任一形式；OpenClaw 会自动解析规范的 anthropic/... ref。

​
高级配置

如果 OpenClaw Gateway 网关以守护进程（launchd/systemd）运行，请确保 AI_GATEWAY_API_KEY 对该进程可用。
仅在交互式 shell 中导出的 key 不会对 launchd/systemd 守护进程可见， 除非显式导入该环境。请在 ~/.openclaw/.env 中或通过 env.shellEnv 设置该 key，以确保 Gateway 网关进程可以读取它。
Vercel AI Gateway 会将每个请求路由到模型 ref 前缀中命名的上游提供商。 例如，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/... ref（gpt-5.2 及更新版本，以及低至 gpt-5.1-codex 的 Codex 变体）会公开 /think xhigh。其他带命名空间的 ref 会保留标准推理级别，除非其目录元数据声明了更多级别。

​
相关

模型选择

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

故障排查

一般故障排查和常见问题。