Begin 2026 blijft OpenClaw — het opensource agent-runtime en AI-assistentplatform — breed worden omarmd door ontwikkelaars, onderzoeksteams en ondernemingen die multimodel-orkestratie willen over kanalen als Slack, Telegram, WhatsApp en lokale commandoregeluitvoering. Ondertussen is CometAPI naar voren gekomen als een krachtige OpenAI-compatibele LLM-gateway, die honderden modellen (bijv. Kimi‑K2.5, GPT-varianten, Claude) onder één API-eindpunt samenbrengt.
Dit artikel is een praktische stapsgewijze handleiding om OpenClaw te configureren zodat het CometAPI als modelprovider kan gebruiken. Je leert hoe je installeert, providers instelt, authenticatieprofielen definieert, de werking verifieert en tussen modellen schakelt — allemaal met liveconfiguratievoorbeelden en tips op basis van de nieuwste documentatie en communityfeedback.
Wat is OpenClaw en waarom het met CometAPI integreren?
OpenClaw is een opensource, device-centric agentplatform dat conversatie-AI verbindt met de chatapps en apparaten die mensen al gebruiken — WhatsApp, Telegram, Slack, Discord en meer — terwijl je modellen kunt draaien waar jij wilt en je sleutels en data onder eigen controle houdt. Het project en de repositories bevatten voorbeelden die laten zien hoe OpenClaw LLM-providers selecteert via een gateway-achtige configuratie.
CometAPI is een API-aggregatieplatform dat veel modelproviders ontsluit via één REST-interface in OpenAI-stijl en SDK’s. Dat maakt het handig als enkelvoudig integratiepunt wanneer je van model wilt wisselen, prijzen wilt uitproberen of observability wilt centraliseren zonder de kerncode van OpenClaw te veranderen.
Waarom OpenClaw koppelen aan CometAPI?
OpenClaw is model-agnostisch; het draait agents en workflows maar vertrouwt op externe LLM-providers. CometAPI fungeert als een OpenAI-compatibele gateway, waarmee je oproepen kunt routeren naar:
- GPT‑familiemodellen
- Claude‑familiemodellen
- Kimi‑K2.5 en andere externe modellen die door CometAPI worden geaggregeerd
Dit levert keuzevrijheid, flexibiliteit, kostenbeheersing en redundantie op.
Hoe configureer ik OpenClaw om CometAPI als modelprovider te gebruiken?
Antwoord: Voeg een providervermelding toe aan je OpenClaw-configuratie die wijst naar het REST-eindpunt van CometAPI en koppel modellen aan de structuur models.providers van OpenClaw. Het OpenClaw-project ondersteunt het toevoegen van aangepaste providers via models.providers (hetzelfde patroon als voor andere gateways) en verwacht een api-variant zoals "openai-completions" of "anthropic-messages" afhankelijk van de providersemantiek.
CometAPI ondersteunt drie API-formaten. Voeg er een of meer toe aan ~/.openclaw/openclaw.json:
| Provider | API-formaat | Basis-URL |
|---|---|---|
| cometapi-openai | openai-completions | https://api.cometapi.com/v1 |
| cometapi-claude | anthropic-messages | https://api.cometapi.com |
| cometapi-google | google-generative-ai | https://api.cometapi.com/v1beta |
Wat zijn de vereisten voor het configureren van OpenClaw met CometAPI?
Controleer vóór de integratie of je over de juiste omgeving, tools en accounts beschikt.
Omgevingsvereisten
Je hebt nodig:
- Een Unix-achtige omgeving: Linux, macOS of Windows Subsystem for Linux (WSL2)
- Node.js en npm geïnstalleerd (OpenClaw gebruikt onder de motorkap Node)
- Terminaltoegang met bash/zsh of PowerShell
Officiële documentatie vermeldt ook dat OpenClaw via Docker kan draaien, ideaal voor geïsoleerde en productieomgevingen.
Accounts en API-sleutels
Je hebt nodig:
- Een CometAPI-account
- Een geldige CometAPI LLM-sleutel (opgeslagen in een beveiligde omgevingsvariabele)
- Optioneel: Accounts voor aanvullende OpenClaw-providers (OpenAI, Anthropic, lokale modellen via Ollama)
💡 Tip: Gebruik een beveiligde secrets manager of de sleutelketen van het OS in plaats van sleutels in platte tekst op te slaan. Dit wordt door de documentatie van OpenClaw zelf aanbevolen voor productiebeveiliging.
Hoe configureer je OpenClaw om CometAPI aan te roepen? (stapsgewijs)
Hieronder staat een beknopte, praktische setup van vijf minuten. De exacte bestandsnamen of sleutels hangen af van je OpenClaw-versie en deployment, maar de concepten komen rechtstreeks uit de officiële OpenClaw-repo en -documentatie.
Stap 0 — Stel omgevingsvariabelen in (de snelle, veilige route)
Shell‑voorbeeld (Linux/macOS):
# do NOT commit this to gitexport COMETAPI_KEY="sk-YourCometApiKeyHere"export OPENCLAW_ENV="production" # or development
Gebruik in productie het geheimenmechanisme van je platform (bijv. Docker secrets, systemd, Kubernetes secrets).
Stap 1 — Installeer OpenClaw
Optie A: One‑liner via installatiescript
Dit is de snelste manier:
curl -fsSL https://openclaw.ai/install.sh | bash# Verify installationopenclaw --version
Dit script detecteert je besturingssysteem en installeert OpenClaw met afhankelijkheden.
Optie B: npm globale installatie
Als je Node-pakketten al beheert:
npm install -g openclaw@latestopenclaw --version
Dit installeert de OpenClaw-CLI globaal.
Optioneel: Docker-installatie
Als je naar productie uitrolt of isolatie wilt:
docker pull openclaw/openclaw:latestdocker run -d --name openclaw -v ~/.openclaw:/root/.openclaw openclaw/openclaw
Geccontaineriseerde deployments maken het eenvoudiger om afhankelijkheden en workloads te beheren.nClaw version; OpenClaw’s examples follow this pattern.)
Stap 2 — Configureer providers
Met het configureren van providers vertel je OpenClaw waar de LLM-backend te vinden is.
Het configuratiebestand van OpenClaw bewerken
OpenClaw slaat zijn configuratie op in een JSON-bestand op:
~/.openclaw/openclaw.json
Je definieert een aangepaste provider voor CometAPI.
Hier is een minimale providerconfiguratie:
base_urlvertelt OpenClaw LLM-verzoeken te sturen naar het OpenAI-compatibele eindpunt van CometAPI.auth_envverwijst naar de omgevingsvariabele met je API-sleutel.- De vlag
typespecificeert het API-protocoltype (OpenAI-stijl).
{
"models": {
"mode": "merge",
"providers": {
"cometapi-openai": {
"baseUrl": "https://api.cometapi.com/v1",
"apiKey": "<YOUR_COMETAPI_KEY>",
"api": "openai-completions",
"models": [{ "id": "gpt-5.2", "name": "GPT-5.2" }]
},
"cometapi-claude": {
"baseUrl": "https://api.cometapi.com",
"apiKey": "<YOUR_COMETAPI_KEY>",
"api": "anthropic-messages",
"models": [{ "id": "claude-opus-4-6", "name": "Claude Opus 4.6" }]
},
"cometapi-google": {
"baseUrl": "https://api.cometapi.com/v1beta",
"apiKey": "<YOUR_COMETAPI_KEY>",
"api": "google-generative-ai",
"models": [{ "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro" }]
}
}
},
"agents": {
"defaults": {
"model": { "primary": "cometapi-claude/claude-opus-4-6" }
}
},
"auth": {
"profiles": {
"cometapi-openai:default": { "provider": "cometapi-openai", "mode": "api_key" },
"cometapi-claude:default": { "provider": "cometapi-claude", "mode": "api_key" },
"cometapi-google:default": { "provider": "cometapi-google", "mode": "api_key" }
}
}
}
Vervang
<YOUR_COMETAPI_KEY>door je API-sleutel. Alle drie de providers gebruiken dezelfde sleutel.
Je kunt elk model van de CometAPI Models Page toevoegen aan de bijbehorende provider.
Stap 3 — Configureer auth-profielen
⚠️ Vereist! OpenClaw leest API-sleutels uit dit bestand, niet uit
openclaw.json. Dit overslaan veroorzaaktHTTP 401‑fouten.
Maak ~/.openclaw/agents/main/agent/auth-profiles.json aan:
{
"version": 1,
"profiles": {
"cometapi-openai:default": {
"type": "api_key",
"provider": "cometapi-openai",
"key": "<YOUR_COMETAPI_KEY>"
},
"cometapi-claude:default": {
"type": "api_key",
"provider": "cometapi-claude",
"key": "<YOUR_COMETAPI_KEY>"
},
"cometapi-google:default": {
"type": "api_key",
"provider": "cometapi-google",
"key": "<YOUR_COMETAPI_KEY>"
}
},
"lastGood": {
"cometapi-openai": "cometapi-openai:default",
"cometapi-claude": "cometapi-claude:default",
"cometapi-google": "cometapi-google:default"
}
}
Herstart de gateway:
openclaw gateway restart
Controleer statussen met:
openclaw auth status
En om alle geconfigureerde modellen te tonen:
openclaw models list
Met deze commando’s controleer je of je providers en auth-profielen correct zijn ingesteld.Alle modellen zouden Auth = yes moeten tonen:
Model Auth
cometapi-openai/gpt-5.2 yes
cometapi-claude/claude-opus-4-6 yes
cometapi-google/gemini-3-pro-preview yes
Stap 4 — Start OpenClaw en bekijk de logs
Start/herstart OpenClaw en volg de logs. Let specifiek op:
- Uitgaande verzoeklogs die
base_urlof de providernaam tonen. - HTTP 401/403 → sleutel- of scopeprobleem.
- 429 → rate limit (overweeg model-/prestatie‑aanpassingen).
- Onverwacht hoge latentie → netwerk‑ of modelthrottling.
Een snel diagnostisch commando (voorbeeld):
# If OpenClaw runs as a system service:journalctl -u openclaw -f# If running in Docker:docker logs -f openclaw
Modellen wisselen
# Set default model
openclaw models set cometapi-claude/claude-opus-4-6
# Or switch in TUI
/model cometapi-openai/gpt-5.2
Hoe gebruik je OpenClaw met CometAPI in echte workflows?
Na de integratie kun je workflows bouwen met codegeneratie, multimodale taken, agentautomatisering en posten naar kanalen.
Voorbeeldworkflow: schermafbeelding interpreteren
Als je agent bijlagen ondersteunt:
User: Analyze this screenshot and generate a minimal React component.
OpenClaw stuurt de prompt (plus afbeeldingsdata) via het model van CometAPI (zoals Kimi K‑2.5), dat code als output retourneert — ideaal voor het prototypen van UI‑workflows.
Slack-/Discord‑integratie
Zodra CometAPI de backend is, kun je antwoorden van agents naar elk geconfigureerd platform routeren:
- Slack‑kanalen
- WhatsApp‑groepen
- Telegram‑bots
OpenClaw verzorgt de routering en het parseren van verzoeken; CometAPI levert de modelantwoorden.
Welke monitoring en kostencontroles moet je toevoegen?
Als je centraliseert naar een aggregator, krijg je meer controle — maar je moet het wel configureren:
Instrumentatie
- Log modelnaam, tokengebruik, latentie en foutcodes voor elk verzoek.
- Voorzie verzoeken van tags met agent en kanaal (bijv. agent=personal_assistant, channel=telegram) zodat je kosten kunt toeschrijven.
Knoppen voor kostenbeheersing
- Stel
max_tokensentimeout_secondsin je providerconfig in. - Gebruik goedkopere modellen voor routinetaken en reserveer grote modellen voor hoogwaardige stromen.
- Configureer per‑agent rate‑limits en per‑gebruikerquota (OpenClaw kan vaak worden uitgebreid om deze af te dwingen).
CometAPI biedt tooling voor prestatie‑ en kostentuning; gebruik telemetrie van beide kanten (OpenClaw‑logs + CometAPI‑gebruiksstatistieken) om vangrails te creëren.
Hoe los ik veelvoorkomende fouten in de integratie op?
Antwoord: Dit zijn de meest voorkomende storingsmodi en hoe je ze snel oplost:
Oplossing: Het OpenClaw‑configuratiescherm toont een eenmalige token; plak die in de Control‑UI‑instellingen volgens de documentatie. Communitynotities verwijzen vaak naar deze stap.
401 Unauthorized
Oorzaak: COMETAPI_KEY ontbreekt, is onjuist of niet geïnjecteerd in het OpenClaw‑proces.
Oplossing: Exporteer de sleutel in de shell die OpenClaw start of schrijf deze naar je OpenClaw‑.env en herstart de gateway. Bevestig met een curl‑test.
Provider valt stilzwijgend terug / gebruikt standaardinstelling
Oorzaak: onjuist models.providers‑JSON of ontbrekende api‑variant, waardoor OpenClaw de provider negeert.
Oplossing: Valideer openclaw.json (JSON‑lint) en zorg dat api overeenkomt met ondersteunde varianten. Community‑issuethreads laten zien dat juist deze misconfiguratie vaak voorkomt.
Timeouts of hoge latentie
Oorzaak: netwerkroute of traagheid van het externe model.
Oplossing: Kies een Comet‑model met lagere latentie of host OpenClaw in (de buurt van) dezelfde cloudregio; overweeg een lokaal model te draaien voor latentiegevoelige taken. Documentatie en blogs bespreken de afweging tussen lokale modellen en API‑modellen (latentie vs. kosten).
Overmatig gebruik / 429’s
Oorzaak: CometAPI‑quota of abonnementslimieten bereikt.
Oplossing: Controleer quota in het Comet‑dashboard; voeg retry/backoff‑logica toe in OpenClaw‑agentacties of throttle verzoeken bij de gateway. Comet‑ en partnerdocumentatie benadrukken abonnementquota en aanbevolen backoff‑patronen.
Gatewaytoken ontbreekt / websocket‑disconnects
Oorzaak: ontbrekende OpenClaw‑controletokens in de dashboardconfig bij het draaien van de Gateway.
Slotopmerking
OpenClaw koppelen aan CometAPI gaat snel en ontgrendelt een krachtige multimodel‑backend voor je persoonlijke assistent. Maar snelheid is geen excuus om veiligheid te negeren: bind de gateway aan localhost tijdens het testen, gebruik allowlists, log alles en vraag om bevestigingen voor destructieve acties. Met die controles kun je in ongeveer vijf minuten van nul naar een werkende OpenClaw → CometAPI‑agent — en blijven je data en systemen beschermd terwijl je experimenteert.
Ontwikkelaars kunnen nu toegang krijgen tot kimi k-2.5 via CometAPI. Begin met het verkennen van de mogelijkheden van het model in de Playground en raadpleeg de API‑gids voor gedetailleerde instructies. Zorg ervoor dat je bent ingelogd bij CometAPI en een API‑sleutel hebt verkregen voordat je toegang vraagt. CometAPI biedt een prijs die veel lager ligt dan de officiële prijs om je te helpen integreren.
Ready to Go?→ Sign up fo openclaw today !
Als je meer tips, gidsen en nieuws over AI wilt weten volg ons op VK, X en Discord!