# OpenClaw

> Daftarkan Vikey sebagai custom provider di OpenClaw lewat openclaw onboard.

OpenClaw mendaftarkan provider lewat perintah `openclaw onboard`. Vikey didaftarkan sebagai **custom provider** dengan API key.

## Langkah

1. Pasang atau perbarui OpenClaw:

    ```bash
    npm install -g openclaw@latest
    ```

2. Daftarkan Vikey. Ganti `API_KEY_KAMU` dan model sesuai kebutuhan:

    ```bash
    openclaw onboard --non-interactive --accept-risk \
      --auth-choice custom-api-key \
      --custom-provider-id vikey \
      --custom-base-url "https://api.vikey.ai/v1" \
      --custom-model-id "vikey/agent-gpt" \
      --custom-api-key "API_KEY_KAMU" \
      --custom-compatibility openai-responses \
      --gateway-port 18789 \
      --skip-health
    ```

3. Jalankan gateway OpenClaw dan pilih modelnya:

    ```bash
    openclaw gateway --port 18789 --verbose
    openclaw models set vikey/vikey/agent-gpt
    ```

### Arti tiap flag

| Flag | Fungsi |
| --- | --- |
| `--custom-provider-id vikey` | Nama provider di OpenClaw. Model dipanggil sebagai `vikey/<model-id>`. |
| `--custom-base-url` | Dengan `/v1`. |
| `--custom-model-id` | Model id Vikey, misalnya `vikey/agent-gpt` atau `anthropic/claude-sonnet-5.5`. |
| `--custom-api-key` | API key Vikey. Kalau flag ini tidak diisi, OpenClaw membaca variabel `CUSTOM_API_KEY`. |
| `--custom-compatibility` | Format API. Vikey mendukung `openai-responses`, `openai` (chat completions), dan `anthropic`. |

**Cek versi OpenClaw kamu**

Pilihan `openai-responses` baru ada di OpenClaw versi 2026.6 ke atas. Versi lebih lama hanya mengenal `openai` dan `anthropic`, jadi pakai `--custom-compatibility openai` kalau perintah di atas ditolak. Jalankan `openclaw onboard --help` untuk melihat flag yang didukung versimu.

## Masalah umum

| Yang kamu lihat | Penyebab | Solusi |
| --- | --- | --- |
| Flag `--custom-compatibility` ditolak | Versi OpenClaw lama | Perbarui OpenClaw, atau pakai nilai `openai` |
| `401` | API key salah | Ulangi langkah 2 dengan key yang benar |
| `Model '...' not found` | Model id salah ketik | Salin id dari [halaman harga](https://vikey.ai/pricing) |

Source: https://docs.vikey.ai/agents/openclaw/