Zum Hauptinhalt springen

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.

Verwenden Sie CometAPI als model provider 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

1

Holen Sie sich Ihren CometAPI API key

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

Installieren oder aktualisieren Sie OpenClaw

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

1

Speichern Sie Ihren CometAPI-Schlüssel

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' "$COMETAPI_KEY" >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env
Wenn Sie COMETAPI_KEY bereits über Ihre Shell, Ihren Service-Manager oder einen Secrets-Workflow einspeisen, überspringen Sie diesen Schritt — die folgende Konfiguration verwendet $\{COMETAPI_KEY\} unabhängig davon, wie die Variable gesetzt wird.
2

Konfigurieren Sie CometAPI-Anbieter

CometAPI unterstützt vier API-Formate. Fügen Sie einen oder mehrere Anbieterblöcke zu ~/.openclaw/openclaw.json hinzu:
AnbieterAPI-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 Anbieter beibehalten, die Sie benötigen, oder alle vier behalten, um mit provider/model-Referenzen zwischen Formaten zu routen.Ersetzen Sie jeden Platzhalter your-...-model-id durch einen aktuellen model ID von der CometAPI-Modelle-Seite, der zum jeweiligen Anbieterblock 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. Anbieterschlüssel werden aus models.providers.*.apiKey über die env var $\{COMETAPI_KEY\} aufgelöst. auth-profiles.json wird nur benötigt, wenn Sie eine Credential-Rotation pro Profil über mehrere Schlüssel hinweg möchten.

​
Verifizierung

1

Neu starten und verifizieren

Starten Sie das Gateway neu, nachdem Sie .env hinzugefügt oder die Anbieterkonfiguration 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 so aus:
  • openclaw models status löst das primäre Modell zu cometapi-claude/your-claude-model-id auf, ohne Missing-Auth-Warnungen für CometAPI-Anbieter
  • openclaw models list --provider cometapi-claude listet Ihre konfigurierten Modelle auf
  • openclaw doctor meldet keine Konfigurations- oder Auth-Fehler für CometAPI-Anbieter
OpenClaw-Modelstatus zeigt authentifizierte CometAPI-Anbieter

​
Modelle wechseln

1

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

Wenn Sie ein defektes ä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 die gesamte lokale Konfiguration, Sitzungen, Logs, der Auth-Status und Workspaces entfernt. Folgen Sie dann erneut den Schritten 3–5.