Ansible

Implementeer OpenClaw op productieservers met openclaw-ansible, een geautomatiseerd installatieprogramma met een architectuur waarin beveiliging vooropstaat.

De openclaw-ansible-repository is de gezaghebbende bron voor implementatie met Ansible. Deze pagina biedt een kort overzicht.

Vereisten

Vereiste	Details
OS	Debian 11+ of Ubuntu 20.04+
Toegang	Root- of sudo-rechten
Netwerk	Internetverbinding voor de installatie van pakketten
Ansible	2.14+ (automatisch geïnstalleerd door het quickstartscript)

Wat je krijgt

Beveiliging met de firewall voorop: UFW + Docker-isolatie (alleen SSH + Tailscale bereikbaar)
Tailscale-VPN voor externe toegang zonder services openbaar beschikbaar te maken
Docker voor geïsoleerde sandboxcontainers met bindingen uitsluitend aan localhost
Systemd-integratie met beveiligingsversterking en automatisch starten tijdens het opstarten
Installatie met één opdracht

Snel aan de slag

curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw-ansible/main/install.sh | bash

Wat er wordt geïnstalleerd

Tailscale (mesh-VPN voor veilige externe toegang)
UFW-firewall (alleen poorten voor SSH + Tailscale)
Docker CE + Compose V2 (standaardbackend voor agentsandboxes)
Node.js en pnpm (OpenClaw vereist Node 22.22.3+, 24.15+ of 25.9+; Node 24 wordt aanbevolen)
OpenClaw, hostgebaseerd geïnstalleerd en niet in een container
Een systemd-service met beveiligingsversterking

De Gateway draait rechtstreeks op de host en niet in Docker. Agentsandboxing is optioneel; dit playbook installeert Docker omdat dit de standaardbackend voor sandboxes is. Zie Sandboxing voor andere backends.

Configuratie na installatie

Overschakelen naar de openclaw-gebruiker

sudo -i -u openclaw

De onboardingwizard uitvoeren

Het script voor na de installatie begeleidt je bij het configureren van OpenClaw.

Berichtenkanalen verbinden

Meld je aan bij WhatsApp, Telegram, Discord of Signal:

openclaw channels login --channel <name>

De installatie verifiëren

sudo systemctl status openclaw
sudo journalctl -u openclaw -f

Verbinding maken met Tailscale

Sluit je aan bij je VPN-mesh voor veilige externe toegang.

Snelle opdrachten

# Servicestatus controleren
sudo systemctl status openclaw

# Liveregelboeken bekijken
sudo journalctl -u openclaw -f

# Gateway opnieuw starten
sudo systemctl restart openclaw

# Aanmelden bij kanaal (uitvoeren als openclaw-gebruiker)
sudo -i -u openclaw
openclaw channels login --channel <name>

Beveiligingsarchitectuur

Verdedigingsmodel met vier lagen:

Firewall (UFW): alleen SSH (22) en Tailscale (41641/udp) zijn openbaar bereikbaar
VPN (Tailscale): Gateway is alleen bereikbaar via de VPN-mesh
Docker-isolatie: de iptables-keten DOCKER-USER voorkomt dat poorten extern beschikbaar worden
Systemd-beveiligingsversterking: NoNewPrivileges, PrivateTmp, gebruiker zonder verhoogde rechten

Controleer je externe aanvalsoppervlak:

nmap -p- YOUR_SERVER_IP

Alleen poort 22 (SSH) hoort open te zijn. Gateway en Docker blijven afgeschermd. Docker wordt geïnstalleerd voor agentsandboxes (geïsoleerde uitvoering van tools), niet om de Gateway uit te voeren. Zie Multi-agentsandbox en tools voor de sandboxconfiguratie.

Handmatige installatie

Vereisten installeren

sudo apt update && sudo apt install -y ansible git

De repository klonen

git clone https://github.com/openclaw/openclaw-ansible.git
cd openclaw-ansible

Ansible-collecties installeren

ansible-galaxy collection install -r requirements.yml

Het playbook uitvoeren

./run-playbook.sh

Je kunt het playbook ook rechtstreeks uitvoeren en vervolgens het configuratiescript handmatig uitvoeren:

ansible-playbook playbook.yml --ask-become-pass
# Voer daarna uit: /tmp/openclaw-setup.sh

Bijwerken

Het Ansible-installatieprogramma configureert OpenClaw voor handmatige updates; zie Bijwerken voor de standaardprocedure. Voer het playbook opnieuw uit, bijvoorbeeld na configuratiewijzigingen:

cd openclaw-ansible
./run-playbook.sh

Dit is idempotent en kan veilig meerdere keren worden uitgevoerd.

Problemen oplossen

De firewall blokkeert mijn verbinding

Maak eerst verbinding via de Tailscale-VPN; de Gateway is bewust alleen op die manier bereikbaar.
SSH (poort 22) is altijd toegestaan.

De service start niet

# Logboeken controleren
sudo journalctl -u openclaw -n 100

# Rechten verifiëren
sudo ls -la /opt/openclaw

# Handmatig starten testen
sudo -i -u openclaw
cd ~/openclaw
openclaw gateway run

Problemen met de Docker-sandbox

# Controleren of Docker actief is
sudo systemctl status docker

# Sandboximage controleren
sudo docker images | grep openclaw-sandbox

# De sandboximage bouwen als deze ontbreekt (vereist een broncodecheckout)
cd /opt/openclaw/openclaw
sudo -u openclaw ./scripts/sandbox-setup.sh
# Zie voor npm-installaties zonder broncodecheckout:
# https://docs.openclaw.ai/gateway/sandboxing#images-and-setup

Aanmelden bij een kanaal mislukt

Zorg dat je opdrachten uitvoert als de gebruiker openclaw:

sudo -i -u openclaw
openclaw channels login --channel <name>

Geavanceerde configuratie

Raadpleeg voor een gedetailleerde beveiligingsarchitectuur en probleemoplossing de openclaw-ansible-repository:

Gerelateerd

openclaw-ansible: volledige implementatiehandleiding
Docker: configuratie van een Gateway in een container
Sandboxing: configuratie van agentsandboxes
Multi-agentsandbox en tools: isolatie per agent

Install overview

Maintenance

Containers

Hosting

Advanced setup

Vereisten

Wat je krijgt

Snel aan de slag

Wat er wordt geïnstalleerd

Configuratie na installatie

Snelle opdrachten

Beveiligingsarchitectuur

Handmatige installatie

Bijwerken

Problemen oplossen

Geavanceerde configuratie

Gerelateerd

​Vereisten

​Wat je krijgt

​Snel aan de slag

​Wat er wordt geïnstalleerd

​Configuratie na installatie

​Snelle opdrachten

​Beveiligingsarchitectuur

​Handmatige installatie

​Bijwerken

​Problemen oplossen

​Geavanceerde configuratie

​Gerelateerd

Vereisten

Wat je krijgt

Snel aan de slag

Wat er wordt geïnstalleerd

Configuratie na installatie

Snelle opdrachten

Beveiligingsarchitectuur

Handmatige installatie

Bijwerken

Problemen oplossen

Geavanceerde configuratie

Gerelateerd