Ansible

Stellen Sie OpenClaw mit openclaw-ansible auf Produktionsservern bereit – einem automatisierten Installationsprogramm mit einer sicherheitsorientierten Architektur.

Das Repository openclaw-ansible ist die maßgebliche Quelle für die Bereitstellung mit Ansible. Diese Seite bietet einen kurzen Überblick.

Voraussetzungen

Anforderung	Details
Betriebssystem	Debian 11+ oder Ubuntu 20.04+
Zugriff	Root- oder sudo-Berechtigungen
Netzwerk	Internetverbindung für die Paketinstallation
Ansible	2.14+ (wird vom Schnellstartskript automatisch installiert)

Leistungsumfang

Firewall-orientierte Sicherheit: UFW + Docker-Isolierung (nur SSH + Tailscale erreichbar)
Tailscale-VPN für den Remotezugriff, ohne Dienste öffentlich zugänglich zu machen
Docker für isolierte Sandbox-Container mit ausschließlich an localhost gebundenen Schnittstellen
Systemd-Integration mit Härtung und automatischem Start beim Booten
Einrichtung mit einem einzigen Befehl

Schnellstart

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

Installierte Komponenten

Tailscale (Mesh-VPN für sicheren Remotezugriff)
UFW-Firewall (nur SSH- + Tailscale-Ports)
Docker CE + Compose V2 (standardmäßiges Sandbox-Backend für Agenten)
Node.js und pnpm (OpenClaw erfordert Node 22.22.3+, 24.15+ oder 25.9+; Node 24 wird empfohlen)
OpenClaw, hostbasiert und nicht containerisiert installiert
Ein systemd-Dienst mit Sicherheitshärtung

Das Gateway wird direkt auf dem Host und nicht in Docker ausgeführt. Die Sandbox-Isolierung für Agenten ist optional; dieses Playbook installiert Docker, da es das standardmäßige Sandbox- Backend ist. Weitere Backends finden Sie unter Sandbox-Isolierung.

Einrichtung nach der Installation

Zum Benutzer openclaw wechseln

sudo -i -u openclaw

Den Onboarding-Assistenten ausführen

Das Skript für die Einrichtung nach der Installation führt Sie durch die Konfiguration von OpenClaw.

Messaging-Kanäle verbinden

Melden Sie sich bei WhatsApp, Telegram, Discord oder Signal an:

openclaw channels login --channel <name>

Die Installation überprüfen

sudo systemctl status openclaw
sudo journalctl -u openclaw -f

Mit Tailscale verbinden

Treten Sie Ihrem VPN-Mesh bei, um sicheren Remotezugriff zu erhalten.

Kurzbefehle

# Dienststatus prüfen
sudo systemctl status openclaw

# Live-Protokolle anzeigen
sudo journalctl -u openclaw -f

# Gateway neu starten
sudo systemctl restart openclaw

# Kanalanmeldung (als Benutzer openclaw ausführen)
sudo -i -u openclaw
openclaw channels login --channel <name>

Sicherheitsarchitektur

Vierstufiges Schutzmodell:

Firewall (UFW): Nur SSH (22) und Tailscale (41641/udp) sind öffentlich zugänglich
VPN (Tailscale): Das Gateway ist nur über das VPN-Mesh erreichbar
Docker-Isolierung: Die iptables-Kette DOCKER-USER verhindert die externe Freigabe von Ports
Systemd-Härtung: NoNewPrivileges, PrivateTmp, unprivilegierter Benutzer

Überprüfen Sie Ihre externe Angriffsfläche:

nmap -p- YOUR_SERVER_IP

Nur Port 22 (SSH) sollte geöffnet sein. Gateway und Docker bleiben abgeschottet. Docker wird für Agenten-Sandboxes (isolierte Werkzeugausführung) installiert, nicht für die Ausführung des Gateways. Informationen zur Sandbox-Konfiguration finden Sie unter Multi-Agent-Sandbox und Werkzeuge.

Manuelle Installation

Voraussetzungen installieren

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

Das Repository klonen

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

Ansible-Sammlungen installieren

ansible-galaxy collection install -r requirements.yml

Das Playbook ausführen

./run-playbook.sh

Alternativ können Sie das Playbook direkt und anschließend das Einrichtungsskript manuell ausführen:

ansible-playbook playbook.yml --ask-become-pass
# Anschließend ausführen: /tmp/openclaw-setup.sh

Aktualisierung

Das Ansible-Installationsprogramm richtet OpenClaw für manuelle Aktualisierungen ein. Den Standardablauf finden Sie unter Aktualisierung. So führen Sie das Playbook erneut aus (beispielsweise nach Konfigurationsänderungen):

cd openclaw-ansible
./run-playbook.sh

Der Vorgang ist idempotent und kann sicher mehrmals ausgeführt werden.

Fehlerbehebung

Die Firewall blockiert meine Verbindung

Stellen Sie zuerst eine Verbindung über das Tailscale-VPN her; das Gateway ist absichtlich nur auf diesem Weg erreichbar.
SSH (Port 22) ist immer zulässig.

Der Dienst startet nicht

# Protokolle prüfen
sudo journalctl -u openclaw -n 100

# Berechtigungen überprüfen
sudo ls -la /opt/openclaw

# Manuellen Start testen
sudo -i -u openclaw
cd ~/openclaw
openclaw gateway run

Probleme mit der Docker-Sandbox

# Überprüfen, ob Docker ausgeführt wird
sudo systemctl status docker

# Sandbox-Image prüfen
sudo docker images | grep openclaw-sandbox

# Fehlendes Sandbox-Image erstellen (erfordert einen Quellcode-Checkout)
cd /opt/openclaw/openclaw
sudo -u openclaw ./scripts/sandbox-setup.sh
# Informationen zu npm-Installationen ohne Quellcode-Checkout finden Sie unter
# https://docs.openclaw.ai/gateway/sandboxing#images-and-setup

Kanalanmeldung schlägt fehl

Stellen Sie sicher, dass Sie den Befehl als Benutzer openclaw ausführen:

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

Erweiterte Konfiguration

Ausführliche Informationen zur Sicherheitsarchitektur und Fehlerbehebung finden Sie im Repository openclaw-ansible:

Install overview

Maintenance

Containers

Hosting

Advanced setup

Voraussetzungen

Leistungsumfang

Schnellstart

Installierte Komponenten

Einrichtung nach der Installation

Kurzbefehle

Sicherheitsarchitektur

Manuelle Installation

Aktualisierung

Fehlerbehebung

Erweiterte Konfiguration

Verwandte Themen

​Voraussetzungen

​Leistungsumfang

​Schnellstart

​Installierte Komponenten

​Einrichtung nach der Installation

​Kurzbefehle

​Sicherheitsarchitektur

​Manuelle Installation

​Aktualisierung

​Fehlerbehebung

​Erweiterte Konfiguration

​Verwandte Themen

Voraussetzungen

Leistungsumfang

Schnellstart

Installierte Komponenten

Einrichtung nach der Installation

Kurzbefehle

Sicherheitsarchitektur

Manuelle Installation

Aktualisierung

Fehlerbehebung

Erweiterte Konfiguration

Verwandte Themen