Zum Hauptinhalt springen
Verwenden Sie CometAPI als model provider für OpenClaw — über 500 Modelle in einer API. Dieser Leitfaden behandelt den aktuellen Onboarding-Ablauf (2026.3.8+).

​
Voraussetzungen

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

CometAPI API-Schlüssel abrufen

Melden Sie sich in der CometAPI-Konsole an. Klicken Sie auf Add API Key und kopieren Sie Ihren sk-xxxxx-Schlüssel.
CometAPI-Dashboard mit der Schaltfläche Add API Key
CometAPI-API-Schlüsseldetails mit Base URL
2

OpenClaw installieren oder aktualisieren

Empfohlen — verwenden Sie das offizielle Installationsprogramm:
curl -fsSL https://openclaw.ai/install.sh | bash
Oder über 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
3

CometAPI-Schlüssel speichern

Schreiben Sie Ihren Schlüssel in ~/.openclaw/.env, damit er dem Daemon zur Verfügung steht, ohne in Konfigurationsdateien fest codiert zu sein:
printf 'COMETAPI_KEY=%s\n' 'your-sk-xxxxx-key' >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env
Wenn Sie COMETAPI_KEY bereits über Ihre Shell, Ihren Service-Manager oder einen Secrets-Workflow bereitstellen, überspringen Sie diesen Schritt — die folgende Konfiguration verwendet $\{COMETAPI_KEY\} unabhängig davon, wie die Variable gesetzt wird.
4

CometAPI-Provider konfigurieren

CometAPI unterstützt vier API-Formate. Fügen Sie einen oder mehrere Provider-Blöcke zu ~/.openclaw/openclaw.json hinzu:
ProviderAPI-FormatAufgerufener 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" }]
      }
    }
  }
}
Sie können nur die Provider behalten, die Sie benötigen, oder alle vier beibehalten, um zwischen Formaten mithilfe von provider/model-Referenzen zu routen.Ersetzen Sie jeden Platzhalter your-...-model-id durch eine aktuelle Modell-ID von der CometAPI-Modelle-Seite, die zum jeweiligen Provider-Block passt.
Verwenden Sie cometapi-openai-responses (api: "openai-responses") für Modelle, die die OpenAI Responses API erfordern. Verwenden Sie cometapi-openai (api: "openai-completions") für Modelle auf dem klassischen Chat Completions-Pfad. Beide teilen sich dieselbe baseUrl (https://api.cometapi.com/v1); der einzige Unterschied ist, welchen nachgelagerten Endpoint OpenClaw aufruft.
Die Datei auth-profiles.json ist für dieses Setup nicht erforderlich. Provider-Schlüssel werden aus models.providers.*.apiKey über die Env-Variable $\{COMETAPI_KEY\} aufgelöst. auth-profiles.json wird nur benötigt, wenn Sie eine rotationsbasierte Anmeldung pro Profil über mehrere Schlüssel hinweg möchten.
5

Neustarten und überprüfen

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
Ein erfolgreiches Setup sieht wie folgt aus:
  • openclaw models status löst das primäre Modell 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 Modelle auf
  • openclaw doctor meldet keine Konfigurations- oder Authentifizierungsfehler für CometAPI-Provider
OpenClaw-Modelstatus mit authentifizierten CometAPI-Providern
6

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
Wenn Sie ein fehlerhaftes älteres Setup reparieren, stoppen Sie das Gateway, entfernen Sie ~/.openclaw und führen Sie dann das Onboarding erneut aus, bevor Sie die CometAPI-Konfiguration anwenden:
openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon
Dadurch werden alle lokalen Konfigurationen, Sitzungen, Logs, Auth-Status und Workspaces entfernt. Folgen Sie anschließend erneut den Schritten 3–5.