9.8 Vercel AI Gateway

模型提供商模型提供商

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

概述

Vercel AI Gateway 使用提供商标识符 vercel-ai-gateway，需要 AI_GATEWAY_API_KEY 进行认证。该服务保持与 Anthropic Messages API 的兼容性。

设置说明

认证设置

用户可以通过以下命令交互式配置 API 密钥：

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

模型配置

在配置文件中设置默认模型：

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

非交互式入门配置

对于自动化设置，可以使用以下命令：

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 进行配置。

关键信息

  • 提供商标识符：vercel-ai-gateway
  • 认证密钥：AI_GATEWAY_API_KEY
  • API 兼容性：Anthropic Messages API
注意
在后台服务模式下运行时，必须确保环境变量正确传递给服务进程。建议将密钥存储在 ~/.openclaw/.env 文件中。