Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw için model sağlayıcısı olarak CometAPI kullanın — tek bir API içinde 500+ model.

​
Önkoşullar

  • Node.js ≥ 22 — nvm ile önerilir
  • Etkin bir API anahtarına sahip bir CometAPI hesabı — buradan edinin

​
Kurulum

1

CometAPI API anahtarınızı alın

CometAPI konsoluna giriş yapın. Add API Key seçeneğine tıklayın ve <COMETAPI_KEY> anahtarınızı kopyalayın.
Add API Key düğmesini gösteren CometAPI panosu
Base URL ile 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
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 sonrasında gateway’in çalıştığını doğrulayın:
openclaw gateway status
openclaw dashboard

​
Yapılandırma

1

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 olur:
printf 'COMETAPI_KEY=%s\n' 'your-<COMETAPI_KEY>-key' >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env
COMETAPI_KEY değerini zaten shell, service manager 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.
2

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 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 sağlayıcıları bırakabilir veya provider/model referanslarını kullanarak formatlar arasında yönlendirme yapmak için dördünü de tutabilirsiniz.Her your-...-model-id yer tutucusunu, sağlayıcı bloğuna uygun olan CometAPI Models sayfasındaki 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 (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. 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 profile özel credential rotation istiyorsanız gereklidir.

​
Doğrulama

1

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

.env ekledikten veya sağlayıcı 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 sağlayıcıları için missing-auth uyarısı vermez
  • openclaw models list --provider cometapi-claude, yapılandırdığınız modelleri listeler
  • openclaw doctor, CometAPI sağlayıcıları için config veya auth hatası bildirmez
CometAPI sağlayıcılarının kimliği doğrulanmış olduğunu gösteren OpenClaw models status

​
Model değiştirin

1

Model değiştirin

# 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

Eski ve bozuk bir kurulumu düzeltiyorsanız gateway’i durdurun, ~/.openclaw klasörünü kaldırın, ardından CometAPI config’ini uygulamadan önce onboarding’i yeniden çalıştırın:
openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon
Bu işlem tüm yerel config, oturumlar, loglar, auth durumu ve workspace’leri kaldırır. Ardından 3–5. adımları tekrar izleyin.