OpenClaw instellen op een eigen server: de complete handleiding (2026)
📋 Inhoudsopgave ▼
Als je ooit een AI-assistent hebt willen draaien die 24/7 beschikbaar is zonder dat jij er voortdurend naar hoeft om te kijken, dan is OpenClaw precies wat je zoekt. Vroeger bekend als Moltbot of Clawdbot, heeft dit open-source project zich ontwikkeld tot een volwaardige AI-gateway die je eenvoudig kunt koppelen aan berichtenplatformen zoals Telegram of WhatsApp. In deze handleiding loop ik stap voor stap met je door het volledige installatieproces op een eigen VPS — eerlijk, nuchter, en zonder overbodige omwegen.
Waarom een eigen server?
Je kunt OpenClaw technisch ook op je eigen laptop draaien. Maar dan stuit je al snel op een praktisch probleem dat iedere efficiëntiegerichte gebruiker zal ergeren: zodra je de laptop dichtklapt of de verbinding wegvalt, gaat je bot offline.
Een VPS (Virtual Private Server) lost dit op. De server draait onafgebroken in een datacenter, volledig los van jouw eigen apparaten. In Nederland zijn vestigingen in Amsterdam (AMS1/AMS2) populaire keuzes vanwege de lage latentie voor Europese gebruikers. Nog niet zeker welke VPS het beste bij jou past? Bekijk dan ons vergelijkingsartikel: Beste VPS voor OpenClaw in 2026.
Vereisten & Voorbereiding
Voordat je begint, controleer of je server aan de volgende minimumvereisten voldoet:
- Besturingssysteem: Ubuntu 22.04 of 24.04 LTS
- Toegang: Root of sudo-rechten via SSH
- Docker & Docker Compose: Geïnstalleerd en actief
- RAM: Minimaal 2 GB (4 GB aanbevolen voor soepele werking)
- Schijfruimte: Minstens 10 GB vrij
- AI API-sleutel: Van Anthropic of OpenAI
Nog nooit met een VPS gewerkt? Zorg er dan eerst voor dat je succesvol via SSH kunt inloggen. Dat is de absolute minimumvereiste voordat je verdergaat met de rest van deze handleiding. Wil je weten welke aanbieder het meest geschikt is? Bekijk de Beste VPS voor OpenClaw in 2026 — met eerlijke prijsvergelijking en aanbevelingen per gebruiksscenario.
Stap 1 – Docker controleren
Docker is de ruggengraat van de OpenClaw-installatie. Denk aan Docker als een container die alles wat OpenClaw nodig heeft netjes ingepakt meeneemt — inclusief alle afhankelijkheden. Log in op je server via SSH en voer dit uit:
Zie je versienummers? Dan ben je klaar. Krijg je command not found? Installeer Docker dan eerst:
Hostinger-gebruikers: De Docker Manager in hPanel toont direct of Docker actief is, of je kunt het met één klik inschakelen — geen terminal nodig.
Stap 2 – Repository klonen & installeren
We halen de broncode van OpenClaw op vanuit de officiële GitHub-repository en gebruiken het meegeleverde installatiescript om alles automatisch te bouwen en te starten.
Het script voert automatisch de volgende stappen uit:
- Bouwt de OpenClaw Docker-image lokaal op basis van de Dockerfile
- Start de interactieve onboarding-wizard in een Docker-container
- Genereert een gateway-token voor toegang tot de Control UI
- Maakt benodigde configuratiemappen aan
- Start de OpenClaw-gateway via Docker Compose
De eerste build duurt enkele minuten omdat alles lokaal wordt gecompileerd. Dat is bewust zo — je hebt altijd de exacte versie uit de repository. Latere rebuilds zijn veel sneller dankzij Docker's layer-caching.
Stap 3 – AI-provider configureren
Na de build verschijnt de interactieve onboarding-wizard. Hier stel je in welke AI-provider OpenClaw moet gebruiken. Kies bij de eerste vraag voor Local — dat betekent dat de gateway op jouw eigen VPS draait.
Kies je authenticatiemethode
Mijn persoonlijke voorkeur gaat uit naar de Anthropic API Key. Claude presteert in mijn ervaring bijzonder goed bij genuanceerde gesprekken en instructietaken. Maak een account aan op anthropic.com, navigeer naar API Keys, maak een nieuwe sleutel aan en plak deze in de wizard.
Beveiligingswaarschuwing: Behandel je API-sleutel als een wachtwoord. Iedereen die deze sleutel heeft, kan op jouw kosten AI-modellen aanroepen. Bewaar hem nooit in een publieke repository of chatgesprek.
Stap 4 – Opstarten & verifiëren
Na het installatiescript zou OpenClaw al actief moeten zijn. Maar vertrouw nooit blind — controleer het zelf:
Je wilt de container openclaw-gateway zien met de status "Up" of "Running". Controleer ook de logs:
Tekenen dat alles correct werkt:
- Bericht "OpenClaw initialized" in de logs
- Verbinding met de AI-provider bevestigd
- Geen authenticatiefouten
- Container-status is "Up" (geen herstart-cyclus)
Stap 5 – Dashboard openen
Het beheersdashboard van OpenClaw is bereikbaar via het IP-adres van je VPS op poort 18789:
Bij je eerste bezoek heb je het gateway-token nodig dat tijdens de installatie is aangemaakt. Zoek het op met:
Technische noot: Ondanks de hernoeming naar "OpenClaw" gebruiken configuratiemappen en variabelen nog de naam "clawdbot" (zoals ~/.clawdbot/). Dit is normaal tijdens de overgangsperiode en heeft geen invloed op de werking.
Lukt het niet om de interface te bereiken? Doorloop dan dit lijstje:
- Controleer of de container actief is:
docker compose ps - Controleer of de firewall poort 18789 niet blokkeert:
sudo ufw allow 18789/tcp - Gebruik HTTP, niet HTTPS
- Test lokaal:
curl http://localhost:18789
Stap 6 – Telegram koppelen
Het webdashboard is voor beheer; de eigenlijke AI-gesprekken vinden plaats via een berichtenplatform. Hier het Telegram-koppelingsproces — de aanpak is vergelijkbaar voor WhatsApp.
6a – Bot aanmaken via BotFather
- Open Telegram en zoek naar @BotFather
- Start een gesprek en stuur het commando /newbot
- Kies een naam voor je bot
- Kies een gebruikersnaam eindigend op "bot"
- Kopieer het bot-token dat BotFather je geeft
6b – Telegram toevoegen aan OpenClaw
6c – Groepsprivacy uitschakelen (voor groepchats)
- Stuur /mybots naar BotFather
- Selecteer je bot → Bot Settings → Group Privacy
- Schakel groepsprivacy uit
6d – Koppelcode goedkeuren & testen
Stuur daarna een testbericht naar je bot in Telegram. Ontvang je een antwoord? Gefeliciteerd — de installatie is succesvol afgerond. 🎉
Snelroute via Hostinger
Als je een Hostinger-klant bent, kun je de handmatige installatie overslaan. Hostinger biedt een vooraf geconfigureerde template die OpenClaw automatisch deployt — inclusief alle Docker-afhankelijkheden. Wil je eerst weten hoe Hostinger presteert voor OpenClaw? Lees dan onze uitgebreide Hostinger OpenClaw review met echte testresultaten.
Nieuwe server bij Hostinger
- Bezoek de OpenClaw VPS-hostingpagina van Hostinger en kies je plan en serverlocatie
- Optioneel: koop nexos.ai-credits voor gebruik zonder aparte API-sleutels
- Kopieer na aankoop het gateway-token en voer je WhatsApp-nummer in
- Hostinger deployt OpenClaw automatisch en opent de Docker Manager
- Klik op de projectlink, plak het gateway-token en je bent klaar
Bestaande Hostinger VPS omzetten
Waarschuwing: Het wisselen van besturingssysteem verwijdert alle data op de server permanent. Maak altijd eerst een volledige back-up.
- Log in op hPanel → VPS → Beheren → OS & Panel → Besturingssysteem
- Zoek op Docker, selecteer het en klik op OS wijzigen
- Ga na installatie naar Docker Manager → Catalogus, zoek op OpenClaw en klik op Deploy
- Voer het gateway-token en WhatsApp-nummer in
- Je project verschijnt onder Docker Manager → Projecten
Twijfel je nog of Hostinger de juiste keuze is voor jouw OpenClaw-setup? In onze Hostinger OpenClaw review vind je een eerlijk eindoordeel op basis van snelheid, uptime en gebruiksgemak.
Probleemoplossing
Zelfs met de beste handleiding loopt er weleens iets mis. Hier zijn de meest voorkomende problemen en de bijbehorende oplossingen:
| Probleem | Diagnose | Oplossing |
|---|---|---|
| Container stopt steeds | docker compose logs openclaw-gateway |
Controleer API-sleutel, poortconflict of machtigingen |
| Authenticatiefout | cat ~/.clawdbot/.env |
Verifieer sleutel, geen spaties/aanhalingstekens, herstart |
| Poort 18789 bezet | sudo lsof -i :18789 |
Wijzig poortmapping in docker-compose.yml |
| Herstartlus | docker compose ps |
docker compose down -v → opnieuw ./docker-setup.sh |
| Dashboard onbereikbaar | curl http://localhost:18789 |
sudo ufw allow 18789/tcp + VPS-firewall checken |
Best practices
Een werkende installatie is het begin, niet het einde. Deze gewoonten houd ik zelf aan voor een stabiele en veilige werking op de lange termijn.
🔒 Beveiliging
- Deel je gateway-token nooit
- Gebruik SSH-sleutelauthenticatie
- Open alleen benodigde poorten
- Overweeg IP-whitelist voor dashboard
📊 Resourcebeheer
docker stats openclaw-gateway- Monitor schijfruimte (logs groeien)
- CPU-pieken tijdens gesprekken zijn normaal
🔄 Updates
- Maandelijks controleren op releases
- Eerst testen in testomgeving
- Back-up maken vóór update
- Release notes lezen (breaking changes)
💾 Back-up
- Gateway-token in wachtwoordmanager
- Omgevingsvariabelen documenteren
- AI-model en instellingen noteren
Veelgestelde vragen
Wat is OpenClaw en hoe verschilt het van gewone chatbots? ▼
OpenClaw (voorheen Moltbot of Clawdbot) is een open-source AI-gateway waarmee je krachtige taalmodellen zoals Claude van Anthropic of GPT-4 van OpenAI kunt integreren in berichtenplatformen zoals Telegram of WhatsApp. Het grote verschil met standaard chatbots is dat OpenClaw volledig op jouw eigen server draait, waardoor je volledige controle hebt over je data, je API-kosten en de configuratie. Je bent niet afhankelijk van een externe dienst die de regels bepaalt of plots van prijsmodel verandert. Voor privacybewuste gebruikers in Nederland — en die zijn er genoeg — is dit een aantrekkelijk en transparant alternatief voor cloudgebaseerde chatbotoplossingen.
Hoeveel kost het om OpenClaw te draaien op een VPS? ▼
De kosten voor OpenClaw bestaan uit twee onderdelen: de serverkosten en de API-kosten voor het AI-model. Een instapserver bij aanbieders als Hostinger, Hetzner (populair in Nederland vanwege Europese datacenters) of DigitalOcean kost doorgaans tussen de €4 en €10 per maand voor de minimale specificaties. Daar komen de API-kosten bij: Anthropic en OpenAI rekenen op basis van verbruik in tokens. Bij normaal persoonlijk gebruik blijf je al snel binnen een paar euro per maand. Wie liever een voorspelbaar budget heeft, kan via Hostinger nexos.ai-credits aanschaffen als alternatief voor directe API-toegang. Al met al is OpenClaw zelfhosting een betaalbare keuze vergeleken met kant-en-klare SaaS-abonnementen.
Kan ik OpenClaw ook verbinden met WhatsApp in plaats van Telegram? ▼
Ja, OpenClaw ondersteunt meerdere berichtenplatformen, waaronder WhatsApp. De installatieprocedure voor WhatsApp wijkt iets af van die voor Telegram: waar je bij Telegram een bot aanmaakt via BotFather, koppel je bij WhatsApp je telefoonnummer aan het systeem tijdens de configuratiestap. Hostinger vraagt dit nummer zelfs al direct tijdens de automatische deploymentprocedure. Houd er rekening mee dat de WhatsApp Business API strikte gebruiksvoorwaarden van Meta kent — controleer altijd of je gebruik binnen de richtlijnen valt, zeker als je de bot zakelijk inzet. Telegram wordt voor testdoeleinden algemeen als toegankelijker en flexibeler beschouwd.
Wat moet ik doen als OpenClaw niet meer reageert na een serverherstart? ▼
Dit is een veelvoorkomend probleem dat je eenvoudig kunt voorkomen door Docker's ingebouwde restart-policy correct in te stellen. Controleer in je docker-compose.yml of de regel restart: unless-stopped of restart: always aanwezig is bij de openclaw-gateway service. Als de container na een herstart toch niet automatisch opstart, log je in via SSH en voer je handmatig cd ~/openclaw && docker compose up -d uit. Bekijk daarna de logs met docker compose logs openclaw-gateway om te zien of er configuratiefouten zijn opgetreden. Een goed geconfigureerde restart-policy maakt handmatig ingrijpen in de meeste gevallen overbodig — handig als je even op vakantie bent.