Skip to main content
Vercel AI Gateway 提供统一 API，可通过单个端点 访问数百种模型。
OpenClaw 会自动发现 Gateway 网关的 /v1/models 目录，因此 /models vercel-ai-gateway 聊天命令和 openclaw models list --provider vercel-ai-gateway 都会包含当前的模型引用， 例如 vercel-ai-gateway/openai/gpt-5.5 和 vercel-ai-gateway/moonshotai/kimi-k2.6。

​
入门指南

1

安装插件

2

设置 API 密钥

3

设置默认模型

4

验证模型是否可用

​
非交互式示例

​
模型 ID 简写

OpenClaw 会在运行时规范化 Claude 简写模型引用：
配置中可以使用任一形式；OpenClaw 会自动解析规范的 anthropic/... 引用。

​
高级配置

如果 OpenClaw Gateway 网关以守护进程（launchd/systemd）运行，请确保 该进程可以使用 AI_GATEWAY_API_KEY。
仅在交互式 shell 中导出的密钥对 launchd/systemd 守护进程不可见， 除非显式导入该环境。请在 ~/.openclaw/.env 中或通过 env.shellEnv 设置密钥，以确保 Gateway 网关进程可以读取它。
Vercel AI Gateway 会根据模型引用前缀中指定的上游提供商路由每个请求。 例如，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 即可向所有上游提供商进行身份验证。
当 OpenClaw 能够识别上游模型前缀时，/think 选项会遵循该前缀。 vercel-ai-gateway/anthropic/... 使用 Claude 思考配置，包括 Claude 4.6 模型的自适应默认值。 可信的 vercel-ai-gateway/openai/... 引用（gpt-5.2 及更新版本， 以及低至 gpt-5.1-codex 的 Codex 变体）会公开 /think xhigh。其他带命名空间的引用会保留标准推理级别， 除非其目录元数据声明了更多级别。

​
相关内容

模型选择

选择提供商、模型引用和故障转移行为。

故障排查

常规故障排查和常见问题。