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
- Open Açıkçası)https://ai2save.com/keys.
- OpenAI / GPT model grubuna ait bir API Key oluşturun.
- 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çimseldirprovider-id/model-id.apiKeyDoğrudan yazılabilir"sk-..."; Ne zaman referansla${AI2SAVE_API_KEY}, Bu tanımlanmalıdırenv.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ı
- OpenClaw için sohbet arayüzü veya WebChat açın.
- Yeni bir sohbete başlayın ve "Hello, lütfen mevcut model adını rapor edin."
- Model rotasının, model rotanın gösterdiğini doğrulayın
ai2save/gpt-5.5. - İ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_KEYTanı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
baseUrlis'dirhttps://ai2save.com/v1, Ve kök adresini yazmayın. - Model listesi boş: Onayla
models.mode: "merge", ve bunu sağlamak içinmodels.providers.ai2save.models[]En az bir model içerir. - Kurulum tasarrufdan sonra etki almamıştı: Re-execute
openclaw doctor, Ve gerekirse, OpenClaw ve Gateway.