> ## 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.

# CometAPI ile OpenClaw kullanın

> Bu kılavuzu kullanarak base URL, API key ve model veya provider seçeneklerini ayarlayıp OpenClaw'ı CometAPI ile yapılandırın.

[CometAPI](https://www.cometapi.com)'yi [OpenClaw](https://openclaw.ai) için model provider olarak kullanın — tek bir API içinde 500+ model.

## Ön koşullar

* Node.js ≥ 22 — [nvm](https://github.com/nvm-sh/nvm) ile önerilir
* Etkin bir API key'e sahip bir CometAPI hesabı — [buradan edinebilirsiniz](https://www.cometapi.com/console/token)

## Kurulum

<Steps>
  <Step title="CometAPI API key'inizi alın">
    [CometAPI konsoluna](https://www.cometapi.com/console/token) giriş yapın. **Add API Key** seçeneğine tıklayın ve CometAPI API key'inizi kopyalayın.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="Add API Key düğmesini gösteren CometAPI kontrol paneli" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="Base URL ile CometAPI API key ayrıntıları" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="OpenClaw'ı yükleyin veya güncelleyin">
    **Önerilen** — resmi yükleyiciyi kullanın:

    ```bash theme={null}
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```

    Veya npm ile yükleyin:

    ```bash theme={null}
    npm install -g openclaw@latest
    ```

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

    ```bash theme={null}
    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:

    ```bash theme={null}
    openclaw gateway status
    openclaw dashboard
    ```
  </Step>
</Steps>

## Yapılandırma

<Steps>
  <Step title="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:

    ```bash theme={null}
    printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> ~/.openclaw/.env
    chmod 600 ~/.openclaw/.env
    ```

    <Note>
      `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.
    </Note>
  </Step>

  <Step title="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` |

    ```json theme={null}
    {
      "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](https://www.cometapi.com/models/) üzerindeki güncel bir model ID ile değiştirin.

    <Note>
      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.
    </Note>

    <Note>
      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.
    </Note>
  </Step>
</Steps>

## Doğrulama

<Steps>
  <Step title="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:

    ```bash theme={null}
    openclaw gateway restart
    ```

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

    ```bash theme={null}
    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

    <Frame>
      <img src="https://mintcdn.com/cometapi/3HbSFe0pH45ETcjq/images/integrations/810968_371721.png?fit=max&auto=format&n=3HbSFe0pH45ETcjq&q=85&s=928b6faed91c5c2cb2eceea6bfac630d" alt="CometAPI sağlayıcılarının kimliği doğrulanmış olarak gösterildiği OpenClaw models status" width="1906" height="296" data-path="images/integrations/810968_371721.png" />
    </Frame>
  </Step>
</Steps>

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

<Steps>
  <Step title="Modeller arasında geçiş yapın">
    ```bash theme={null}
    # 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
    ```
  </Step>
</Steps>

## Sorun giderme

<AccordionGroup>
  <Accordion title="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:

    ```bash theme={null}
    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.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/openclaw#howto",
        "name": "OpenClaw'ı CometAPI ile kullanın",
        "description": "Bu kılavuzu, base URL, API key ve model veya provider seçeneklerini ayarlayarak OpenClaw'ı CometAPI ile yapılandırmak için kullanın.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-1",
            "position": 1,
            "name": "CometAPI API key'inizi alın",
            "text": "CometAPI hesabınızı oluşturun veya açın, ardından dashboard'dan etkin bir API key kopyalayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-2",
            "position": 2,
            "name": "OpenClaw'ı yükleyin veya güncelleyin",
            "text": "OpenClaw'ı CometAPI ile kullanın kılavuzundaki OpenClaw'ı yükleyin veya güncelleyin adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-3",
            "position": 3,
            "name": "CometAPI key'inizi saklayın",
            "text": "OpenClaw'ı CometAPI ile kullanın kılavuzundaki CometAPI key'inizi saklayın adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-4",
            "position": 4,
            "name": "CometAPI provider'larını yapılandırın",
            "text": "OpenClaw'ı CometAPI ile kullanın kılavuzundaki CometAPI provider'larını yapılandırın adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-5",
            "position": 5,
            "name": "Yeniden başlatın ve doğrulayın",
            "text": "OpenClaw'ı CometAPI ile kullanın kılavuzundaki Yeniden başlatın ve doğrulayın adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-6",
            "position": 6,
            "name": "Modeller arasında geçiş yapın",
            "text": "OpenClaw'ı CometAPI ile kullanın kılavuzundaki Modeller arasında geçiş yapın adımını tamamlayın."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI Dokümanları",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Entegrasyonlar",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "OpenClaw'ı CometAPI ile kullanın",
            "item": "https://apidoc.cometapi.com/integrations/openclaw"
          }
        ]
      }
    ]
    }
    `}
</script>