> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gateway AI Vercel

[Vercel AI Gateway](https://vercel.com/ai-gateway) menyediakan API terpadu untuk
mengakses ratusan model melalui satu endpoint.

| Properti      | Nilai                                   |
| ------------- | --------------------------------------- |
| Penyedia      | `vercel-ai-gateway`                     |
| Paket         | `@openclaw/vercel-ai-gateway-provider`  |
| Auth          | `AI_GATEWAY_API_KEY`                    |
| API           | Kompatibel dengan Anthropic Messages    |
| Katalog model | Ditemukan otomatis melalui `/v1/models` |

<Tip>
  OpenClaw menemukan katalog Gateway `/v1/models` secara otomatis, sehingga
  `/models vercel-ai-gateway` menyertakan ref model saat ini seperti
  `vercel-ai-gateway/openai/gpt-5.5` dan
  `vercel-ai-gateway/moonshotai/kimi-k2.6`.
</Tip>

## Memulai

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

  <Step title="Atur kunci API">
    Jalankan onboarding dan pilih opsi auth AI Gateway:

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

  <Step title="Atur model default">
    Tambahkan model ke konfigurasi OpenClaw Anda:

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

  <Step title="Verifikasi model tersedia">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --provider vercel-ai-gateway
    ```
  </Step>
</Steps>

## Contoh non-interaktif

Untuk penyiapan berskrip atau CI, teruskan semua nilai melalui baris perintah:

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

## Singkatan ID model

OpenClaw menerima ref model singkatan Vercel Claude dan menormalisasinya saat
runtime:

| Input singkatan                     | Ref model yang dinormalisasi                  |
| ----------------------------------- | --------------------------------------------- |
| `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>
  Anda dapat menggunakan singkatan atau ref model lengkap dalam konfigurasi Anda.
  OpenClaw menyelesaikan bentuk kanonis secara otomatis.
</Tip>

## Konfigurasi lanjutan

<AccordionGroup>
  <Accordion title="Variabel lingkungan untuk proses daemon">
    Jika OpenClaw Gateway berjalan sebagai daemon (launchd/systemd), pastikan
    `AI_GATEWAY_API_KEY` tersedia untuk proses tersebut.

    <Warning>
      Kunci yang diekspor hanya di shell interaktif tidak akan terlihat oleh
      daemon launchd/systemd kecuali lingkungan tersebut diimpor secara eksplisit.
      Atur kunci di `~/.openclaw/.env` atau melalui `env.shellEnv` untuk memastikan
      proses gateway dapat membacanya.
    </Warning>
  </Accordion>

  <Accordion title="Perutean penyedia">
    Vercel AI Gateway merutekan permintaan ke penyedia hulu berdasarkan prefiks
    ref model. Misalnya, `vercel-ai-gateway/anthropic/claude-opus-4.6` dirutekan
    melalui Anthropic, sementara `vercel-ai-gateway/openai/gpt-5.5` dirutekan
    melalui OpenAI dan `vercel-ai-gateway/moonshotai/kimi-k2.6` dirutekan melalui
    MoonshotAI. Satu `AI_GATEWAY_API_KEY` Anda menangani autentikasi untuk semua
    penyedia hulu.
  </Accordion>

  <Accordion title="Tingkat berpikir">
    Opsi `/think` mengikuti prefiks model hulu tepercaya ketika OpenClaw mengetahui
    kontrak penyedia hulu. `vercel-ai-gateway/anthropic/...` menggunakan profil
    berpikir Claude, termasuk default adaptif untuk model Claude 4.6.
    `vercel-ai-gateway/openai/gpt-5.4`, `gpt-5.5`, dan ref bergaya Codex mengekspos
    `/think xhigh` sama seperti penyedia langsung OpenAI/OpenAI Codex. Ref
    ber-namespace lain mempertahankan tingkat penalaran normal kecuali metadata
    katalognya mendeklarasikan lebih banyak.
  </Accordion>
</AccordionGroup>

## Terkait

<CardGroup cols={2}>
  <Card title="Pemilihan model" href="/id/concepts/model-providers" icon="layers">
    Memilih penyedia, ref model, dan perilaku failover.
  </Card>

  <Card title="Pemecahan masalah" href="/id/help/troubleshooting" icon="wrench">
    Pemecahan masalah umum dan FAQ.
  </Card>
</CardGroup>