CometAPI ile OpenClaw kullanın

CometAPI’yi OpenClaw için model provider olarak kullanın — tek bir API içinde 500+ model.

Ön koşullar

Node.js ≥ 22 — nvm ile önerilir
Etkin bir API key’e sahip bir CometAPI hesabı — buradan edinebilirsiniz

Kurulum

CometAPI API key'inizi alın

CometAPI konsoluna giriş yapın. Add API Key seçeneğine tıklayın ve CometAPI API key’inizi kopyalayın.

Add API Key düğmesini gösteren CometAPI kontrol paneli

Base URL ile CometAPI API key ayrıntıları

OpenClaw'ı yükleyin veya güncelleyin

Önerilen — resmi yükleyiciyi kullanın:

curl -fsSL https://openclaw.ai/install.sh | bash

Veya npm ile yükleyin:

npm install -g openclaw@latest

Ardından kurulum sihirbazını bir kez çalıştırın:

openclaw onboard --install-daemon

Onboarding sırasında, CometAPI’yi manuel olarak yapılandırmak istiyorsanız Model/Auth adımında Skip seçeneğini seçin. Onboarding tamamlandıktan sonra, gateway’in çalıştığını doğrulayın:

openclaw gateway status
openclaw dashboard

Yapılandırma

CometAPI anahtarınızı saklayın

Anahtarınızı ~/.openclaw/.env dosyasına yazın; böylece yapılandırma dosyalarına sabit olarak yazmadan daemon tarafından kullanılabilir:

printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env

COMETAPI_KEY değerini zaten shell, servis yöneticisi veya bir secrets iş akışı üzerinden enjekte ediyorsanız bu adımı atlayın — aşağıdaki yapılandırma, değişkenin nasıl ayarlandığından bağımsız olarak $\{COMETAPI_KEY\} kullanır.

CometAPI sağlayıcılarını yapılandırın

CometAPI dört API formatını destekler. ~/.openclaw/openclaw.json dosyasına bir veya daha fazla sağlayıcı bloğu ekleyin:

Sağlayıcı	API formatı	Çağrılan endpoint	Base URL
`cometapi-openai`	`openai-completions`	`POST /v1/chat/completions`	`https://api.cometapi.com/v1`
`cometapi-openai-responses`	`openai-responses`	`POST /v1/responses`	`https://api.cometapi.com/v1`
`cometapi-claude`	`anthropic-messages`	`POST /messages`	`https://api.cometapi.com`
`cometapi-google`	`google-generative-ai`	`POST /v1beta/...`	`https://api.cometapi.com/v1beta`

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "cometapi-claude/your-claude-model-id"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "cometapi-openai": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "your-chat-model-id", "name": "OpenAI-compatible text model" }]
      },
      "cometapi-openai-responses": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-responses",
        "models": [{ "id": "your-responses-model-id", "name": "Responses API model" }]
      },
      "cometapi-claude": {
        "baseUrl": "https://api.cometapi.com",
        "apiKey": "${COMETAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "your-claude-model-id", "name": "Claude family model" }]
      },
      "cometapi-google": {
        "baseUrl": "https://api.cometapi.com/v1beta",
        "apiKey": "${COMETAPI_KEY}",
        "api": "google-generative-ai",
        "models": [{ "id": "your-gemini-model-id", "name": "Gemini family model" }]
      }
    }
  }
}

Yalnızca ihtiyaç duyduğunuz sağlayıcıları tutabilir veya provider/model referanslarını kullanarak formatlar arasında yönlendirme yapmak için dördünü de saklayabilirsiniz.Her your-...-model-id yer tutucusunu, sağlayıcı bloğuyla eşleşen CometAPI Models page üzerindeki güncel bir model ID ile değiştirin.

OpenAI Responses API gerektiren modeller için cometapi-openai-responses (api: "openai-responses") kullanın. Klasik Chat Completions yolundaki modeller için cometapi-openai (api: "openai-completions") kullanın. Her ikisi de aynı baseUrl değerini paylaşır (https://api.cometapi.com/v1); tek fark, OpenClaw’ın hangi downstream endpoint’i çağırdığıdır.

Bu kurulum için auth-profiles.json dosyası gerekli değildir. Sağlayıcı anahtarları, models.providers.*.apiKey içinden $\{COMETAPI_KEY\} env var aracılığıyla çözülür. auth-profiles.json yalnızca birden fazla anahtar arasında profil bazlı kimlik bilgisi rotasyonu istiyorsanız gereklidir.

Doğrulama

Yeniden başlatın ve doğrulayın

.env ekledikten veya sağlayıcı yapılandırmasını değiştirdikten sonra gateway’i yeniden başlatın:

openclaw gateway restart

Ardından tanılama komutlarını çalıştırın:

openclaw models status
openclaw models list --provider cometapi-claude
openclaw doctor

Başarılı bir kurulum şu şekilde görünür:

openclaw models status, birincil modeli cometapi-claude/your-claude-model-id olarak çözümler ve CometAPI sağlayıcıları için eksik kimlik doğrulama uyarısı göstermez
openclaw models list --provider cometapi-claude, yapılandırdığınız modelleri listeler
openclaw doctor, CometAPI sağlayıcıları için hiçbir yapılandırma veya kimlik doğrulama hatası bildirmez

CometAPI sağlayıcılarının kimliği doğrulanmış olarak gösterildiği OpenClaw models status

Modeller arasında geçiş yapın

# Set the default model in config
openclaw models set cometapi-claude/your-claude-model-id

# Switch for the current chat session
/model cometapi-openai/your-chat-model-id
/model cometapi-openai-responses/your-responses-model-id
/model cometapi-claude/your-claude-model-id
/model cometapi-google/your-gemini-model-id

Sorun giderme

Temiz yeniden kurulum (isteğe bağlı)

Bozuk eski bir kurulumu düzeltiyorsanız gateway’i durdurun, ~/.openclaw dizinini kaldırın, ardından CometAPI yapılandırmasını uygulamadan önce onboarding işlemini yeniden çalıştırın:

openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon

Bu işlem tüm yerel yapılandırmayı, oturumları, günlükleri, kimlik doğrulama durumunu ve çalışma alanlarını kaldırır. Ardından 3–5. Adımları tekrar izleyin.

Genel Bakış

AI kodlama ajanları

AI ajanları

AI sohbet istemcileri

Çeviri ve dil

Otomasyon platformları

Gözlemlenebilirlik ve değerlendirme

AI framework'leri

Ön koşullar

Kurulum

Yapılandırma

Doğrulama

Modeller arasında geçiş yapın

Sorun giderme

​Ön koşullar

​Kurulum

​Yapılandırma

​Doğrulama

​Modeller arasında geçiş yapın

​Sorun giderme

Ön koşullar

Kurulum

Yapılandırma

Doğrulama

Modeller arasında geçiş yapın

Sorun giderme