Naar hoofdinhoud gaan

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 CometAPI als modelprovider voor OpenClaw — 500+ modellen in één API.

​
Vereisten

  • Node.js ≥ 22 — aanbevolen via nvm
  • Een CometAPI-account met een actieve API-sleutel — haal die hier op

​
Installatie

1

Haal je CometAPI API-sleutel op

Log in op de CometAPI-console. Klik op Add API Key en kopieer je <COMETAPI_KEY>-sleutel.
CometAPI-dashboard met de knop Add API Key
Details van de CometAPI API-sleutel met base URL
2

Installeer of werk OpenClaw bij

Aanbevolen — gebruik het officiële installatieprogramma:
curl -fsSL https://openclaw.ai/install.sh | bash
Of installeer via npm:
npm install -g openclaw@latest
Voer daarna eenmalig de setup-wizard uit:
openclaw onboard --install-daemon
Kies tijdens onboarding Skip in de stap Model/Auth als je CometAPI handmatig wilt configureren. Bevestig na onboarding dat de gateway draait:
openclaw gateway status
openclaw dashboard

​
Configuratie

1

Sla je CometAPI-sleutel op

Schrijf je sleutel naar ~/.openclaw/.env zodat deze beschikbaar is voor de daemon zonder hardcoded in configuratiebestanden te staan:
printf 'COMETAPI_KEY=%s\n' 'your-<COMETAPI_KEY>-key' >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env
Als je COMETAPI_KEY al injecteert via je shell, servicemanager of een secrets-workflow, sla deze stap dan over — de configuratie hieronder gebruikt $\{COMETAPI_KEY\} ongeacht hoe de variabele is ingesteld.
2

Configureer CometAPI-providers

CometAPI ondersteunt vier API-indelingen. Voeg een of meer providerblokken toe aan ~/.openclaw/openclaw.json:
ProviderAPI-indelingAangeroepen 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" }]
      }
    }
  }
}
Je kunt alleen de providers behouden die je nodig hebt, of alle vier behouden om tussen indelingen te routeren met provider/model-verwijzingen.Vervang elke placeholder your-...-model-id door een actueel model ID van de CometAPI Models-pagina dat overeenkomt met het providerblok.
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.
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 credential-rotatie per profiel wilt over meerdere sleutels.

​
Verificatie

1

Herstart en verifieer

Herstart de gateway nadat je .env hebt toegevoegd of de providerconfiguratie hebt gewijzigd:
openclaw gateway restart
Voer daarna diagnostiek uit:
openclaw models status
openclaw models list --provider cometapi-claude
openclaw doctor
Een succesvolle setup ziet er als volgt uit:
  • openclaw models status zet het primaire model om naar cometapi-claude/your-claude-model-id zonder waarschuwingen over ontbrekende auth voor CometAPI-providers
  • openclaw models list --provider cometapi-claude toont je geconfigureerde modellen
  • openclaw doctor meldt geen configuratie- of auth-fouten voor CometAPI-providers
OpenClaw models status met geauthenticeerde CometAPI-providers

​
Modellen wisselen

1

Wissel van model

# 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

​
Probleemoplossing

Als je een kapotte oudere setup repareert, stop dan de gateway, verwijder ~/.openclaw en voer daarna onboarding opnieuw uit voordat je de CometAPI-configuratie toepast:
openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon
Dit verwijdert alle lokale configuratie, sessies, logs, auth-status en workspaces. Volg daarna stap 3–5 opnieuw.