> ## 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 mit CometAPI verwenden

> Verwenden Sie diese Anleitung, um OpenClaw mit CometAPI zu konfigurieren, indem Sie die base URL, den API-Schlüssel sowie model- oder provider-Optionen festlegen.

Verwenden Sie [CometAPI](https://www.cometapi.com) als model-Anbieter für [OpenClaw](https://openclaw.ai) — über 500 Modelle in einer API.

## Voraussetzungen

* Node.js ≥ 22 — empfohlen über [nvm](https://github.com/nvm-sh/nvm)
* Ein CometAPI-Konto mit einem aktiven API-Schlüssel — [hier erhalten](https://www.cometapi.com/console/token)

## Installation

<Steps>
  <Step title="Holen Sie sich Ihren CometAPI-API-Schlüssel">
    Melden Sie sich bei der [CometAPI-Konsole](https://www.cometapi.com/console/token) an. Klicken Sie auf **Add API Key** und kopieren Sie Ihren CometAPI-API-Schlüssel.

    <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 mit der Schaltfläche „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="CometAPI-API-Schlüsseldetails mit base URL" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="OpenClaw installieren oder aktualisieren">
    **Empfohlen** — verwenden Sie das offizielle Installationsprogramm:

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

    Oder per npm installieren:

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

    Führen Sie dann den Einrichtungsassistenten einmal aus:

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

    Wählen Sie während des Onboardings im Schritt Model/Auth **Skip**, wenn Sie CometAPI manuell konfigurieren möchten. Bestätigen Sie nach dem Onboarding, dass das Gateway läuft:

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

## Konfiguration

<Steps>
  <Step title="Speichere deinen CometAPI-Schlüssel">
    Schreibe deinen Schlüssel in `~/.openclaw/.env`, damit er dem Daemon zur Verfügung steht, ohne fest in Konfigurationsdateien eingebettet zu sein:

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

    <Note>
      Wenn du `COMETAPI_KEY` bereits über deine Shell, deinen Service-Manager oder einen Secrets-Workflow einspeist, überspringe diesen Schritt — die folgende Konfiguration verwendet `$\{COMETAPI_KEY\}` unabhängig davon, wie die Variable gesetzt wird.
    </Note>
  </Step>

  <Step title="CometAPI-Provider konfigurieren">
    CometAPI unterstützt **vier API-Formate**. Füge einen oder mehrere Provider-Blöcke zu `~/.openclaw/openclaw.json` hinzu:

    | Provider                    | API-Format             | Aufgerufener 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" }]
          }
        }
      }
    }
    ```

    Du kannst nur die Provider beibehalten, die du benötigst, oder alle vier behalten, um mithilfe von `provider/model`-Referenzen zwischen Formaten zu routen.

    Ersetze jeden Platzhalter `your-...-model-id` durch eine aktuelle model ID von der [CometAPI Models-Seite](https://www.cometapi.com/models/), die zum jeweiligen Provider-Block passt.

    <Note>
      Verwende `cometapi-openai-responses` (`api: "openai-responses"`) für Modelle, die die OpenAI Responses API erfordern. Verwende `cometapi-openai` (`api: "openai-completions"`) für Modelle auf dem klassischen Chat Completions-Pfad. Beide verwenden dieselbe `baseUrl` (`https://api.cometapi.com/v1`); der einzige Unterschied ist, welcher nachgelagerte Endpoint von OpenClaw aufgerufen wird.
    </Note>

    <Note>
      Die Datei `auth-profiles.json` ist für dieses Setup **nicht erforderlich**. Provider-Schlüssel werden aus `models.providers.*.apiKey` über die Umgebungsvariable `$\{COMETAPI_KEY\}` aufgelöst. `auth-profiles.json` wird nur benötigt, wenn du eine profilbezogene Rotation von Zugangsdaten über mehrere Schlüssel hinweg möchtest.
    </Note>
  </Step>
</Steps>

## Verifizierung

<Steps>
  <Step title="Neustarten und verifizieren">
    Starten Sie das Gateway neu, nachdem Sie `.env` hinzugefügt oder die Provider-Konfiguration geändert haben:

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

    Führen Sie dann die Diagnose aus:

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

    Eine erfolgreiche Einrichtung sieht so aus:

    * `openclaw models status` löst das primäre model zu `cometapi-claude/your-claude-model-id` auf, ohne Warnungen zu fehlender Authentifizierung für CometAPI-Provider
    * `openclaw models list --provider cometapi-claude` listet Ihre konfigurierten models auf
    * `openclaw doctor` meldet keine Konfigurations- oder Authentifizierungsfehler für CometAPI-Provider

    <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 zeigt authentifizierte CometAPI-Provider" width="1906" height="296" data-path="images/integrations/810968_371721.png" />
    </Frame>
  </Step>
</Steps>

## Modelle wechseln

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

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Saubere Neuinstallation (optional)">
    Wenn du ein defektes älteres Setup reparierst, stoppe das Gateway, entferne `~/.openclaw` und führe dann das Onboarding erneut aus, bevor du die CometAPI-Konfiguration anwendest:

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

    Dadurch werden die gesamte lokale Konfiguration, Sitzungen, Logs, der Auth-Status und Workspaces entfernt. Folge danach erneut den Schritten 3–5.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/openclaw#howto",
        "name": "OpenClaw mit CometAPI verwenden",
        "description": "Verwende diese Anleitung, um OpenClaw mit CometAPI zu konfigurieren, indem du die base URL, den API-Schlüssel sowie Modell- oder Anbieteroptionen festlegst.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-1",
            "position": 1,
            "name": "Deinen CometAPI-API-Schlüssel abrufen",
            "text": "Erstelle oder öffne dein CometAPI-Konto und kopiere dann einen aktiven API-Schlüssel aus dem Dashboard."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-2",
            "position": 2,
            "name": "OpenClaw installieren oder aktualisieren",
            "text": "Schließe den Schritt „OpenClaw installieren oder aktualisieren“ in der Anleitung „OpenClaw mit CometAPI verwenden“ ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-3",
            "position": 3,
            "name": "Deinen CometAPI-Schlüssel speichern",
            "text": "Schließe den Schritt „Deinen CometAPI-Schlüssel speichern“ in der Anleitung „OpenClaw mit CometAPI verwenden“ ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-4",
            "position": 4,
            "name": "CometAPI-Anbieter konfigurieren",
            "text": "Schließe den Schritt „CometAPI-Anbieter konfigurieren“ in der Anleitung „OpenClaw mit CometAPI verwenden“ ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-5",
            "position": 5,
            "name": "Neu starten und überprüfen",
            "text": "Schließe den Schritt „Neu starten und überprüfen“ in der Anleitung „OpenClaw mit CometAPI verwenden“ ab."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/openclaw#step-6",
            "position": 6,
            "name": "Modelle wechseln",
            "text": "Schließe den Schritt „Modelle wechseln“ in der Anleitung „OpenClaw mit CometAPI verwenden“ ab."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI-Dokumentation",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrationen",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "OpenClaw mit CometAPI verwenden",
            "item": "https://apidoc.cometapi.com/integrations/openclaw"
          }
        ]
      }
    ]
    }
    `}
</script>