OpenClaw + OmniaKey: tek provider, üç model ailesi

OpenClaw paketlenmiş bir assistant değil, bir framework'tür: agent loop, araç kullanımı ve kod düzenleme iskeletini verir; zekâ, bağladığınız provider'dan gelir. Bu yüzden dokunacağınız en önemli dosya provider config'tir — OmniaKey, Claude, GPT ve Gemini'ye aynı anda ulaşan tek OpenAI uyumlu giriş olarak buna uyar.

OmniaKey'i provider olarak ekleyin

Provider config ~/.openclaw/openclaw.json içinde durur. OmniaKey'i models.providers altına ekleyin:

{
  "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" }
        ]
      }
    }
  }
}

"mode": "merge" OpenClaw'a bu provider'ı mevcut config'inize eklemesini, tüm config'i değiştirmemesini söyler — zaten provider tanımlarınız varsa bu satırı tutun. Tek OpenAI uyumlu provider üç model ailesini kapsar: OmniaKey model id'sine göre yönlendirir, yani claude-opus-4-8, gpt-5.5 ve gemini-3.1-pro-preview aynı girişten çalışır.

Herkesin kaçırdığı adım: modeli allowlist'e ekleyin

Provider tanımlamak işin yalnızca yarısıdır. OpenClaw ayrıca modelin allowlist'te olmasını ister; aksi halde anahtar doğru olsa bile klasik model not allowed hatasını alırsınız. Bu da aynı openclaw.json dosyasına, models block'unun yanına girer — models ve agents kardeş top-level key'lerdir. provider/model-id biçimindeki tam referansı agents.defaults altına ekleyin:

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

Request body yalnızca model id'sini taşır; provider/model-id referansı OpenClaw'ın iç adıdır. Provider tanımı ve allowlist girişi ikisi de gereklidir ve farklı işler yapar — bu yüzden birçok kurulum provider'ı tanımlar, allowlist'i unutur ve takılır.

Doğrulayın

openclaw doctor

doctor config dosyasını, provider'ı, anahtar biçimini, canlı bağlantıyı ve model erişimini kontrol eder. Ardından openclaw models list OmniaKey modellerinizi göstermeli ve aktif modeli agents.defaults altında omniakey/gpt-5.5 — veya allowlist'e eklediğiniz herhangi bir id — olarak ayarlayabilmelisiniz.

OpenClaw'ı neden OmniaKey üzerinden yönlendirmeli?

Üç aile için tek anahtar ve tek bakiye, aylık plan olmadan token başına fatura — ve sessiz model ikamesi yok. OmniaKey allowlist'e eklediğiniz model id'sini çalıştırır; upstream kapalıysa, görev ortasında kod tabanınızı farklı düşünen "eşdeğer" bir modele sessizce geçmek yerine hatayı görürsünüz.

Kodlama ajanları rehberi diğer araçları da kapsar.