Appearance
OpenClaw 接入 Vercel AI Gateway 后，只需一个 AI_GATEWAY_API_KEY 就能通过统一端点调用数百个模型，网关自动从 /v1/models 发现可用模型。使用 openclaw onboard --auth-choice ai-gateway-api-key 设置 key，模型 ID 支持简写（如 vercel-ai-gateway/opus-4.6），用 openclaw models list --provider vercel-ai-gateway 验证。守护进程场景需在 ~/.openclaw/.env 中持久化环境变量。
OpenClaw 接入配置 Vercel AI Gateway 统一模型入口
Vercel AI Gateway 通过单一端点提供对数百款模型的统一访问。
| Property | Value |
|---|---|
| Provider | vercel-ai-gateway |
| Auth | AI_GATEWAY_API_KEY |
| API | Anthropic Messages compatible |
| Model catalog | Auto-discovered via /v1/models |
TIP
OpenClaw 自动发现 Gateway 的 /v1/models 目录，因此 /models vercel-ai-gateway 会列出当前可用的模型引用，例如 vercel-ai-gateway/openai/gpt-5.5 和 vercel-ai-gateway/moonshotai/kimi-k2.6。
怎么配置 Vercel AI Gateway
设置 API Key
运行引导命令并选择 AI Gateway 认证选项：
```bash
openclaw onboard --auth-choice ai-gateway-api-key
```
设置默认模型
将模型加入 OpenClaw 配置文件：
```json5
{
agents: {
defaults: {
model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
},
},
}
```
验证模型可用
```bash
openclaw models list --provider vercel-ai-gateway
```
非交互式示例（CI 脚本使用）
bash
openclaw onboard --non-interactive \
--mode local \
--auth-choice ai-gateway-api-key \
--ai-gateway-api-key "$AI_GATEWAY_API_KEY"模型 ID 简写
OpenClaw 支持 Vercel Claude 模型 ID 简写，运行时自动规范化：
| 简写输入 | 规范化后的模型引用 |
|---|---|
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 |
TIP
配置中可以使用简写或完整引用，OpenClaw 自动解析规范形式。
高级配置
守护进程的环境变量
如果 OpenClaw Gateway 以守护进程（launchd/systemd）运行，需要确保 `AI_GATEWAY_API_KEY` 对该进程可见。
WARNING
仅在交互式 shell 中导出的 key 对 launchd/systemd 守护进程不可见，除非显式导入环境。请将 key 写入 `~/.openclaw/.env` 或通过 `env.shellEnv` 配置，确保网关进程能读取。
Provider 路由
Vercel AI Gateway 根据模型引用前缀将请求路由到上游 Provider。例如，`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` 处理所有上游 Provider 的认证。
思考层级（/think）
`/think` 选项遵循已知的上游模型前缀契约。`vercel-ai-gateway/anthropic/...` 使用 Claude 思考配置，包括 Claude 4.6 模型的默认自适应值。`vercel-ai-gateway/openai/gpt-5.4`、`gpt-5.5` 以及 Codex 风格的引用会暴露 `/think xhigh` 选项（与直接 OpenAI/OpenAI Codex Provider 一致）。其他命名空间的引用保持正常的推理层级，除非其目录元数据声明了更多层级。
常见问题
怎么确认 Vercel AI Gateway 在 OpenClaw 中配置成功？
运行 openclaw models list --provider vercel-ai-gateway，如果返回模型列表说明 key 和连接正常。也可以用一条消息测试，看是否能正常调用模型。
守护进程模式下 Vercel AI Gateway 不生效怎么解决？
检查 AI_GATEWAY_API_KEY 是否被守护进程读取。交互 shell 中 export 的变量对 launchd/systemd 不可见，必须将 key 写入 ~/.openclaw/.env 或配置 env.shellEnv，然后重启守护进程。
Vercel AI Gateway 支持哪些上游 Provider？
根据模型引用前缀路由，例如 vercel-ai-gateway/anthropic/... 走 Anthropic，vercel-ai-gateway/openai/... 走 OpenAI，vercel-ai-gateway/moonshotai/... 走 MoonshotAI，以及其他数百个 Provider。一个 key 即可管理所有上游。
Related
模型选择
选择 Provider、模型引用和故障回退行为。
故障排除
通用故障排除和 FAQ。