ai2saveai2save

OpenClaw yapılandırma kılavuzu

OpenClaw, özel model sağlayıcıları aracılığıyla ekliyor models.providers. ai2save OpenAI Uyumlu arayüzü kullanır ve Base URL'si doldurulmalıdır https://ai2save.com/v1.

1. OpenClaw ve API anahtarını hazırlayın

OpenClaw zaten yüklüyse, kurulumunu atabilirsiniz:

npm install -g openclaw@latest
openclaw --version
  1. Open Açıkçası)https://ai2save.com/keys.
  2. OpenAI / GPT model grubuna ait bir API Key oluşturun.
  3. Tamamlananı kopyalayın sk-... Anahtar anahtarı.

2. OpenClaw yapılandırma dosyasını düzenleyin

OpenClaw için varsayılan yapılandırma dosyası:

~/.openclaw/openclaw.json

Windows genellikle JSON5'i destekler %USERPROFILE%\.openclaw\openclaw.json. Dosya, aşağıdaki yapıya göre mevcut konfigürasyona birleştirilebilir:

{
  env: {
    vars: {
      AI2SAVE_API_KEY: "sk-your-api-key",
    },
  },
  agents: {
    defaults: {
      model: {
        primary: "ai2save/gpt-5.5",
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      ai2save: {
        baseUrl: "https://ai2save.com/v1",
        apiKey: "${AI2SAVE_API_KEY}",
        api: "openai-completions",
        timeoutSeconds: 300,
        models: [
          {
            id: "gpt-5.5",
            name: "GPT 5.5",
            reasoning: true,
            input: ["text"],
            contextWindow: 200000,
          },
        ],
      },
    },
  },
}

Key Field Description:

  • models.providers.ai2save.baseUrl: dahil olmak zorunlu olmalıdır /v1.
  • api: "openai-completions": OpenClaw tarafından OpenAI için kullanılan arayüz türü uyumlu.
  • models[].id: Ai2save konsolunda açılan model ID ile tam olarak tutarlı olmalıdır.
  • agents.defaults.model.primary: Biçim biçimseldir provider-id/model-id.
  • apiKey Doğrudan yazılabilir "sk-..."; Ne zaman referansla ${AI2SAVE_API_KEY}, Bu tanımlanmalıdır env.vars.

Birden fazla model eklemek istiyorsanız, uygulama devam edin models Dizi ve değişim primary (Buna) ai2save/model-id Varsayılan olarak kullanmak istiyorsunuz.

3. Yapılandırmayı uygulayın ve kontrol edin

OpenClaw Gateway yapılandırma dosya değişiklikleri için dinleyecek ve bunları otomatik olarak uygulayacaktır.Eğer konfigürasyon hemen etki almazsa, uygulayın:

openclaw gateway restart

Ardından, modelin zaten OpenClaw'da ortaya çıktığını kontrol edin:

openclaw models list --provider ai2save

Varsayılan modeli ai2save:

openclaw models set ai2save/gpt-5.5

Model görünmüyorsa, teşhisleri çalıştırın ve yapılandırma hataları için kontrol edin:

openclaw doctor

4. İstek doğrulaması

  1. OpenClaw için sohbet arayüzü veya WebChat açın.
  2. Yeni bir sohbete başlayın ve "Hello, lütfen mevcut model adını rapor edin."
  3. Model rotasının, model rotanın gösterdiğini doğrulayın ai2save/gpt-5.5.
  4. İlk kez, sadece metin görevleri ile doğrulayın. Başarılı bir şekilde dosya işleme, tarayıcı ve uzun bağlam gibi daha karmaşık araçlar etkinleştirin.

OpenClaw, resmi olmayan OpenAI proxylar için otomatik olarak uyumluluk işleyecek, bu yüzden manuel olarak etkinleştirilmeye gerek yok developer role. Araç aramaları ile bir istisna varsa, ilk önce model ID'nin araç çağrılarını desteklediğini doğrulayın, o zaman süresi artırın.

5. Yaygın hatalar

  • 401 / geçersiz_api_key: AI2SAVE_API_KEY Tanımlanmamıştır, anahtar tam olarak kopyalanmaz veya anahtar gruplama maç yapmaz.
  • 404 / model bulunamadı: models[].id, primary, Ya da gerçek talep edilen model adı eşleşmez.
  • Bağlantı başarısız / boş yanıt: Kontrol edip kontrol etmek isteyip de kontrol edin baseUrl is'dir https://ai2save.com/v1, Ve kök adresini yazmayın.
  • Model listesi boş: Onayla models.mode: "merge", ve bunu sağlamak için models.providers.ai2save.models[] En az bir model içerir.
  • Kurulum tasarrufdan sonra etki almamıştı: Re-execute openclaw doctor, Ve gerekirse, OpenClaw ve Gateway.