Beş dakikalık CometAPI ile OpenClaw'ı yapılandırma kılavuzu

2026’nın başlarında, açık kaynaklı acente çalışma zamanı ve yapay zekâ asistan platformu OpenClaw — Slack, Telegram, WhatsApp ve yerel komut satırı yürütme gibi kanallarda çoklu model orkestrasyonu isteyen geliştiriciler, araştırma ekipleri ve işletmeler tarafından — yaygın şekilde benimsenmeye devam ediyor. Bu arada, CometAPI, tek bir API uç noktası üzerinden yüzlerce modeli (ör. Kimi-K2.5, GPT varyantları, Claude) toplayan, OpenAI ile uyumlu güçlü bir LLM geçidi olarak öne çıktı.

Bu makale, OpenClaw’ın model sağlayıcısı olarak CometAPI’yi kullanacak şekilde yapılandırılması için pratik, adım adım bir kılavuz işlevi görür. Kurulumu nasıl yapacağınızı, sağlayıcıları nasıl ayarlayacağınızı, kimlik doğrulama profillerini nasıl tanımlayacağınızı, işlevselliği nasıl doğrulayacağınızı ve modeller arasında nasıl geçiş yapacağınızı — en güncel dokümantasyon ve topluluk geri bildirimi temel alınarak canlı yapılandırma örnekleri ve ipuçlarıyla — öğreneceksiniz.

OpenClaw nedir ve neden CometAPI ile entegre edilmeli?

OpenClaw, konuşmaya dayalı yapay zekâyı insanların hâlihazırda kullandığı sohbet uygulamaları ve cihazlarla — WhatsApp, Telegram, Slack, Discord ve daha fazlası — buluşturan, açık kaynaklı, cihaz merkezli bir ajan platformudur. Aynı zamanda modelleri istediğiniz yerde çalıştırmanıza ve anahtarlarınızı ile verilerinizi kontrolünüz altında tutmanıza olanak tanır. Proje ve depoları, OpenClaw’ın LLM sağlayıcılarını bir ağ geçidi tarzı yapılandırma aracılığıyla nasıl seçtiğini gösteren örnekler içerir.

CometAPI, birçok model sağlayıcısını tek bir, OpenAI tarzı REST arayüzü ve SDK’lar üzerinden sunan bir API toplama platformudur. Bu, modelleri değiştirmek, fiyatlandırmayı denemek veya gözlemlenebilirliği merkezileştirmek istediğinizde, OpenClaw’ın çekirdek kodunu değiştirmeden tek bir entegrasyon noktası olarak kullanışlı hale getirir.

Neden OpenClaw’ı CometAPI ile eşleştirmeli?

OpenClaw modelden bağımsızdır; ajanları ve iş akışlarını çalıştırır ancak harici LLM sağlayıcılarına dayanır. CometAPI, OpenAI ile uyumlu bir geçit olarak çalışır ve çağrıları şu modellere yönlendirmenize olanak tanır:

GPT ailesi modelleri
Claude ailesi modelleri
CometAPI tarafından bir araya getirilen Kimi-K2.5 ve diğer üçüncü taraf modeller

Bu size seçim özgürlüğü, esneklik, maliyet kontrolü ve yedeklilik sağlar.

OpenClaw'ı model sağlayıcısı olarak CometAPI’yi kullanacak şekilde nasıl yapılandırırım?

Yanıt: OpenClaw yapılandırmanıza CometAPI’nin REST uç noktasını gösteren bir sağlayıcı girdisi ekleyin ve modelleri OpenClaw’ın models.providers yapısına eşleyin. OpenClaw projesi, models.providers aracılığıyla özel sağlayıcılar eklemeyi destekler (diğer ağ geçitleri için kullanılan kalıbın aynısı) ve sağlayıcı semantiğine bağlı olarak "openai-completions" veya "anthropic-messages" gibi bir api türü bekler.

CometAPI üç API formatını destekler. Bunlardan birini veya birkaçını ~/.openclaw/openclaw.json dosyasına ekleyin:

Provider	API Format	Base URL
cometapi-openai	openai-completions	https://api.cometapi.com/v1
cometapi-claude	anthropic-messages	https://api.cometapi.com
cometapi-google	google-generative-ai	https://api.cometapi.com/v1beta

OpenClaw ile CometAPI yapılandırmasının önkoşulları nelerdir?

Entegrasyondan önce doğru ortam, araçlar ve hesapların hazır olduğundan emin olun.

Ortam Gereksinimleri

Şunlara ihtiyacınız olacak:

Unix-benzeri bir ortam: Linux, macOS veya Windows için Linux Alt Sistemi (WSL2)
Node.js ve npm (OpenClaw altyapıda Node kullanır)
bash/zsh veya PowerShell ile terminal erişimi

Resmî dokümanlar ayrıca OpenClaw’ın Docker aracılığıyla çalıştırılabildiğini belirtir; bu, izole ve üretim kurulumları için idealdir.

Hesaplar ve API Anahtarları

Şunlara ihtiyacınız var:

Bir CometAPI hesabı
Geçerli bir CometAPI LLM anahtarı (güvenli bir ortam değişkeninde saklanmalı)
İsteğe bağlı: Ek OpenClaw sağlayıcıları (OpenAI, Anthropic, Ollama aracılığıyla yerel modeller) için hesaplar

💡 İpucu: Anahtarları düz metinde saklamak yerine güvenli bir gizli yönetici veya işletim sistemi anahtarlığını kullanın. Bu, üretim güvenliği için OpenClaw’ın kendi dokümantasyonunda da önerilir.

OpenClaw’ı CometAPI’yi çağıracak şekilde nasıl yapılandırırsınız? (adım adım)

Aşağıda kısa, pratik bir beş dakikalık kurulum var. Dosya adları veya anahtarlar OpenClaw sürümünüz ve dağıtımınıza bağlı olarak değişebilir, ancak kavramlar resmî OpenClaw deposu ve dokümanlarından doğrudan aktarılır.

Adım 0 — Ortam değişkenlerini ayarlayın (güvenli hızlı yol)

Kabuk örneği (Linux/macOS):

# do NOT commit this to gitexport COMETAPI_KEY="sk-YourCometApiKeyHere"export OPENCLAW_ENV="production"   # or development

Üretimde platformunuzun gizli yönetim mekanizmasını kullanın (örn. Docker secrets, systemd, Kubernetes secrets).

Adım 1 — OpenClaw’ı kurun

Seçenek A: Kurulum betiğiyle tek satır

Bu en hızlı yoldur:

curl -fsSL https://openclaw.ai/install.sh | bash# Verify installationopenclaw --version

Bu betik işletim sisteminizi algılar ve bağımlılıklarla birlikte OpenClaw’ı kurar.

Seçenek B: npm Global Kurulum

Halihazırda Node paketlerini yönetiyorsanız:

npm install -g openclaw@latestopenclaw --version

Bu, OpenClaw CLI’ı global olarak kurar.

İsteğe bağlı: Docker Kurulumu

Üretime dağıtım yapıyorsanız veya izolasyon istiyorsanız:

docker pull openclaw/openclaw:latestdocker run -d --name openclaw -v ~/.openclaw:/root/.openclaw openclaw/openclaw

Konteynerleştirilmiş dağıtımlar, bağımlılıkları ve iş yüklerini yönetmeyi kolaylaştırır.nClaw sürümü; OpenClaw’ın örnekleri bu deseni izler.)

Adım 2 — Sağlayıcıları yapılandırın

Sağlayıcıların yapılandırılması, OpenClaw’a LLM arka ucunu nerede bulacağını söyler.

OpenClaw yapılandırma dosyasını düzenleme

OpenClaw yapılandırmasını şu JSON dosyasında saklar:

~/.openclaw/openclaw.json

CometAPI için özel bir sağlayıcı tanımlayacaksınız.

İşte minimal bir sağlayıcı yapılandırması:

base_url, OpenClaw’a LLM isteklerini CometAPI’nin OpenAI ile uyumlu uç noktasına göndermesini söyler.
auth_env, API anahtarınızı barındıran ortam değişkenini işaret eder.
type bayrağı, API protokol türünü belirtir (OpenAI tarzı).

{
  "models": {
    "mode": "merge",
    "providers": {
      "cometapi-openai": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "<YOUR_COMETAPI_KEY>",
        "api": "openai-completions",
        "models": [{ "id": "gpt-5.2", "name": "GPT-5.2" }]
      },
      "cometapi-claude": {
        "baseUrl": "https://api.cometapi.com",
        "apiKey": "<YOUR_COMETAPI_KEY>",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-opus-4-6", "name": "Claude Opus 4.6" }]
      },
      "cometapi-google": {
        "baseUrl": "https://api.cometapi.com/v1beta",
        "apiKey": "<YOUR_COMETAPI_KEY>",
        "api": "google-generative-ai",
        "models": [{ "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro" }]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "cometapi-claude/claude-opus-4-6" }
    }
  },
  "auth": {
    "profiles": {
      "cometapi-openai:default": { "provider": "cometapi-openai", "mode": "api_key" },
      "cometapi-claude:default": { "provider": "cometapi-claude", "mode": "api_key" },
      "cometapi-google:default": { "provider": "cometapi-google", "mode": "api_key" }
    }
  }
}

'<YOUR_COMETAPI_KEY>' değerini API Anahtarınızla değiştirin. Üç sağlayıcı da aynı anahtarı kullanır.

CometAPI Models Page sayfasındaki herhangi bir modeli ilgili sağlayıcıya ekleyebilirsiniz.

Adım 3 — Kimlik Doğrulama Profillerini yapılandırın

⚠️ Gerekli! OpenClaw API anahtarlarını bu dosyadan okur, openclaw.json dosyasından değil. Bunu atlamak HTTP 401 hatalarına neden olur.

~/.openclaw/agents/main/agent/auth-profiles.json dosyasını oluşturun:

{
  "version": 1,
  "profiles": {
    "cometapi-openai:default": {
      "type": "api_key",
      "provider": "cometapi-openai",
      "key": "<YOUR_COMETAPI_KEY>"
    },
    "cometapi-claude:default": {
      "type": "api_key",
      "provider": "cometapi-claude",
      "key": "<YOUR_COMETAPI_KEY>"
    },
    "cometapi-google:default": {
      "type": "api_key",
      "provider": "cometapi-google",
      "key": "<YOUR_COMETAPI_KEY>"
    }
  },
  "lastGood": {
    "cometapi-openai": "cometapi-openai:default",
    "cometapi-claude": "cometapi-claude:default",
    "cometapi-google": "cometapi-google:default"
  }
}

Ağ geçidini yeniden başlatın:

openclaw gateway restart

Durumları şununla kontrol edin:

openclaw auth status

Ve yapılandırılmış tüm modelleri listelemek için:

openclaw models list

Bu komutlar, sağlayıcılarınızın ve kimlik doğrulama profillerinizin doğru şekilde ayarlanıp ayarlanmadığını doğrular. Tüm modeller Auth = yes göstermelidir:

Model                                        Auth
cometapi-openai/gpt-5.2                      yes
cometapi-claude/claude-opus-4-6              yes
cometapi-google/gemini-3-pro-preview         yes

Beş dakikalık CometAPI ile OpenClaw'ı yapılandırma kılavuzu

Adım 4 — OpenClaw’ı çalıştırın ve günlükleri izleyin

Özellikle şunlara bakın:

base_url veya sağlayıcı adını gösteren giden istek günlükleri.
HTTP 401/403 → anahtar veya kapsam sorunu.
429 → hız limiti (model/performans değişikliklerini değerlendirin).
Beklenenden uzun gecikme → ağ veya model daraltması.

Hızlı tanılama komutu (örnek):

# If OpenClaw runs as a system service:journalctl -u openclaw -f# If running in Docker:docker logs -f openclaw

Modelleri değiştirin

# Set default model
openclaw models set cometapi-claude/claude-opus-4-6

# Or switch in TUI
/model cometapi-openai/gpt-5.2

OpenClaw’ı CometAPI ile gerçek iş akışlarında nasıl kullanırsınız?

Entegrasyondan sonra, kod üretimi, çok modlu görevler, ajan otomasyonu ve kanallara gönderim içeren iş akışları oluşturabilirsiniz.

Örnek İş Akışı: Ekran görüntüsü yorumlama

Ajanınız ekleri destekliyorsa:

User: Analyze this screenshot and generate a minimal React component.

OpenClaw, istemi (ve görsel verilerini) CometAPI’nin bir modeli (ör. Kimi K-2.5) üzerinden gönderir; model, arayüz prototipleme için ideal olan bir kod çıktısı döndürür.

Slack / Discord entegrasyonu

CometAPI arka uç olduktan sonra, ajan yanıtlarını yapılandırılmış herhangi bir platforma yönlendirebilirsiniz:

Slack kanalları
WhatsApp grupları
Telegram botları

OpenClaw yönlendirmeyi ve istek ayrıştırmayı yönetir; CometAPI model yanıtlarını sağlar.

Hangi izleme ve maliyet kontrollerini eklemelisiniz?

Bir toplayıcıya merkezileştiğinizde kontrol kazanırsınız — ancak bunun yapılandırılması gerekir:

Araçlama

Her istek için model adını, token kullanımını, gecikmeyi ve hata kodlarını kaydedin.
İstekleri ajan ve kanalla etiketleyin (örn. agent=personal_assistant, channel=telegram) ki maliyetleri atfedebilin.

Maliyet kontrol ayarları

Sağlayıcı yapılandırmanızda max_tokens ve timeout_seconds ayarlayın.
Rutin görevler için daha ucuz modelleri kullanın ve büyük modelleri yüksek değerli akışlara ayırın.
Ajan başına hız limitleri ve kullanıcı başına kota yapılandırın (OpenClaw genellikle bunları uygulamak için genişletilebilir).

CometAPI performans ve maliyet ayarı için araçlar sunar; koruyucular oluşturmak için iki tarafın telemetrilerini (OpenClaw günlükleri + CometAPI kullanım metrikleri) kullanın.

Entegrasyondaki yaygın hataları nasıl gideririm?

Yanıt: İşte yaygın hata modları ve hızlı çözümleri:

Düzeltme: OpenClaw kontrol paneli tek kullanımlık bir belirteç gösterecektir; bunu dokümantasyona göre Control UI ayarlarına yapıştırın. Topluluk notları sıkça bu adıma atıfta bulunur.

401 Yetkisiz

Neden: COMETAPI_KEY eksik, yanlış veya OpenClaw sürecine enjekte edilmemiş.

Düzeltme: Anahtarı OpenClaw’ı başlatan kabukta dışa aktarın veya OpenClaw .env dosyanıza yazın ve ağ geçidini yeniden başlatın. curl testiyle doğrulayın.

Sağlayıcı sessizce geri düşüyor / varsayılana dönüyor

Neden: hatalı biçimlendirilmiş models.providers JSON’u veya eksik api türü, OpenClaw’ın sağlayıcıyı yok saymasına neden olur.

Düzeltme: openclaw.json dosyasını (JSON lint) doğrulayın ve api desteklenen türlerle eşleşiyor olmalı. Topluluk konu başlıkları bu yanlış yapılandırmanın yaygın olduğunu gösterir.

Zaman aşımı veya yüksek gecikme

Neden: ağ rotası veya uzak model yavaşlığı.

Düzeltme: Daha düşük gecikmeli bir Comet modeli seçin veya OpenClaw’ı aynı bulut bölgesine yakın konumlandırın; gecikmeye duyarlı görevler için yerel bir modeli çalıştırmayı düşünün. Dokümantasyon ve bloglar yerel modeller ile API modelleri arasındaki (gecikme vs maliyet) ödünleşimi tartışır.

Aşırı kullanım / 429’lar

Neden: CometAPI kota veya plan sınırlarına ulaşmak.

Düzeltme: Kotalar için Comet kontrol panelini kontrol edin; OpenClaw ajan eylemlerine yeniden deneme/geri çekilme (retry/backoff) mantığı ekleyin veya istekleri ağ geçidinde kısın. Comet ve ortak dokümanlar plan kotalarını ve önerilen geri çekilme kalıplarını vurgular.

Ağ geçidi belirteci eksik / websocket bağlantı kesilmeleri

Neden: Ağ Geçidi çalışırken kontrol paneli yapılandırmasında OpenClaw kontrol belirteçlerinin eksik olması.

Kapanış notu

OpenClaw’ı CometAPI’ye bağlamak hızlıdır ve kişisel asistanınız için güçlü, çok modelli bir arka ucu açar. Ancak hız, güvenliği yok saymak için bir bahane değildir: test ederken ağ geçidini localhost’a bağlayın, izin listeleri kullanın, her şeyi kaydedin ve yıkıcı eylemler için onay isteyin. Bu kontroller yerindeyken, yaklaşık beş dakikada çalışan bir OpenClaw → CometAPI ajanına sıfırdan ulaşabilirsiniz — ve denemeler yaparken verilerinizi ve sistemlerinizi korumaya devam edersiniz.

Geliştiriciler CometAPI üzerinden kimi k-2.5 modeline artık erişebilir. Başlamak için, modelin yeteneklerini Playground içinde keşfedin ve ayrıntılı talimatlar için API guide dokümanına başvurun. Erişimden önce, lütfen CometAPI’ye giriş yaptığınızdan ve API anahtarını edindiğinizden emin olun. CometAPI, entegrasyonunuza yardımcı olmak için resmî fiyattan çok daha düşük bir fiyat sunar.

Hazır mısınız? → Bugün OpenClaw’a kaydolun!

Daha fazla ipucu, rehber ve yapay zekâ haberleri için bizi VK, X ve Discord üzerinden takip edin!