> ## 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

[Vercel AI Gateway](https://vercel.com/ai-gateway) 提供了一个统一的 API，可通过单一端点访问数百种模型。

| 属性     | 值                                      |
| ------ | -------------------------------------- |
| 提供商    | `vercel-ai-gateway`                    |
| 软件包    | `@openclaw/vercel-ai-gateway-provider` |
| 认证     | `AI_GATEWAY_API_KEY`                   |
| API    | Anthropic Messages 兼容                  |
| 基础 URL | `https://ai-gateway.vercel.sh`         |
| 模型目录   | 通过 `/v1/models` 自动发现                   |

<Tip>
  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`。
</Tip>

## 开始使用

<Steps>
  <Step title="安装插件">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw plugins install @openclaw/vercel-ai-gateway-provider
    ```
  </Step>

  <Step title="设置 API 密钥">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --auth-choice ai-gateway-api-key
    ```
  </Step>

  <Step title="设置默认模型">
    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
        },
      },
    }
    ```
  </Step>

  <Step title="验证模型可用">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --provider vercel-ai-gateway
    ```
  </Step>
</Steps>

## 非交互式示例

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive --accept-risk --skip-health \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"
```

## 模型 ID 简写

OpenClaw 在运行时会规范化 Claude 的简写模型引用：

| 简写输入                                | 规范化后的模型引用                                     |
| ----------------------------------- | --------------------------------------------- |
| `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 会自动解析规范的
  `anthropic/...` 引用。
</Tip>

## 高级配置

<AccordionGroup>
  <Accordion title="守护进程的环境变量">
    如果 OpenClaw Gateway 作为守护进程运行（launchd/systemd），请确保
    `AI_GATEWAY_API_KEY` 对该进程可用。

    <Warning>
      仅在交互式 shell 中导出的 key 对 launchd/systemd 守护进程不可见，除非该环境被显式导入。请将
      key 设置在 `~/.openclaw/.env` 中，或通过 `env.shellEnv` 设置，以确保 gateway
      进程能够读取它。
    </Warning>
  </Accordion>

  <Accordion title="提供方路由">
    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` 可对所有上游提供方进行身份验证。
  </Accordion>

  <Accordion title="思考层级">
    当 OpenClaw 识别到 `/think` 选项时，会遵循上游模型前缀。`vercel-ai-gateway/anthropic/...` 使用 Claude 思考配置文件，
    包括 Claude 4.6 模型的自适应默认值。受信任的
    `vercel-ai-gateway/openai/...` 引用（`gpt-5.2` 及更新版本，以及向下到 `gpt-5.1-codex` 的 Codex
    变体）会暴露 `/think xhigh`。其他命名空间引用则保持标准推理层级，除非其目录元数据声明了更多内容。
  </Accordion>
</AccordionGroup>

## 相关内容

<CardGroup cols={2}>
  <Card title="模型选择" href="/concepts/model-providers" icon="layers">
    选择提供方、模型引用以及故障切换行为。
  </Card>

  <Card title="故障排查" href="/help/troubleshooting" icon="wrench">
    常规故障排查和常见问题。
  </Card>
</CardGroup>