Skip to main content

Ansible-installation

Det rekommenderade sättet att distribuera OpenClaw till produktionsservrar är via openclaw-ansible — ett automatiserat installationsverktyg med säkerhet-först-arkitektur.

Snabbstart

Installation med ett kommando:
📦 Fullständig guide: github.com/openclaw/openclaw-ansible Den öppen-ansible repo är källan till sanningen för Ansible utplacering. Denna sida är en snabb översikt.

Vad du får

  • 🔒 Brandvägg-först-säkerhet: UFW + Docker-isolering (endast SSH + Tailscale åtkomliga)
  • 🔐 Tailscale VPN: Säker fjärråtkomst utan att exponera tjänster offentligt
  • 🐳 Docker: Isolerade sandbox-containrar, bindningar endast till localhost
  • 🛡️ Defense in depth: Säkerhetsarkitektur i 4 lager
  • 🚀 Installation med ett kommando: Fullständig driftsättning på minuter
  • 🔧 Systemd-integration: Autostart vid uppstart med härdning

Förutsättningar

  • OS: Debian 11+ eller Ubuntu 20.04+
  • Åtkomst: Root- eller sudo-behörighet
  • Nätverk: Internetanslutning för paketinstallation
  • Ansible: 2.14+ (installeras automatiskt av snabbstartsskriptet)

Vad som installeras

Ansible-playbooken installerar och konfigurerar:
  1. Tailscale (mesh-VPN för säker fjärråtkomst)
  2. UFW-brandvägg (endast SSH + Tailscale-portar)
  3. Docker CE + Compose V2 (för agent-sandboxar)
  4. Node.js 22.x + pnpm (körtidsberoenden)
  5. OpenClaw (värdbaserad, inte containeriserad)
  6. Systemd-tjänst (autostart med säkerhetshärdning)
Obs: Gateway körs direkt på värden (inte i Docker), men agent sandlådor använder Docker för isolering. Se Sandboxing för detaljer.

Konfiguration efter installation

När installationen är klar, växla till användaren openclaw:
Efterinstallationsskriptet guidar dig genom:
  1. Introduktionsguide: Konfigurera OpenClaw-inställningar
  2. Leverantörsinloggning: Anslut WhatsApp/Telegram/Discord/Signal
  3. Gateway-testning: Verifiera installationen
  4. Tailscale-konfiguration: Anslut till ditt VPN-mesh

Snabba kommandon

Säkerhetsarkitektur

4-lagers försvar

  1. Brandvägg (UFW): Endast SSH (22) + Tailscale (41641/udp) exponeras offentligt
  2. VPN (Tailscale): Gateway (nätverksgateway) är endast åtkomlig via VPN-mesh
  3. Docker-isolering: iptables-kedjan DOCKER-USER förhindrar extern portexponering
  4. Systemd-härdning: NoNewPrivileges, PrivateTmp, oprivilegierad användare

Verifiering

Testa extern attackyta:
Bör visa endast port 22 (SSH) öppen. Alla andra tjänster (gateway, Docker) är låsta.

Docker-tillgänglighet

Docker är installerat för agent sandlådor (isolerat verktygsutförande), inte för att köra själva gatewayen. Gateway binder endast till localhost och är tillgänglig via Tailscale VPN. Se Multi-Agent Sandbox & Tools för sandbox-konfiguration.

Manuell installation

Om du föredrar manuell kontroll över automatiseringen:

Uppdatera OpenClaw

Den Ansible installeraren ställer in OpenClaw för manuella uppdateringar. Se Updating för standarduppdateringsflödet. För att köra Ansible-playbooken igen (t.ex. vid konfigurationsändringar):
Obs: Detta är idempotent och säkert att köra flera gånger.

Felsökning

Brandväggen blockerar min anslutning

Om du är utelåst:
  • Säkerställ att du först kan nå via Tailscale VPN
  • SSH-åtkomst (port 22) är alltid tillåten
  • Gatewayn är endast åtkomlig via Tailscale enligt design

Tjänsten startar inte

Problem med Docker-sandbox

Leverantörsinloggning misslyckas

Se till att du kör som användaren openclaw:

Avancerad konfiguration

För detaljerad säkerhetsarkitektur och felsökning:

Relaterat