跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Vercel AI Gateway 提供统一 API，可通过单一端点访问数百个模型。
属性值
提供商vercel-ai-gateway
认证AI_GATEWAY_API_KEY
API兼容 Anthropic Messages
模型目录通过 /v1/models 自动发现
OpenClaw 会自动发现 Gateway 网关 /v1/models 目录，因此 /models vercel-ai-gateway 会包含当前模型引用，例如 vercel-ai-gateway/openai/gpt-5.5 和 vercel-ai-gateway/moonshotai/kimi-k2.6。

​
入门指南

1

设置 API 密钥

运行新手引导并选择 AI Gateway 认证选项：
openclaw onboard --auth-choice ai-gateway-api-key
2

设置默认模型

将模型添加到你的 OpenClaw 配置：
{
  agents: {
    defaults: {
      model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
    },
  },
}
3

验证模型可用

openclaw models list --provider vercel-ai-gateway

​
非交互示例

对于脚本化或 CI 设置，请在命令行传入所有值： 
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"

​
模型 ID 简写

OpenClaw 接受 Vercel Claude 简写模型引用，并会在运行时将其规范化：
简写输入规范化后的模型引用
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
你可以在配置中使用简写或完全限定的模型引用。OpenClaw 会自动解析为规范形式。

​
高级配置

如果 OpenClaw Gateway 网关作为守护进程（launchd/systemd）运行，请确保 AI_GATEWAY_API_KEY 可供该进程使用。
仅在 ~/.profile 中设置的密钥不会对 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.4、gpt-5.5 和 Codex 风格的引用会像直接的 OpenAI/OpenAI Codex 提供商一样暴露 /think xhigh。其他带命名空间的引用会保留普通推理级别，除非其目录元数据声明了更多级别。

​
相关内容

模型选择

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

故障排除

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