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

# Gebruik OpenClaw met CometAPI

> Gebruik deze handleiding om OpenClaw met CometAPI te configureren door de basis-URL, API-sleutel en model- of provideropties in te stellen.

Gebruik [CometAPI](https://www.cometapi.com) als modelprovider voor [OpenClaw](https://openclaw.ai) — 500+ modellen in één API.

## Vereisten

* Node.js ≥ 22 — aanbevolen via [nvm](https://github.com/nvm-sh/nvm)
* Een CometAPI-account met een actieve API-sleutel — [haal die hier op](https://www.cometapi.com/console/token)

## Installatie

<Steps>
  <Step title="Haal je CometAPI API-sleutel op">
    Log in op de [CometAPI-console](https://www.cometapi.com/console/token). Klik op **Add API Key** en kopieer je CometAPI API-sleutel.

    <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="CometAPI-dashboard met de knop Add API Key" 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="Details van de CometAPI API-sleutel met basis-URL" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Installeer of werk OpenClaw bij">
    **Aanbevolen** — gebruik het officiële installatieprogramma:

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

    Of installeer via npm:

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

    Voer daarna één keer de configuratiewizard uit:

    ```bash theme={null}
    openclaw onboard --install-daemon
    ```

    Kies tijdens de onboarding **Skip** in de stap Model/Auth als je CometAPI handmatig wilt configureren. Bevestig na de onboarding dat de gateway actief is:

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

## Configuratie

<Steps>
  <Step title="Sla je CometAPI-sleutel op">
    Schrijf je sleutel naar `~/.openclaw/.env` zodat deze beschikbaar is voor de daemon zonder hardcoded te worden in configuratiebestanden:

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

    <Note>
      Als je `COMETAPI_KEY` al injecteert via je shell, service manager of een secrets-workflow, sla deze stap dan over — de onderstaande configuratie gebruikt `$\{COMETAPI_KEY\}` ongeacht hoe de variabele is ingesteld.
    </Note>
  </Step>

  <Step title="Configureer CometAPI-providers">
    CometAPI ondersteunt **vier API-formaten**. Voeg een of meer providerblokken toe aan `~/.openclaw/openclaw.json`:

    | Provider                    | API-formaat            | Aangeroepen 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" }]
          }
        }
      }
    }
    ```

    Je kunt alleen de providers behouden die je nodig hebt, of alle vier behouden om tussen formaten te routeren met `provider/model`-verwijzingen.

    Vervang elke `your-...-model-id`-placeholder door een huidige model ID van de [CometAPI Models-pagina](https://www.cometapi.com/models/) die overeenkomt met het providerblok.

    <Note>
      Gebruik `cometapi-openai-responses` (`api: "openai-responses"`) voor modellen die de OpenAI Responses API vereisen. Gebruik `cometapi-openai` (`api: "openai-completions"`) voor modellen op het klassieke Chat Completions-pad. Beide delen dezelfde `baseUrl` (`https://api.cometapi.com/v1`); het enige verschil is welk downstream endpoint OpenClaw aanroept.
    </Note>

    <Note>
      Het bestand `auth-profiles.json` is **niet vereist** voor deze setup. Providersleutels worden opgelost vanuit `models.providers.*.apiKey` via de env-var `$\{COMETAPI_KEY\}`. `auth-profiles.json` is alleen nodig als je per profiel credentials wilt roteren over meerdere sleutels.
    </Note>
  </Step>
</Steps>

## Verificatie

<Steps>
  <Step title="Herstarten en verifiëren">
    Herstart de gateway nadat je `.env` hebt toegevoegd of de providerconfiguratie hebt gewijzigd:

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

    Voer daarna diagnostiek uit:

    ```bash theme={null}
    openclaw models status
    openclaw models list --provider cometapi-claude
    openclaw doctor
    ```

    Een succesvolle installatie ziet er zo uit:

    * `openclaw models status` zet het primaire model om naar `cometapi-claude/your-claude-model-id` zonder waarschuwingen over ontbrekende authenticatie voor CometAPI-providers
    * `openclaw models list --provider cometapi-claude` toont je geconfigureerde modellen
    * `openclaw doctor` meldt geen configuratie- of authenticatiefouten voor CometAPI-providers

    <Frame>
      <img src="https://mintcdn.com/cometapi/3HbSFe0pH45ETcjq/images/integrations/810968_371721.png?fit=max&auto=format&n=3HbSFe0pH45ETcjq&q=85&s=928b6faed91c5c2cb2eceea6bfac630d" alt="OpenClaw models status met geauthenticeerde CometAPI-providers" width="1906" height="296" data-path="images/integrations/810968_371721.png" />
    </Frame>
  </Step>
</Steps>

## Van model wisselen

<Steps>
  <Step title="Van model wisselen">
    ```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>

## Probleemoplossing

<AccordionGroup>
  <Accordion title="Schone herinstallatie (optioneel)">
    Als je een kapotte oudere setup repareert, stop dan de gateway, verwijder `~/.openclaw` en voer vervolgens onboarding opnieuw uit voordat je de CometAPI-configuratie toepast:

    ```bash theme={null}
    openclaw gateway stop
    rm -rf ~/.openclaw
    openclaw onboard --install-daemon
    ```

    Hiermee verwijder je alle lokale configuratie, sessies, logs, auth-status en workspaces. Volg daarna stap 3–5 opnieuw.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/openclaw#howto",
        "name": "OpenClaw gebruiken met CometAPI",
        "description": "Gebruik deze handleiding om OpenClaw met CometAPI te configureren door de base URL, API key en model- of provideropties in te stellen.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-1",
            "position": 1,
            "name": "Haal je CometAPI API key op",
            "text": "Maak je CometAPI-account aan of open het, en kopieer vervolgens een actieve API key uit het dashboard."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-2",
            "position": 2,
            "name": "Installeer of update OpenClaw",
            "text": "Voltooi de stap Installeer of update OpenClaw in de handleiding OpenClaw gebruiken met CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-3",
            "position": 3,
            "name": "Sla je CometAPI key op",
            "text": "Voltooi de stap Sla je CometAPI key op in de handleiding OpenClaw gebruiken met CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-4",
            "position": 4,
            "name": "Configureer CometAPI-providers",
            "text": "Voltooi de stap Configureer CometAPI-providers in de handleiding OpenClaw gebruiken met CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-5",
            "position": 5,
            "name": "Start opnieuw en verifieer",
            "text": "Voltooi de stap Start opnieuw en verifieer in de handleiding OpenClaw gebruiken met CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-6",
            "position": 6,
            "name": "Wissel van model",
            "text": "Voltooi de stap Wissel van model in de handleiding OpenClaw gebruiken met CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI-documentatie",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integraties",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "OpenClaw gebruiken met CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/openclaw"
          }
        ]
      }
    ]
    }
    `}
</script>