OpenClaw: wat het is, hoe je het installeert en met Telegram verbindt

OpenClaw verscheen afgelopen winter in mijn feed, toen het project in één week twee keer van naam veranderde en honderdduizenden sterren op GitHub kreeg. Sindsdien zoeken mensen steeds vaker naar “openclaw installation” en “openclaw telegram”.

Hieronder loop ik de officiële documentatie door: wat dit is, hoe het verschilt van Claude Code, hoe je het installeert op Windows, macOS of Linux, hoe je een model kiest en hoe je een Telegram-bot verbindt. Ik behandel beveiliging ook apart, omdat OpenClaw betrokken is geweest bij een paar veelbesproken incidenten.

Lees hoe je met de dienst werkt in de Ailoot-documentatie.

Wat is OpenClaw in gewone taal?#

OpenClaw verbindt een AI-model met je Telegram-bot. Met de juiste tools en rechten kan het berichten samenvatten of een herinnering plannen. Het gatewayproces en de lokale configuratie draaien op je computer of server. Dat maakt niet ieder gesprek lokaal: bij een cloudmodel gaan het verzoek en de relevante gesprekscontext naar die provider. Gebruik je Ailoot, dan loopt het verzoek via Ailoot naar de gekozen modelprovider. Lokale inferentie vereist een lokaal model zonder cloudfallback; Telegram-berichten gaan nog steeds via Telegram en ingeschakelde tools kunnen andere diensten benaderen.

Het project wordt ontwikkeld door de opensourcecommunity van OpenClaw. De GitHub-repository is aangemaakt op 24 november 2025 en heeft op 22 augustus 2026 387 duizend sterren en 81 duizend forks—een van de snelst groeiende open projecten van het jaar. De programmeertaal is TypeScript.

Het project heeft een grappige geschiedenis van naamswijzigingen; die is handig om te kennen, zodat oudere artikelen je niet in verwarring brengen. Het begon als Warelay, een gateway voor WhatsApp. Daarna werd het Clawdbot. In januari 2026 vroeg Anthropic om een naamswijziging vanwege een handelsmerk, waarna het project een paar dagen Moltbot heette. Op 30 januari 2026 kreeg het zijn definitieve naam: OpenClaw. Kom je dus instructies over “Clawdbot” of “Moltbot” tegen, dan gaat het om hetzelfde project; die artikelen zijn alleen vóór de naamswijziging geschreven.

De mascotte van het project is Molty de kreeft, en “vervellen” (van schild wisselen) werd de officiële metafoor voor elke naamswijziging.

Waarin verschilt OpenClaw van Claude Code en Hermes Agent?#

Ik krijg vaak vragen over dit verschil, omdat ze er van buitenaf allemaal uitzien als “AI-agents”. Hier is een vergelijkingstabel:

Zo lees je dit. Ik gebruik Claude Code voor ontwikkeling: die is het sterkst als je een krachtig model nodig hebt en met code werkt. OpenClaw en Hermes zijn voor iets anders: een agent die voortdurend draait, in Telegram rondhangt, het gesprek van gisteren onthoudt en taken volgens een schema uitvoert. De keuze tussen OpenClaw en Hermes is subtieler; er is al een Hermes-gids voor installatie en configuratie.

Als je alleen een tool kiest, begin dan met het overzicht van waarmee mensen in 2026 coderen en welke taken je aan een AI-agent kunt uitbesteden. Ik heb ook een apart artikel over het installeren van Claude Code.

Wat heb je nodig voordat je OpenClaw installeert?#

Controleer vooraf je Node-versie—dit is de enige strikte vereiste:

node --version

Versies 22.22.3+, 24.15+ en 25.9+ worden ondersteund; Node 26 wordt aanbevolen. Geeft de opdracht “command not found” terug of is de versie oud, maak je dan geen zorgen: het officiële installatieprogramma downloadt een recente Node-versie voor je, dus je hoeft niets handmatig te installeren.

De resterende vraag is het model. OpenClaw denkt niet zelf: het roept het model aan dat je kiest. Dit zijn de opties qua kosten: een sleutel van Anthropic, OpenAI of Google—je betaalt de provider voor het daadwerkelijke gebruik; of een lokaal model via Ollama—gratis in geld, maar veeleisend voor de hardware. Hieronder behandel ik beide opties in aparte gedeelten.

Hoe installeer je OpenClaw op macOS en Linux?#

De aanbevolen route is het officiële installatieprogramma:

1. Start het installatieprogramma

   curl -fsSL https://openclaw.ai/install.sh | bash
   

   Het script detecteert je besturingssysteem, controleert Node (en installeert die zo nodig), installeert OpenClaw en opent daarna de installatiewizard. Wil je eerst rondkijken voordat je de wizard start, voeg dan de vlag toe: bash -s -- --no-onboard.

2. Controleer of alles is geïnstalleerd

   openclaw --version
   openclaw doctor
   openclaw gateway status
   

   De eerste opdracht toont de versie, de tweede controleert de configuratie en de derde bevestigt dat de gateway draait en op poort 18789 luistert.

Als je npm gebruikt en de installatie zelf wilt beheren:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

Hier is onlangs een valkuil bijgekomen, die in een apart hoofdstuk van de documentatie wordt behandeld. npm 12 blokkeert installatiescripts van pakketten standaard en zonder de vlag --allow-scripts=openclaw stopt de installatie met een allowScripts-bericht. Bij npm 11.15 en ouder is de vlag niet nodig—die beperking bestaat daar nog niet. Controleer je versie met: npm --version.

De vlag --install-daemon in de tweede opdracht configureert automatisch starten: op macOS is dat een LaunchAgent; op Linux een systemd-service. Daarmee start de gateway na herstart of aanmelding, afhankelijk van de voorwaarden van de servicebeheerder. Dit voorkomt geen slaapstand en houdt de gateway niet actief op een uitgeschakelde computer. Telegram-antwoorden vereisen een wakkere host met netwerkverbinding; gebruik een altijd actieve server als je antwoorden nodig hebt terwijl de laptop slaapt of uitstaat.

Hoe installeer je OpenClaw op Windows?#

De eerste optie is voor mensen die liever vensters gebruiken dan de terminal. Windows Hub is een native OpenClaw-app voor Windows 10 (20H2+) en Windows 11, momenteel in bèta. Ga naar de releasespagina van Windows Hub en download het installatieprogramma voor je processor: OpenClawCompanion-Setup-x64.exe voor gewone computers, of arm64 voor ARM. Na de installatie staat OpenClaw Companion in het Startmenu, met een systeemvakpictogram, chatvenster en instellingen.

Bij de eerste start biedt de app “Set up locally” aan—accepteer dat. De app maakt een speciale WSL-omgeving met de naam OpenClawGateway, installeert de gateway daarin en maakt er verbinding mee. Je bestaande Ubuntu-installatie blijft onaangeroerd, als je die hebt.

De tweede optie is via PowerShell:

iwr -useb https://openclaw.ai/install.ps1 | iex
openclaw gateway install

De eerste regel installeert OpenClaw; de tweede registreert automatisch starten via de Windows Taakplanner. Als het beleid van je computer het maken van taken blokkeert, schakelt OpenClaw zelf over op een alternatief: een snelkoppeling in de map Opstarten, zodat de gateway start wanneer je je aanmeldt.

De derde optie is WSL2, dat in de documentatie de meest compatibele runtime op Windows wordt genoemd. Installeer Ubuntu, schakel systemd in en volg daarna de Linux-instructies uit het vorige gedeelte:

wsl --install -d Ubuntu-24.04

Schakel systemd in WSL in via /etc/wsl.conf (de sectie [boot], de regel systemd=true), start WSL opnieuw door wsl --shutdown uit te voeren in PowerShell en installeer OpenClaw daarna met de Linux-opdracht. Zeggen “distributie” en “systemd” je niets, gebruik dan Windows Hub; die regelt dit allemaal voor je.

Hoe kies je een model en rond je de eerste configuratie af?#

Het model is de motor van de assistent. De installatiewizard toont een lijst met providers; dit zijn drie praktische opties:

Anthropic heeft een handig detail: als Claude Code al op je computer is geïnstalleerd en je bent aangemeld, kan OpenClaw die login gebruiken. Voer eerst claude auth login uit op de computer en geef OpenClaw daarna opdracht die te gebruiken:

openclaw models auth login --provider anthropic --method cli --set-default

Als de gateway als achtergrondservice draait (zoals bij --install-daemon), moet de sleutel beschikbaar zijn voor die service. Zet hem daarvoor in ~/.openclaw/.env—de wizard doet dit voor je, dus je hoeft het bestand niet handmatig te bewerken. Start na wijzigingen opnieuw op en controleer:

openclaw gateway restart
openclaw models status

Als betalen lastig is, is een lokaal model uit het Ollama-gedeelte een goede optie.

Hoe verbind je OpenClaw met Telegram?#

Telegram is het snelste kanaal om te verbinden: je hebt alleen een bottoken nodig en hoeft geen zakelijk account te laten verifiëren. De documentatie noemt dit de eenvoudigste manier om vanaf je telefoon met je assistent te gaan berichten. Dit is het volledige proces:

1. Maak een bot met BotFather

   Open een Telegram-chat met @BotFather (controleer of het exact die gebruikersnaam is—er zijn veel nepaccounts), stuur /newbot en kies een naam en gebruikersnaam die eindigt op bot. Je krijgt als antwoord een token zoals 123456789:ABCdef...—dit is de sleutel van je bot, dus bewaar hem als een wachtwoord.

2. Voer de token in OpenClaw in

   De eenvoudigste manier is via de wizard: voer openclaw configure uit en selecteer het Telegram-kanaal. Je kunt ook handmatig de instelling channels.telegram.botToken gebruiken of de omgevingsvariabele TELEGRAM_BOT_TOKEN instellen. De documentatie vermeldt nadrukkelijk dat de opdracht openclaw channels login telegram niet bestaat; Telegram wordt alleen met een token verbonden.

3. Start de gateway en stuur de bot een bericht

   openclaw gateway
   

   Open je bot in Telegram en stuur hem iets. Hij antwoordt met een koppelcode van acht tekens. Dit is een beveiligingsmaatregel: berichten worden pas verwerkt nadat je de afzender hebt goedgekeurd.

4. Keur je eigen account goed

   openclaw pairing list telegram
   openclaw pairing approve telegram CODE
   

   De code is één uur geldig, dus wacht niet te lang. De eerste goedgekeurde afzender wordt automatisch de eigenaar van bevoorrechte opdrachten.

Er zijn twee lastige punten waar mensen vaak tegenaan lopen.

Het eerste betreft groepen. OpenClaw blokkeert standaard alle groepen: je moet de bot expliciet toestaan in de instellingen channels.telegram.groups en de modus requireMention: true binnen de groep ingeschakeld laten. Dan antwoordt de bot alleen wanneer hij met gebruikersnaam wordt aangesproken en mengt hij zich niet in het algemene gesprek. Telegram heeft ook een eigen privacymodus voor bots: in een groep ziet een bot standaard alleen opdrachten. Schakel die uit met /setprivacy via @BotFather. Nadat je dat hebt gewijzigd, moet je de bot uit de groep verwijderen en weer toevoegen; anders past Telegram de instelling niet toe.

Het tweede punt is dat je de toegang niet voor iedereen moet openstellen. De instellingen hebben een modus dmPolicy: "open" met een sterretje in de toegangsvermelding: iedereen die de bot op gebruikersnaam vindt, kan hem opdrachten geven. Voor een persoonlijke assistent is dat een directe manier om iemand anders controle over je computer te geven. Laat koppeling via een code ingeschakeld of voer je numerieke ID in bij allowFrom.

Hoe gebruik je OpenClaw met een lokaal model via Ollama?#

Met een lokaal model en uitgeschakelde cloudfallback kan de modelverwerking op je hardware blijven, zonder tokenkosten bij een cloudprovider. Telegram en ingeschakelde onlinetools versturen nog steeds gegevens naar hun eigen diensten; “Local only” maakt het hele gesprek niet volledig lokaal.

1. Installeer Ollama

   Download het installatieprogramma via ollama.com/download—er zijn versies voor macOS, Windows en Linux.

2. Download een model

   ollama pull gemma4
   

3. Verbind Ollama met OpenClaw

   openclaw onboard
   

   Kies de Ollama-provider en een modus: Local only (alleen je eigen modellen), Cloud only (modellen van ollama.com) of Cloud + Local. De wizard vindt de lokale server en toont de geïnstalleerde modellen.

4. Controleer

   openclaw models list --provider ollama
   

Hier is de eerlijke kanttekening, want anders zou dit gedeelte als een advertentie klinken. Volgens de documentatie van OpenClaw heb je hardware op het niveau van twee volledig uitgeruste Mac Studios nodig om comfortabel een lokale agent te gebruiken. Een grafische kaart van 24 GB kan alleen lichte verzoeken met vertragingen verwerken. Kleine en sterk gecomprimeerde modellen korten de context af en zijn minder bestand tegen kwaadaardige instructies die in andermans tekst zijn verstopt. In alledaagse woorden: een lokaal model op een goede laptop is genoeg om “het uit te proberen en te begrijpen waar het om draait”, maar voor dagelijks werk met een assistent die tools gebruikt is een cloudmodel nog veel betrouwbaarder.

Nog een waarschuwing uit de documentatie, voor wie een WSL2 + Ollama + NVIDIA GPU-configuratie opzet: het officiële Linux-installatieprogramma van Ollama schakelt automatisch starten in met een herstartbeleid “always”. Op WSL2 met een GPU kan dat de computer in een herstartlus brengen. De oplossing is om automatisch starten van de service uit te schakelen. Raadpleeg bij problemen het gedeelte over probleemoplossing op de Ollama-pagina in de documentatie.

Hoe veilig is het om OpenClaw te gebruiken?#

Ik begin met het belangrijkste punt, dat niet iedereen begrijpt. OpenClaw heeft toegang tot je computer: bestanden, opdrachten en de browser. De documentatie zegt het duidelijk: het project is ontworpen voor één vertrouwde gebruiker en je moet buitenstaanders geen toegang tot je bot geven. Als iemand je agent een bericht kan sturen, kan die hem gebruiken om acties op je computer uit te voeren.

Het praktische minimum:

1. Laat koppeling met een code ingeschakeld of gebruik een toegangsvermelding—ik schreef hierover in het Telegram-gedeelte.
2. Stel de gateway niet extern beschikbaar tenzij dat nodig is. Standaard luistert hij alleen op je computer; laat dat zo.
3. Voer na elke wijziging van de configuratie de ingebouwde controle uit:

openclaw security audit

De controle zoekt naar open toegang, te ruime toolmachtigingen, zwakke tokens en blootgestelde poorten. Met de vlag --fix kunnen sommige bevindingen automatisch worden verholpen.

Een aparte opmerking over oplichting—dit is geen theorie. Toen het project in januari 2026 in allerijl van naam veranderde, namen bots die oude adressen hadden gekaapt die binnen enkele seconden over en plaatsten meteen een crypto-walletadres; nep-“OpenClaw-ontwikkelaars” begonnen een tokenzwendel te promoten. Daaruit volgen twee vaste regels. Download OpenClaw alleen van openclaw.ai of github.com/openclaw/openclaw. En het project heeft geen cryptovaluta: elke “OpenClaw-token” is oplichting. Stuur er onder geen enkele omstandigheid geld naartoe.

Wat kan OpenClaw na de installatie?#

Dit zou ik proberen, in deze volgorde:

1. Gateway en model. Voer openclaw gateway status uit en open daarna openclaw dashboard. Een geladen paneel bevestigt dat de Control UI bereikbaar is. Stuur in de chat “Antwoord met: modelverbindingstest” en controleer of er een AI-antwoord komt; alleen een geladen pagina test het model niet.
2. Telegram en de bedoelde taak. Configureer de bot en keur je eigen koppeling goed. Stuur daarna in Telegram een nieuw bericht naar die bot en controleer of het antwoord daar aankomt. Test vervolgens één afgebakende taak met zichtbaar resultaat, zoals een samenvatting van een onschuldige testmap waarvoor je leesrecht hebt gegeven. Controleer bij een herinnering het opgeslagen schema en het werkelijk afgeleverde bericht afzonderlijk. Een dashboardantwoord bewijst geen Telegram-aflevering of geplande uitvoering.
3. Geplande taken. De assistent kan taken volgens een schema uitvoeren—een ochtendoverzicht in Telegram, regelmatig e-mail controleren. Daarom laat je de gateway de hele dag draaien.
4. Geheugen. OpenClaw bewaart langetermijngeheugen in gewone Markdown-bestanden in de werkmap: wie je bent, hoe hij op je moet reageren en wat hij uit eerdere gesprekken heeft onthouden. Je kunt de bestanden zelf openen en lezen—er is geen black box.
5. Vaardigheden. Het project heeft een catalogus met kant-en-klare vaardigheden en plug-ins met ingebouwde beveiligingscontroles. De vaardigheid van iemand anders is code van iemand anders op jouw computer; daarom controleert de catalogus ze.

Er is één regel: zet niet alles tegelijk aan. Begin met één stabiel gesprek, dan Telegram en daarna schema’s. Zo blijkt bij elke fout in welke stap die is ontstaan, in plaats van dat “alles kapot is en ik niet weet waar het aan ligt”.

Wat moet je doen als de installatie misgaat?#

Laten we drie veelvoorkomende scenario’s doornemen.

Direct na de installatie verschijnt “openclaw: command not found”. Bijna altijd is dit een padprobleem: de map met globale npm-pakketten staat niet in de PATH van je terminal. De diagnostische opdrachten uit de documentatie zijn:

node -v
npm prefix -g
echo "$PATH"

Het pad uit de tweede opdracht moet in de derde uitvoer voorkomen. Is dat niet zo, voeg het dan toe aan je shellinstellingen of sluit de terminal en open hem opnieuw: soms verschijnt het Node-pad na de installatie pas in een nieuwe sessie.

De gateway draait, maar de assistent zwijgt. Het symptoom uit de FAQ van de documentatie: er komt geen antwoord op het eerste bericht en de tokenteller staat op nul. Dat betekent dat de agent nog niet eens is gestart—meestal is het model niet ingesteld. Controleer in deze volgorde:

openclaw gateway restart
openclaw status
openclaw models status

Als er wel een model is ingesteld maar er nog steeds geen antwoord komt, toont openclaw logs --follow het live logboek en waar het vastloopt.

De Telegram-bot antwoordt niet. Controleer in deze volgorde: de token hoort bij de bot waarmee je bericht; de gateway draait (openclaw gateway status); en je koppeling is goedgekeurd (openclaw pairing list telegram). Een koppelcode is één uur geldig—als je de bot gisteren een bericht stuurde, stuur hem dan gewoon opnieuw een bericht en keur de nieuwe code goed.

Als je helemaal vastzit, stelt de documentatie iets onverwachts maar verstandigs voor: geef de diagnostische gegevens aan een lokale AI-agent die je computer kan zien. Claude Code of Codex kan met de uitvoer van openclaw status --all en openclaw doctor de configuratie sneller begrijpen dan een supportchat. De cirkel is rond—AI repareert AI.

Wat vragen mensen nog meer over OpenClaw?#

Maak kennis met Ailoot.