Moltbot → Clawdbot → OpenClaw yeniden adlandırma döngüsünü takip ettiyseniz, muhtemelen herkesle aynı pratik soruyu soruyorsunuzdur:
“Neler için ödeme yapmam gerekiyor ve OpenClaw’u güvenilir bir şekilde çalıştırmak için hangi anahtarlar gerekli?”
Bu rehber size pazarlama metni değil, teknik bir yanıt verecektir. Bunu mimari, özellik yüzeyi, maliyet modeli ve operasyonel risk açısından inceleyeceğiz.
Kısa cevap
OpenClaw genellikle tek başına barındırılan bir model değil, bir orkestratördür. Çoğu kurulumda şunlara ihtiyacınız vardır:
- En az bir LLM sağlayıcı API anahtarı (akıl yürütme/sohbet/araç kullanımı için)
- İsteğe bağlı gömme (embedding) sağlayıcı anahtarı (eğer anlamsal bellek/geri çağırma kullanıyorsanız)
- İsteğe bağlı yeniden sıralayıcı (reranker) anahtarı (eğer RAG yığınınız yeniden sıralama kullanıyorsa)
- İsteğe bağlı web/arama API anahtarı (göz atma araçları için)
- İsteğe bağlı konuşma anahtarları (sesli iş akışları için STT/TTS)
- İsteğe bağlı gözlemlenebilirlik (observability) anahtarı (LangSmith, Helicone, OpenTelemetry arka ucu vb.)
- Bulut/çalışma zamanı aboneliği sadece yönetilen altyapı (örn. DigitalOcean droplet'ları, yönetilen VT, nesne depolama) dağıtıyorsanız.
Her zaman bunların hepsine ihtiyacınız yoktur.
Minimum bir kurulum, bir LLM anahtarı ve yerel depolama ile çalışabilir.
OpenClaw topluluğunda bu neden kafa karıştırıcı?
OpenClaw ile ilgili topluluk paylaşımları ("heartbeat"ler, yeniden adlandırma çalkantısı, üretim eğitimleri, sanal ortam) tek bir temel gerçeği yansıtır:
- İnsanlar OpenClaw'u monolitik bir SaaS bekleyerek kurarlar.
- Ancak OpenClaw genellikle birden çok harici hizmet için bir kontrol düzlemi gibi davranır.
Bu nedenle "abonelik ayak iziniz", hangi özellikleri etkinleştirdiğinize bağlıdır.
Faydalı bir zihinsel model:
- OpenClaw çekirdeği: yönlendirme, araç orkestrasyonu, bellek soyutlamaları, aracı döngüleri
- Sağlayıcılarınız: modeller, vektörler, arama, telemetri, depolama
- Altyapınız: işlem gücü + sırlar + ağ + kalıcılık
Kimlik bilgisi matrisi: özellik → anahtar/abonelik
| OpenClaw yeteneği | Genellikle gerekli | Tipik örnekler |
|---|---|---|
| Sohbet/Akıl yürütme | LLM API anahtarı | OpenAI, Anthropic, Groq, yerel ağ geçidi |
| Araç çağırma aracısı | Araç/fonksiyon desteği olan LLM anahtarı | Yukarıdakiyle aynı |
| Uzun süreli anlamsal bellek | Gömme (Embedding) anahtarı + vektör VT kimlik bilgileri | OpenAI/Cohere gömmeleri + Pinecone/Weaviate/pgvector |
| Arama/göz atma aracı | Arama API anahtarı | Tavily, SerpAPI, özel tarayıcı arka ucu |
| Kod yürütme / sanal ortam | Sanal ortam hizmet belirteci | kendi kendine barındırılan kapsayıcı çalışma zamanı, güvenli sanal ortam araçları |
| Ses girişi/çıkışı | STT/TTS anahtarları | Deepgram, ElevenLabs, bulut konuşma API'leri |
| İzleme/Denetleme | Gözlemlenebilirlik belirteci | LangSmith, Helicone, OTLP toplayıcı kimlik doğrulaması |
| Ekip özellikleri | Barındırılan OpenClaw/kuruluş aboneliği (eğer uygulanabilirse) | proje/kuruluş koltukları, barındırılan kontrol düzlemi |
Sadece "sohbet + basit araçlar"a ihtiyacınız varsa, bir model anahtarı yeterlidir.
Minimum, pratik kurulumlar
1) Yerel geliştirme başlangıcı (en düşük maliyetli)
- 1 LLM anahtarı
- Yerel SQLite/Postgres
- Gömme yok, yeniden sıralayıcı yok
- Barındırılan izleme yok
Bunu, orkestrasyon mantığını ve istem davranışını doğrulamak için kullanın.
2) RAG'ye hazır hazırlık ortamı
- LLM anahtarı
- Gömme (Embedding) anahtarı
- Vektör VT kimlik bilgileri
- İsteğe bağlı yeniden sıralayıcı (reranker) anahtarı
- İsteğe bağlı arama API anahtarı
Bunu, geri çağırma yoğun iş yüklerinde kalite testi için kullanın.
3) Üretim aracı yığını
- Birincil + yedek LLM anahtarları
- Gömme (Embedding) + vektör VT kimlik bilgileri
- Arama/göz atma anahtarı
- Gözlemlenebilirlik belirteci
- Sanal ortam yürütme belirteci/çalışma zamanı
- Bulut altyapısı aboneliği (işlem gücü, VT, nesne depolama, sırlar)
Bunu, çalışma süresi ve güvenliğin önemli olduğu durumlarda kullanın.
Abonelik sayısını etkileyen mimari ödünleşimleri
Ödünleşim 1: Tek sağlayıcılığa karşı çok sağlayıcılı yönlendirme
- Tek sağlayıcılı: daha basit kimlik doğrulama, daha kolay faturalandırma
- Çok sağlayıcılı: daha iyi esneklik ve fiyat arbitrajı, daha fazla anahtar yönetimi karmaşıklığı
Model yedekliliği (örn. karmaşık görevler için premium model, "heartbeat"ler için daha ucuz model) uyguluyorsanız, muhtemelen birden çok anahtar bulundurursunuz.
Ödünleşim 2: Barındırılan vektör VT'ye karşı pgvector kendi kendine barındırılan
- Barındırılan vektör VT: hızlı başlatma, ek fatura ve API belirteci
- Kendi kendine barındırılan pgvector: daha az satıcı anahtarı, daha fazla operasyonel yük
Ödünleşim 3: Yönetilen gözlemlenebilirliğe karşı kendi kendine loglar
- Yönetilen izleme: daha hızlı kök neden analizi, ek belirteç/maliyet
- Kendi kendine: daha düşük doğrudan maliyet, daha uzun hata ayıklama süresi
Aracı sistemlerinde, hata ayıklama süresi genellikle gizli maliyet merkezidir. Bunu çok erken optimize etmeyin.
Maliyet kontrol modeli: “önce ucuz kontroller, modeller sadece gerektiğinde”
Toplulukta tartışılan bir model, "heartbeat" geçit sistemidir: pahalı model çağrılarından önce düşük maliyetli kontroller çalıştırın.
Pratik uygulama:
- Belirleyici kontrollerle yeniliği/durumu doğrula
- Kural tabanlı korumaları çalıştır
- Ucuz model katmanını çağır
- Sadece güven düştüğünde premium modele yükselt
Bu, anahtar stratejinizi doğrudan değiştirir:
- Her katman için ayrı anahtarlar/projeler tutun
- Her sağlayıcı için bütçe üst sınırları ekleyin
- Niyet sınıfına ve güven puanına göre yönlendirin
Önerilen ortam değişkeni düzeni
Döndürme ve olay müdahalesinin kolay olması için açık, ad alanlı değişkenler kullanın.
Çekirdek model yönlendirme
OPENCLAW_LLM_PRIMARY_PROVIDER=openai OPENCLAW_LLM_PRIMARY_KEY=... OPENCLAW_LLM_FALLBACK_PROVIDER=anthropic OPENCLAW_LLM_FALLBACK_KEY=...Geri çağırma
OPENCLAW_EMBED_PROVIDER=openai OPENCLAW_EMBED_KEY=... VECTOR_DB_URL=... VECTOR_DB_API_KEY=...Araçlar
SEARCH_API_KEY=... SANDBOX_API_TOKEN=...Gözlemlenebilirlik
LANGSMITH_API_KEY=... OTEL_EXPORTER_OTLP_ENDPOINT=... OTEL_EXPORTER_OTLP_HEADERS=authorization=Bearer ...Güvenlik
OPENCLAW_ENCRYPTION_KEY=...İpuçları:
- Bir anahtarı geliştirme/hazırlık/üretim ortamları arasında asla yeniden kullanmayın
- En az üç ayda bir döndürün
- Belirteçleri en az ayrıcalığa göre sınırlandırın
- Sağlayıcıya özel hız sınırlama panellerini yer imlerine ekleyin
Güvenlik ve sanal ortam: Atlamaktan pişman olacağınız abonelikler
Eğer OpenClaw aracınız kod yürütür, web'e göz atar veya dosya sistemi/ağ araçlarına dokunursa, bir sanal ortam katmanı ekleyin. Güvenli sanal ortamlar üzerine topluluk odağı haklıdır.
Minimumda:
- Ağ çıkış kontrolleri
- Geçici yürütme ortamları
- Kaynak kotaları (CPU, bellek, çalışma zamanı)
- Komut izin/reddetme politikaları
- Dosya bağlama kısıtlamaları
Bu, başka bir hizmet/belirteç getirebilir, ancak felaket riskini azaltır.
Anahtar kurulumunuzu Apidog ile test etme
Anahtarları bağladıktan sonra, tekrarlanabilir API doğrulamasına ihtiyacınız vardır. İşte Apidog'un doğal olarak uyduğu yer burasıdır.
Apidog'u kullanarak:
- OpenClaw ağ geçidi API'lerinizi bir OpenAPI spesifikasyonunda tanımlayın
- Ortamlar arasında (dev/hazırlık/üretim) otomatik testler çalıştırın
- Yanıt yapısı, araç çıktıları ve hata zarfları için görsel onaylar ekleyin
- Yedekleme mantığını test etmek için sağlayıcı hatalarını akıllı taklit (smart mock) ile simüle edin
- Dahili ekibiniz için etkileşimli belgeler yayınlayın
Hızla ilerliyorsanız, bu, anahtar/konfigürasyon kaymasının üretimi sessizce bozmasını engeller.
Otomatikleştirmelisiniz örnek test senaryoları
- Eksik anahtar yolu: 401/500 işleme ve açık hata mesajlaşmasını doğrula
- Hız sınırlama yolu: sağlayıcı 429'u simüle et ve yedekleme yönlendirmesini onayla
- Bütçe koruma yolu: eşik aşıldığında pahalı model kullanımını reddet
- Sanal ortam reddetme yolu: engellenen araç çağrılarının güvenli bir şekilde başarısız olmasını sağla
- RAG düşüş yolu: gömme/vektör kesintisi zarifçe bozulmalı
Apidog'da bunları senaryo paketleri olarak gruplayabilir ve bunları CI/CD'de yayın kapısı olarak çalıştırabilirsiniz.
“OpenClaw bozulduğunda” hata ayıklama kontrol listesi
Çoğu kesinti kimlik bilgileri veya kotalardan kaynaklanır, orkestrasyon hatalarından değil.
Bu sırayla kontrol edin:
- Anahtar varlığı: Ortam değişkenleri çalışma zamanı kapsayıcısına yüklendi mi?
- Anahtar kapsamı: Belirteç, gerekli model uç noktalarına erişebiliyor mu?
- Hız limitleri/kota: Sağlayıcı paneli kısıtlamayı (throttling) gösteriyor mu?
- Yanlış uç nokta bölgesi: Model/anahtar farklı bir bölgeye mi bağlı?
- Saat kayması / kimlik doğrulama başlıkları: Zaman kayması nedeniyle imzalı istekler başarısız mı oluyor?
- Yedekleme devre dışı: Yapılandırma hatası ikincil sağlayıcı kullanımını mı engelliyor?
- Vektör dizin uyumsuzluğu: Gömme modeli değişti ama dizin yeniden oluşturulmadı mı?
Ağ geçidinizde yapılandırılmış hata kodları ekleyerek logların kimlik doğrulama, kota, yönlendirme ve araç hatalarını ayırmasını sağlayın.
Karar çerçevesi: bugün aslında neye ihtiyacınız var?
Bu hızlı matrisi kullanın:
- Kişisel/yerel deneme → bir LLM anahtarı
- Belgelerle bilgi asistanı → LLM + gömmeler + vektör VT
- Web farkındalığı olan asistan → arama anahtarı ekle
- Sesli aracı → STT/TTS anahtarları ekle
- Ekip üretim sistemi → gözlemlenebilirlik + sanal ortam + çoklu sağlayıcı yedekliliği ekle
Erken satıcı yayılmasından kaçının. Abonelikleri sadece bir özellik canlı ve test edilmiş olduğunda ekleyin.
Yaygın hatalar
Her aboneliği peşinen satın almak
- Karmaşıklığa ve boş harcamaya yol açar.
Tüm ortamlar arasında tek bir anahtar kullanmak
- Olay kontrolünü zorlaştırır.
Yedek model stratejisinin olmaması
- Tek sağlayıcı kesintileri, uygulama kesintileri haline gelir.
İzlemeyi atlamak
- Gözlemleyemediğinizi optimize edemezsiniz.
Ağ geçidinizde sözleşme testleri olmaması
- Sessiz şema kayması istemcileri bozar.
Son cevap
Çoğu geliştirici için OpenClaw'u çalıştırmak için minimum şunlardır:
- Bir LLM API anahtarı
Çoğu üretim ekibi için gerçekçi taban çizgisi şunlardır:
- Birincil + yedek LLM anahtarları
- Gömme (Embedding) + vektör VT kimlik bilgileri
- İsteğe bağlı arama anahtarı (eğer göz atma/RAG geliştirmesi gerekiyorsa)
- Gözlemlenebilirlik belirteci
- Sanal ortam/çalışma zamanı kontrolleri
- Dağıtım altyapısı için bulut aboneliği
OpenClaw'u bir orkestrasyon katmanı gibi düşünün. Anahtar stratejiniz, abartılı pazarlama döngülerini değil, mimarinizi yansıtmalıdır.