Cara mengatur OpenClaw dengan OmniaKey: Provider dan allowlist model

Jika Anda mencari cara mengatur OpenClaw API, bedakan dua langkah: mendefinisikan Provider dan mengizinkan model. OpenClaw menyediakan agent loop dan tools; Provider menyediakan model yang memberi jawaban.

Tambahkan OmniaKey sebagai Provider

Konfigurasi berada di ~/.openclaw/openclaw.json. Tambahkan OmniaKey di bawah models.providers:

{
  "models": {
    "mode": "merge",
    "providers": {
      "omniakey": {
        "baseUrl": "https://api.omniakey.com/v1",
        "apiKey": "your-omniakey-api-key",
        "api": "openai-completions",
        "models": [
          { "id": "claude-opus-4-8" },
          { "id": "gpt-5.5" },
          { "id": "gemini-3.1-pro-preview" },
          { "id": "grok-4.5" }
        ]
      }
    }
  }
}

mode: merge menambahkan Provider tanpa mengganti konfigurasi yang ada. Gunakan key asli, tetapi jangan commit atau membagikannya. Salin model ID yang tepat dari katalog saat ini.

Langkah yang sering terlupakan: allowlist model

Definisi Provider saja belum cukup. OpenClaw juga mengharuskan model ada di allowlist. Di file yang sama, tambahkan agents sejajar dengan models:

{
  "agents": {
    "defaults": {
      "models": [
        "omniakey/claude-opus-4-8",
        "omniakey/gpt-5.5",
        "omniakey/gemini-3.1-pro-preview",
        "omniakey/grok-4.5"
      ],
      "model": "omniakey/claude-opus-4-8"
    }
  }
}

Request body memakai model ID; provider/model-id adalah referensi internal OpenClaw. Keduanya wajib. Tanpa allowlist, Anda bisa mendapat model not allowed meski key benar.

Verifikasi

openclaw doctor
openclaw models list

doctor memeriksa file konfigurasi, Provider, format key, koneksi langsung, dan akses model. Setelah itu Anda dapat memilih omniakey/gpt-5.5 di agents.defaults.

Mengapa menggunakan OmniaKey

Satu key dan satu saldo untuk Claude, GPT, Gemini, dan Grok, dengan biaya per token. Model ID yang diizinkan adalah model yang dijalankan, tanpa penggantian diam-diam.

Panduan coding agent mencakup alat lainnya.