Skip to main content

Documentation Index

Fetch the complete documentation index at: https://openclaw.zhcndoc.com/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 key

运行初始化并选择 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。其他命名空间引用会保持正常推理等级，除非其目录元数据声明了更多内容。

​
相关内容

模型选择

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

故障排查

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