Naar hoofdinhoud gaan
Gebruik CometAPI als modelprovider voor OpenClaw — 500+ modellen in één API. Deze handleiding behandelt de huidige onboardingflow (2026.3.8+).

Vereisten

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

Haal je CometAPI API-sleutel op

Log in op de CometAPI-console. Klik op Add API Key en kopieer je sk-xxxxx-sleutel.
CometAPI-dashboard met de knop Add API Key
CometAPI API-sleuteldetails 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 de setupwizard één keer uit:
openclaw onboard --install-daemon
Kies tijdens onboarding Skip in de stap Model/Auth als je CometAPI handmatig wilt configureren. Controleer na onboarding of de gateway actief is:
openclaw gateway status
openclaw dashboard
3

Sla je CometAPI-sleutel op

Schrijf je sleutel naar ~/.openclaw/.env zodat deze beschikbaar is voor de daemon zonder hardcoded te zijn in configuratiebestanden:
printf 'COMETAPI_KEY=%s\n' 'your-sk-xxxxx-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.
4

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 tijdelijke aanduiding your-...-model-id door een actuele model-ID van de CometAPI Models-pagina die 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 opgehaald uit models.providers.*.apiKey via de env-var $\{COMETAPI_KEY\}. auth-profiles.json is alleen nodig als je credentials per profiel wilt roteren over meerdere sleutels.
5

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 geslaagde setup ziet er zo uit:
  • openclaw models status zet het primaire model om naar cometapi-claude/your-claude-model-id zonder waarschuwingen over ontbrekende authenticatie voor CometAPI-providers
  • openclaw models list --provider cometapi-claude toont je geconfigureerde modellen
  • openclaw doctor rapporteert geen configuratie- of authenticatiefouten voor CometAPI-providers
OpenClaw models status met geauthenticeerde CometAPI-providers
6

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
Als je een oudere kapotte setup herstelt, stop dan de gateway, verwijder ~/.openclaw en voer onboarding daarna opnieuw uit voordat je de CometAPI-configuratie toepast:
openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon
Hierdoor worden alle lokale configuratie, sessies, logs, authenticatiestatus en workspaces verwijderd. Volg daarna stap 3–5 opnieuw.