OpenClaw installeren en configureren: Nederlandse handleiding

Er zijn tientallen Engelse tutorials voor OpenClaw. Maar een complete Nederlandse handleiding? Die bestond niet. Tot nu.

Dit is alles wat je moet weten om OpenClaw te installeren, configureren en draaien. In het Nederlands, stap voor stap, met alle commando's die je nodig hebt.

Wat is OpenClaw?

OpenClaw is een open-source framework om AI-agents te bouwen. Het draait als een programma (in een Docker-container) op een server en kan verbinden met:

• Telegram — de populairste optie voor chatbots
• WhatsApp — via de Business API
• Discord — voor communities
• Slack — voor teams
• Twitter/X — voor sociale media
• Direct — via een API (voor eigen apps)

Je geeft OpenClaw een "character file" — een configuratiebestand dat bepaalt wie je bot is, wat hij weet, en hoe hij praat. De AI (Claude, GPT-4, Gemini, etc.) doet de rest.

Optie A: Installeren via ClawPort (60 seconden)

De snelste route. Geen terminal, geen Docker, geen Linux-kennis nodig.

1. Ga naar clawport.io en maak een account
2. Klik op "Nieuwe agent"
3. Vul in: naam, persoonlijkheid, kennisbestanden
4. Plak je AI-model API-key
5. Verbind Telegram of WhatsApp
6. Klik op "Deploy"

Klaar. Je bot draait. Ga naar de tutorial voor meer details.

De rest van deze handleiding is voor wie het zelf wilt hosten.

Optie B: Zelf installeren

Vereisten

• Een Linux-server (Ubuntu 22.04 of 24.04 aangeraden)
• Docker en Docker Compose
• Basis terminal/SSH kennis
• Een domeinnaam (optioneel, maar aanbevolen)

Stap 1: Server huren

De goedkoopste opties:

Aanbevolen: Hetzner CX22 (€4/maand, 4 GB RAM, Duitsland). Beste prijs-kwaliteit en AVG-conform.

Stap 2: Inloggen via SSH

ssh root@jouw-server-ip

Stap 3: Systeem updaten

apt update && apt upgrade -y

Stap 4: Docker installeren

# Docker installeren
curl -fsSL https://get.docker.com | sh

# Docker Compose (als het niet automatisch is geïnstalleerd)
apt install docker-compose-plugin -y

# Testen
docker --version
docker compose version

Stap 5: OpenClaw ophalen

# Maak een werkdirectory
mkdir -p /opt/openclaw && cd /opt/openclaw

# Clone de repository
git clone https://github.com/openclaw/openclaw.git .

Stap 6: Character file aanmaken

Dit is het hart van je bot. Maak een bestand characters/mijn-bot.character.json:

{
  "name": "Lisa",
  "description": "Klantenservice-assistent voor Bakkerij De Hoek",
  "system": "Je bent Lisa, de vriendelijke klantenservice-assistent van Bakkerij De Hoek in Amsterdam. Je helpt klanten met vragen over producten, openingstijden, bestellingen en allergieën. Je bent warm, behulpzaam en kent alle producten. Als je iets niet weet, zeg je dat eerlijk en verwijs je naar het team. Je antwoordt altijd in het Nederlands.",
  "bio": [
    "Lisa werkt bij Bakkerij De Hoek sinds de opening",
    "Ze kent elk product en elke ingrediëntenlijst",
    "Ze is geduldig en helpt graag met speciale bestellingen"
  ],
  "knowledge": [
    "Openingstijden: dinsdag t/m zaterdag 8:00-18:00, zondag en maandag gesloten",
    "Adres: Hoekstraat 12, 1012 AB Amsterdam",
    "Glutenvrij brood beschikbaar (wit en meergranen, €4,50)",
    "Verjaardagstaarten: bestel minimaal 3 dagen van tevoren",
    "Bezorging mogelijk binnen Amsterdam, €5 bezorgkosten",
    "Alle broden worden dagelijks vers gebakken, geen conserveringsmiddelen"
  ],
  "clients": ["telegram"],
  "modelProvider": "anthropic",
  "settings": {
    "model": "claude-sonnet-4-20250514"
  }
}

Stap 7: Environment variables

Maak een .env bestand:

# AI Model API Key
ANTHROPIC_API_KEY=sk-ant-jouw-api-key-hier

# Telegram (optioneel, als je Telegram wilt)
TELEGRAM_BOT_TOKEN=jouw-telegram-bot-token

# Algemeen
LOG_LEVEL=info

Stap 8: Docker Compose bestand

Maak een docker-compose.yml:

version: '3.8'
services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: mijn-bot
    restart: unless-stopped
    env_file: .env
    volumes:
      - ./characters:/app/characters
      - ./data:/app/data
    ports:
      - "127.0.0.1:3000:3000"
    command: ["--character", "characters/mijn-bot.character.json"]

Let op: 127.0.0.1:3000:3000 bindt de poort alleen aan localhost. Dit is een beveiligingsmaatregel — de container is niet rechtstreeks bereikbaar van buitenaf.

Stap 9: Starten

docker compose up -d

Controleer of het draait:

docker compose logs -f

Je zou moeten zien: "Character loaded: Lisa" en "Telegram client connected."

Stap 10: Telegram bot aanmaken

1. Open Telegram en zoek @BotFather
2. Stuur /newbot
3. Kies een naam ("Bakkerij De Hoek Bot")
4. Kies een gebruikersnaam ("bakkerijdehoek_bot")
5. Kopieer het token
6. Plak het in je .env als TELEGRAM_BOT_TOKEN
7. Herstart: docker compose restart

Beveiligen

Lees onze complete security hardening guide (Engels), maar de basis:

# Firewall instellen
ufw allow ssh
ufw allow 80
ufw allow 443
ufw enable

# Swap toevoegen (voorkomt out-of-memory crashes)
fallocate -l 4G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab

# Bestanden beveiligen
chmod 600 .env
chmod 600 characters/*.json

Veelvoorkomende problemen

De keuze

Zelf hosten is goedkoper maar kost tijd. ClawPort kost €5/maand meer maar bespaart 50+ uur per jaar.

Kies wat bij je past.

---

Geen zin om dit allemaal zelf te doen? ClawPort regelt het voor je. Eigen bot, eigen data, geen gedoe. Vanaf €9/maand. Probeer het →