OpenClaw mit CometAPI verwenden

Verwenden Sie CometAPI als model-Anbieter für OpenClaw — über 500 Modelle in einer API.

Voraussetzungen

Node.js ≥ 22 — empfohlen über nvm
Ein CometAPI-Konto mit einem aktiven API-Schlüssel — hier erhalten

Installation

Holen Sie sich Ihren CometAPI-API-Schlüssel

Melden Sie sich bei der CometAPI-Konsole an. Klicken Sie auf Add API Key und kopieren Sie Ihren CometAPI-API-Schlüssel.

CometAPI-Dashboard mit der Schaltfläche „Add API Key“

CometAPI-API-Schlüsseldetails mit base URL

OpenClaw installieren oder aktualisieren

Empfohlen — verwenden Sie das offizielle Installationsprogramm:

curl -fsSL https://openclaw.ai/install.sh | bash

Oder per npm installieren:

npm install -g openclaw@latest

Führen Sie dann den Einrichtungsassistenten einmal aus:

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:

openclaw gateway status
openclaw dashboard

Konfiguration

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:

printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env

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.

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`

{
  "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, die zum jeweiligen Provider-Block passt.

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.

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.

Verifizierung

Neustarten und verifizieren

Starten Sie das Gateway neu, nachdem Sie .env hinzugefügt oder die Provider-Konfiguration geändert haben:

openclaw gateway restart

Führen Sie dann die Diagnose aus:

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

OpenClaw models status zeigt authentifizierte CometAPI-Provider

Modelle wechseln

# 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

Fehlerbehebung

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:

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.

Überblick

AI-Coding-Agenten

AI-Agenten

AI-Chat-Clients

Übersetzung und Sprache

Automatisierungsplattformen

Observability und Evaluierung

AI-Frameworks

Voraussetzungen

Installation

Konfiguration

Verifizierung

Modelle wechseln

Fehlerbehebung

​Voraussetzungen

​Installation

​Konfiguration

​Verifizierung

​Modelle wechseln

​Fehlerbehebung

Voraussetzungen

Installation

Konfiguration

Verifizierung

Modelle wechseln

Fehlerbehebung