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 中导出的 key 对 launchd/systemd 守护进程不可见，除非该环境被显式导入。请将 key 设置在 ~/.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。其他命名空间引用则保持标准推理层级，除非其目录元数据声明了更多内容。

​
相关内容

模型选择

选择提供方、模型引用以及故障切换行为。

故障排查

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