Ana içeriğe atla
CometAPI’yi OpenClaw için model sağlayıcısı olarak kullanın — tek bir API’de 500’den fazla model. Bu kılavuz, güncel başlangıç akışını (2026.3.8+) kapsar.

​
Önkoşullar

1

CometAPI API anahtarınızı alın

CometAPI konsolunda oturum açın. Add API Key seçeneğine tıklayın ve sk-xxxxx anahtarınızı kopyalayın.
Add API Key düğmesini gösteren CometAPI kontrol paneli
base URL ile birlikte CometAPI API anahtarı ayrıntıları
2

OpenClaw'ı yükleyin veya güncelleyin

Önerilen — resmi yükleyiciyi kullanın:
curl -fsSL https://openclaw.ai/install.sh | bash
Ya da npm ile yükleyin:
npm install -g openclaw@latest
Ardından kurulum sihirbazını bir kez çalıştırın:
openclaw onboard --install-daemon
İlk kurulum sırasında, CometAPI’yi manuel olarak yapılandırmak istiyorsanız Model/Auth adımında Skip seçeneğini seçin. İlk kurulumdan sonra gateway’in çalıştığını doğrulayın:
openclaw gateway status
openclaw dashboard
3

CometAPI anahtarınızı saklayın

Anahtarınızı ~/.openclaw/.env dosyasına yazın; böylece config dosyalarında sabit kodlanmadan daemon tarafından kullanılabilir:
printf 'COMETAPI_KEY=%s\n' 'your-sk-xxxxx-key' >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env
COMETAPI_KEY değerini zaten shell, servis yöneticiniz veya bir secrets iş akışı üzerinden enjekte ediyorsanız bu adımı atlayın — aşağıdaki config, değişkenin nasıl ayarlandığından bağımsız olarak $\{COMETAPI_KEY\} kullanır.
4

CometAPI provider'larını yapılandırın

CometAPI dört API formatını destekler. ~/.openclaw/openclaw.json dosyasına bir veya daha fazla provider bloğu ekleyin:
ProviderAPI FormatÇağrılan endpointBase URL
cometapi-openaiopenai-completionsPOST /v1/chat/completionshttps://api.cometapi.com/v1
cometapi-openai-responsesopenai-responsesPOST /v1/responseshttps://api.cometapi.com/v1
cometapi-claudeanthropic-messagesPOST /messageshttps://api.cometapi.com
cometapi-googlegoogle-generative-aiPOST /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 ihtiyacınız olan provider’ları tutabilir veya provider/model referanslarını kullanarak formatlar arasında yönlendirme yapmak için dördünü birden saklayabilirsiniz.Her your-...-model-id yer tutucusunu, provider bloğuyla eşleşen güncel bir model kimliğiyle CometAPI Models sayfasından 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 (https://api.cometapi.com/v1) paylaşır; tek fark, OpenClaw’ın hangi downstream endpoint’i çağırdığıdır.
Bu kurulum için auth-profiles.json dosyası gerekli değildir. Provider 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ı credential rotasyonu istiyorsanız gerekir.
5

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

.env ekledikten veya provider config’ini değiştirdikten sonra gateway’i yeniden başlatın:
openclaw gateway restart
Ardından tanı 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 provider’ları için eksik yetkilendirme uyarısı vermez
  • openclaw models list --provider cometapi-claude, yapılandırdığınız modelleri listeler
  • openclaw doctor, CometAPI provider’ları için config veya yetkilendirme hatası bildirmez
CometAPI provider'larının kimlik doğrulamasının yapıldığını gösteren OpenClaw models status
6

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
Bozuk eski bir kurulumu düzeltiyorsanız gateway’i durdurun, ~/.openclaw dizinini kaldırın, ardından CometAPI config’ini uygulamadan önce ilk kurulumu yeniden çalıştırın:
openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon
Bu işlem tüm yerel config’i, oturumları, logları, auth durumunu ve workspace’leri kaldırır. Ardından 3–5. Adımları yeniden izleyin.