Vercel AI Gateway 配置教程

2025-07-10 · 4 分钟模型接入

概述

Vercel AI Gateway 是 Vercel 推出的统一 AI 访问层，通过单一 API 端点聚合了来自 Anthropic、OpenAI、Google、Meta 等数百个模型，无需为每家提供商分别管理 API Key 和 SDK 版本。对于已经在 Vercel 平台上部署应用的开发者，这是降低 AI 集成复杂度的便捷选项。OpenClaw 通过 vercel-ai-gateway 提供者接入该服务。

快速开始

首先确保你有 Vercel 账户并已在 Vercel Dashboard 开通 AI Gateway，获取访问凭据后设置环境变量：

export AI_GATEWAY_API_KEY="your-vercel-ai-gateway-key"

运行引导配置命令：

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

非交互方式完成配置：

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"

配置参数

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

Vercel AI Gateway 提供了灵活的模型引用格式，以下三种写法指向同一个模型：

// 完整路径（最明确）
"vercel-ai-gateway/anthropic/claude-opus-4.6"

// 提供商简写
"vercel-ai-gateway/claude-opus-4.6"

// 最短简写
"vercel-ai-gateway/opus-4.6"

推荐在团队协作或生产环境中使用完整路径，避免歧义。

支持的模型

Vercel AI Gateway 支持的模型通过 /v1/models 端点自动发现，涵盖主流提供商的模型，常用示例：

vercel-ai-gateway/anthropic/claude-opus-4.6 — Claude Opus 4.6
vercel-ai-gateway/anthropic/claude-sonnet-4-6 — Claude Sonnet 4.6
vercel-ai-gateway/openai/gpt-4o — GPT-4o
vercel-ai-gateway/openai/o3 — OpenAI o3 推理模型
vercel-ai-gateway/google/gemini-2.5-pro — Gemini 2.5 Pro
vercel-ai-gateway/meta/llama-3.1-70b-instruct — Llama 3.1 70B

完整可用模型列表：

openclaw models list | grep vercel-ai-gateway

注意事项

统一计费：通过 Vercel AI Gateway 的调用费用由 Vercel 统一结算，实际模型费率通常与各提供商官方价格相当，但可能附加少量 Gateway 服务费，使用前请确认 Vercel 的计费条款。

API 兼容性：Vercel AI Gateway 使用 Anthropic Messages API 格式作为统一接口规范，OpenClaw 已针对此格式适配，无需额外处理。

守护进程配置：在 launchd/systemd 环境下，将 AI_GATEWAY_API_KEY 写入 ~/.openclaw/.env 文件以确保后台服务能读取到凭据。

与直连的取舍：如果你只使用一两个 AI 提供商，直连提供商的延迟和成本通常更优；Vercel AI Gateway 的价值主要体现在需要频繁切换多提供商、希望统一日志和账单的场景。