Vercel AI Gateway

Vercel AI Gateway 通过统一 API 提供对数百个模型的访问,只需一个端点。

  • 提供商:vercel-ai-gateway
  • 认证:AI_GATEWAY_API_KEY
  • API:兼容 Anthropic Messages
  • OpenClaw 会自动发现 Gateway 的 /v1/models 目录,因此 /models vercel-ai-gateway 会包含当前的模型引用,比如 vercel-ai-gateway/openai/gpt-5.4

快速开始

  1. 设置 API 密钥(推荐存储到 Gateway):
openclaw onboard --auth-choice ai-gateway-api-key
  1. 设置默认模型:
{
  agents: {
    defaults: {
      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
    },
  },
}

非交互模式示例

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

环境变量说明

如果 Gateway 以守护进程方式运行(launchd/systemd),确保 AI_GATEWAY_API_KEY 对该进程可用(比如写在 ~/.openclaw/.env 中或通过 env.shellEnv 设置)。

模型 ID 简写

OpenClaw 支持 Vercel 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