​

Ansible-Installation

​

Schnellstart

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

📦 Vollständige Anleitung: github.com/openclaw/openclaw-ansible Das openclaw-ansible-Repository ist die maßgebliche Quelle für die Ansible-Bereitstellung. Diese Seite bietet einen kurzen Überblick.

​

Was Sie erhalten

• 🔒 Firewall-first-Sicherheit: UFW + Docker-Isolation (nur SSH + Tailscale erreichbar)
• 🔐 Tailscale VPN: Sicherer Remote-Zugriff ohne öffentliche Exponierung von Diensten
• 🐳 Docker: Isolierte Sandbox-Container, Bindings nur an localhost
• 🛡️ Defense in depth: 4‑schichtige Sicherheitsarchitektur
• 🚀 Ein-Befehl-Setup: Vollständige Bereitstellung in wenigen Minuten
• 🔧 Systemd-Integration: Automatischer Start beim Booten mit Härtung

​

Anforderungen

• OS: Debian 11+ oder Ubuntu 20.04+
• Zugriff: Root- oder sudo-Rechte
• Netzwerk: Internetverbindung für Paketinstallation
• Ansible: 2.14+ (wird vom Schnellstart-Skript automatisch installiert)

​

Was wird installiert

1. Tailscale (Mesh-VPN für sicheren Remote-Zugriff)
2. UFW-Firewall (nur SSH- und Tailscale-Ports)
3. Docker CE + Compose V2 (für Agent-sandboxes)
4. Node.js 22.x + pnpm (Runtime-Abhängigkeiten)
5. OpenClaw (hostbasiert, nicht containerisiert)
6. Systemd-Dienst (Autostart mit Sicherheits-Härtung)

​

Post-Install-Einrichtung

sudo -i -u openclaw

1. Onboarding-Assistent: OpenClaw-Einstellungen konfigurieren
2. Anbieter-Login: WhatsApp/Telegram/Discord/Signal verbinden
3. Gateway-Test: Installation verifizieren
4. Tailscale-Einrichtung: Verbindung zu Ihrem VPN-Mesh herstellen

​

Schnelle Befehle

# Check service status
sudo systemctl status openclaw

# View live logs
sudo journalctl -u openclaw -f

# Restart gateway
sudo systemctl restart openclaw

# Provider login (run as openclaw user)
sudo -i -u openclaw
openclaw channels login

​

Sicherheitsarchitektur

​

4‑schichtige Verteidigung

1. Firewall (UFW): Öffentlich nur SSH (22) + Tailscale (41641/udp)
2. VPN (Tailscale): Gateway nur über das VPN-Mesh erreichbar
3. Docker-Isolation: DOCKER-USER-iptables-Chain verhindert externe Portfreigaben
4. Systemd-Härtung: NoNewPrivileges, PrivateTmp, nicht privilegierter Benutzer

​

Verifikation

nmap -p- YOUR_SERVER_IP

​

Docker-Verfügbarkeit

​

Manuelle Installation

# 1. Install prerequisites
sudo apt update && sudo apt install -y ansible git

# 2. Clone repository
git clone https://github.com/openclaw/openclaw-ansible.git
cd openclaw-ansible

# 3. Install Ansible collections
ansible-galaxy collection install -r requirements.yml

# 4. Run playbook
./run-playbook.sh

# Or run directly (then manually execute /tmp/openclaw-setup.sh after)
# ansible-playbook playbook.yml --ask-become-pass

​

OpenClaw aktualisieren

cd openclaw-ansible
./run-playbook.sh

​

Fehlerbehebung

​

Firewall blockiert meine Verbindung

• Stellen Sie sicher, dass Sie zuerst über das Tailscale-VPN zugreifen können
• SSH-Zugriff (Port 22) ist immer erlaubt
• Das Gateway ist ausschließlich über Tailscale erreichbar — absichtlich so konzipiert

​

Dienst startet nicht

# Check logs
sudo journalctl -u openclaw -n 100

# Verify permissions
sudo ls -la /opt/openclaw

# Test manual start
sudo -i -u openclaw
cd ~/openclaw
pnpm start

​

Docker-Sandbox-Probleme

# Verify Docker is running
sudo systemctl status docker

# Check sandbox image
sudo docker images | grep openclaw-sandbox

# Build sandbox image if missing
cd /opt/openclaw/openclaw
sudo -u openclaw ./scripts/sandbox-setup.sh

​

Anbieter-Login schlägt fehl

sudo -i -u openclaw
openclaw channels login

​

Erweiterte Konfiguration

• Sicherheitsarchitektur
• Technische Details
• Fehlerbehebungsleitfaden

​

Verwandt

• openclaw-ansible — vollständige Bereitstellungsanleitung
• Docker — containerisierte Gateway-Einrichtung
• Sandboxing — Agent-Sandbox-Konfiguration
• Multi-Agent Sandbox & Tools — Isolation pro Agent