Skip to content

Vercel AI Gateway

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

  • Provider:vercel-ai-gateway
  • Auth:AI_GATEWAY_API_KEY
  • API:兼容 Anthropic Messages
  • OpenClaw 自动发现 Gateway 的 /v1/models 目录,/models vercel-ai-gateway 会列出当前可用的模型引用,如 vercel-ai-gateway/openai/gpt-5.4

快速上手

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

非交互式配置示例

bash
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 配置)。养好你的龙虾,Key 不能缺。

模型 ID 简写

OpenClaw 支持 Vercel Claude 模型 ID 简写,运行时自动规范化:

  • 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