CometAPI ile OpenClaw yapılandırması için beş dakikalık eğitim

2026’nın başlarında, açık kaynaklı ajan çalışma zamanı ve yapay zeka asistanı platformu OpenClaw, Slack, Telegram, WhatsApp ve yerel komut satırı yürütme gibi kanallar arasında ç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ı altında yüzlerce modeli (ör. Kimi-K2.5, GPT varyantları, Claude) bir araya getiren güçlü bir OpenAI ile uyumlu LLM ağ geçidi olarak öne çıktı.

Bu makale, OpenClaw’ı CometAPI’yi model sağlayıcısı olarak kullanacak şekilde yapılandırmak için bir uygulamalı, adım adım kılavuz görevi görür. En yeni dokümantasyon ve topluluk geri bildirimlerine dayanan canlı yapılandırma örnekleri ve ipuçlarıyla, yüklemeyi, sağlayıcıları kurmayı, kimlik doğrulama profilleri tanımlamayı, işlevselliği doğrulamayı ve modeller arasında geçiş yapmayı öğreneceksiniz.

OpenClaw nedir ve neden CometAPI ile entegre edilmeli?

OpenClaw; insanların zaten kullandığı sohbet uygulamalarına ve cihazlara (WhatsApp, Telegram, Slack, Discord ve daha fazlası) konuşmaya dayalı yapay zekayı bağlayan, açık kaynaklı, cihaza odaklı bir ajan platformudur; 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ı ağ geçidi tarzı bir yapılandırma yoluyla nasıl seçtiğini gösteren örnekler içerir.

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

Neden OpenClaw ve CometAPI’yi Eşleştirmelisiniz?

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 bir OpenAI ile uyumlu ağ geçidi olarak hareket ederek çağrıları şu modellere yönlendirmenizi sağlar:

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

Bu size seçenek, esneklik, maliyet kontrolü ve yedeklilik kazandırır.

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

Cevap: OpenClaw yapılandırmanıza CometAPI’nin REST uç noktasını işaret eden bir sağlayıcı girdisi ekleyin ve modelleri OpenClaw’ın models.providers yapısına eşleyin. OpenClaw projesi, models.providers aracılığıyla (diğer ağ geçitleri için kullanılan aynı desen) özel sağlayıcılar eklemeyi destekler 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. ~/.openclaw/openclaw.json içine bir veya daha fazlasını ekleyin:

Sağlayıcı	API Formatı	Temel 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’yi yapılandırmanın önkoşulları nelerdir?

Entegrasyondan önce, doğru ortam, araçlar ve hesaplara sahip olduğunuzdan emin olun.

Ortam Gereksinimleri

Şunlara ihtiyacınız olacak:

Unix benzeri bir ortam: Linux, macOS veya Windows Subsystem for Linux (WSL2)
Node.js ve npm kurulu (OpenClaw altında Node kullanır)
bash/zsh veya PowerShell ile terminal erişimi

Resmi dokümanlar ayrıca OpenClaw’ın Docker ile de çalıştırılabildiğini, bunun izole ve üretim kurulumları için ideal olduğunu belirtir.

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 saklanır)
İsteğe bağlı: ek OpenClaw sağlayıcıları için hesaplar (OpenAI, Anthropic, Ollama üzerinden yerel modeller)

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

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

Aşağıda kısa ve pratik bir beş dakikalık kurulum yer alıyor. Tam dosya adları veya anahtarlar OpenClaw sürümünüze ve dağıtımınıza bağlıdır, ancak kavramlar resmi OpenClaw deposu ve dokümanlarından doğrudan aktarılabilir.

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

Üretim için platformunuzun gizli mekanizmasını kullanın (ör. Docker secrets, systemd, Kubernetes secrets).

Adım 1 — OpenClaw’ı yükleyin

Seçenek A: Yükleyici Betiği ile 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 OpenClaw’ı bağımlılıklarıyla birlikte kurar.

Seçenek B: npm Global Yükleme

Zaten Node paketlerini yönetiyorsanız:

npm install -g openclaw@latestopenclaw --version

Bu, OpenClaw CLI’ı global olarak yükler.

İsteğe bağlı: Docker ile Yükleme

Üretime dağıtıyorsanız veya yalıtım 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 version; OpenClaw’s examples follow this pattern.)

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

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

OpenClaw’ın 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ı tutan ortam değişkenini işaret eder.
type bayrağı, API protokol türünü (OpenAI stili) belirtir.

{
  "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 kendi API Anahtarınızla değiştirin. Üç sağlayıcı da aynı anahtarı kullanır.

CometAPI Models Page üzerindeki 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’dan değil. Bunu atlamak HTTP 401 hatalarına yol açar.

~/.openclaw/agents/main/agent/auth-profiles.json 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ı 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

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

OpenClaw’ı başlatın/yeniden başlatın ve günlükleri takip edin. Ö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 sınırı (model/performans değişimlerini düşünün).
Beklenenden uzun gecikme → ağ veya model kısıtlaması.

Hızlı bir 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’ı gerçek iş akışlarında CometAPI ile nasıl kullanırsınız?

Entegrasyondan sonra, kod üretimi, çoklu ortam görevleri, ajan otomasyonu ve kanal gönderimi 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örüntü verilerini) CometAPI’nin bir modeli (Kimi K-2.5 gibi) üzerinden gönderir; bu model bir kod çıktısı döndürür — UI iş akışlarını prototiplemek için idealdir.

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ı

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

Hangi izleme ve maliyet kontrollerini eklemelisiniz?

Toplayıcıya merkezileştirdiğinizde kontrol kazanırsınız — ancak bunu yapılandırmalısınız:

Araçlandırma

Her istek için model adını, token kullanımını, gecikmeyi ve hata kodlarını günlüğe kaydedin.
İstekleri ajan ve kanal ile etiketleyin (ör. agent=personal_assistant, channel=telegram) ki maliyetleri atfedebilin.

Maliyet kontrol düğmeleri

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ışlar için ayırın.
Ajan başına hız sınırları ve kullanıcı başına kotalar yapılandırın (OpenClaw çoğu zaman bunu uygulayacak şekilde genişletilebilir).

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

Entegrasyondaki yaygın hataları nasıl giderirsiniz?

Cevap: İşte yaygın arıza modları ve bunları hızla çözme yolları:

Düzeltme: OpenClaw kontrol paneli tek seferlik bir belirteç gösterecektir; bunu dokümana göre Control UI ayarlarına yapıştırın. Topluluk notları sık sık 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. Bir curl testi ile doğrulayın.

Sağlayıcı sessizce geri düşüyor / varsayılanı kullanıyor

Neden: hatalı 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’nin desteklenen türlerle eşleştiğinden emin olun. Topluluk konu başlıkları tam da 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 barındırın; gecikmeye duyarlı görevler için yerel bir model çalıştırmayı düşünün. Dokümantasyon ve bloglar, yerel modeller ile API modelleri arasındaki dengeyi (gecikme vs maliyet) tartışır.

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

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

Düzeltme: Kota için Comet kontrol panelini kontrol edin; OpenClaw ajan eylemlerinde yeniden deneme/geri çekilme (backoff) mantığı ekleyin veya istekleri ağ geçidinde kısın. Comet ve iş ortağı dokümanları plan kotalarını ve önerilen backoff desenlerini vurgular.

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

Neden: Ağ Geçidi çalışırken kontrol panosundaki 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ü, çoklu model bir arka uç sağlar. Ancak hız, güvenliği göz ardı etmek için bir bahane değildir: test ederken ağ geçidini localhost’a bağlayın, izin listeleri kullanın, her şeyi günlüğe kaydedin ve yıkıcı eylemler için onay gerektirin. Bu kontroller yerindeyken, yaklaşık beş dakikada çalışan bir OpenClaw → CometAPI ajanına sıfırdan ulaşabilir ve denerken verilerinizi ve sistemlerinizi koruyabilirsiniz.

Geliştiriciler kimi k-2.5 modeline artık CometAPI üzerinden erişebilir. Başlamak için modelin yeteneklerini Playground’da keşfedin ve ayrıntılı talimatlar için API guide’a bakın. Erişmeden önce, lütfen CometAPI’ye giriş yaptığınızdan ve API anahtarını aldığınızdan emin olun. CometAPI, entegrasyonunuza yardımcı olmak için resmi fiyattan çok daha düşük bir fiyat sunar.

Hazır mısınız?→ Bugün openclaw için kaydolun!

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