OpenClaw Installation & Einrichtung
Diese Anleitung beschreibt die Erstkonfiguration deiner OpenClaw-Instanz unmittelbar nach der automatisierten Installation über das PowerPanel.
Sobald das PowerPanel dein Ubuntu 24.04- oder Debian 13-Template mit OpenClaw fertig bereitgestellt hat, ist der Server für das folgende sicherheitsorientierte Setup bereit.
Schritt 1
Sicheren SSH-Tunnel einrichten
Aus Sicherheitsgründen ist die OpenClaw WebGUI nicht öffentlich erreichbar. Erstelle einen verschlüsselten Tunnel aus deinem lokalen Terminal:
Lokales Terminal
ssh -N -L 18789:127.0.0.1:18789 root@deine-server-ip
Sobald der Tunnel aktiv ist, erreichst du die Oberfläche lokal unter:
Browser-URL (lokal)
http://localhost:18789/overview
Dashboard-Vorschau
Hinweis:Dies ist die erste Ansicht nach der Installation. Der Status zeigt Offline, da der Gateway-Token noch nicht hinterlegt wurde.
Schritt 2
Gateway-Zugang authentifizieren
Melde dich per SSH auf deinem Server an und rufe deinen Sicherheits-Token ab:
Server-Terminal
cat /root/.openclaw/openclaw.json
Kopiere den
gateway_token und füge ihn in das Feld Gateway Token im Browser ein.Gib dein Root-/Admin-Passwort in das Passwortfeld ein. Dies ist erforderlich, um deine aktuelle Sitzung zu verschlüsseln und das Dashboard freizuschalten.
Schritt 3
CLI-Onboarding & erweiterte Einrichtung
Öffne ein neues Terminalfenster (das erste ist durch den Tunnel belegt). Verbinde dich zunächst per normalem SSH:
Lokales Terminal (neues Fenster)
ssh root@deine-server-ip
Führe nach dem Einloggen den Onboarding-Befehl auf deinem Server aus:
Server-Terminal
openclaw onboard
1
Sicherheitsbestätigung
Gib
yes ein, um zu bestätigen, dass der Agent administrativen Zugriff auf dein Betriebssystem erhält.2
Modus & Konfiguration
Wähle QuickStart. Wenn du nach Konfigurationswerten gefragt wirst, wähle „Vorhandene Werte verwenden", um die voreingestellten PowerPanel-Standardwerte beizubehalten.
3
KI-Anbieter & API-Schlüssel
Füge deinen API-Schlüssel ein. Offizielle Links zur Schlüsselerstellung:
4
Messenger-Integration
OpenClaw unterstützt mehrere Plattformen. Jede erfordert einen Bot-Token oder Webhook:
Telegram:Erstelle einen Bot über @BotFather, um deinen Token zu erhalten.
Discord / Slack / Matrix:Richte einen Webhook oder einen spezialisierten Bot-User ein.
Überspringen:Gib
skip ein, wenn du ausschließlich das Web-Dashboard nutzen möchtest.5
Skill-Auswahl
Wähle die Skills aus, die du benötigst. Mit der Leertaste aktivierst/deaktivierst du einen Skill, mit Enter bestätigst du:
| Skill | Funktion | API / Kosten |
|---|---|---|
| 1password | Zugangsdaten & Secrets verwalten. | Abo & Schlüssel |
| github | Repos & Issues verwalten. | Personal Token |
| open-whisper | Sprach-zu-Text-Transkription. | OpenAI API |
| summarize | Texte & Webseiten zusammenfassen. | Inklusive |
| obsidian | Notizen synchronisieren. | Kostenlos |
| blogwatcher | RSS- & Blog-Überwachung. | Kostenlos |
| gifgrep | Integrierte GIF-Suche. | Giphy/Tenor Key |
| camsnap | Webcam-Schnappschuss. | Hardware-Zugriff |
| himalaya | CLI-E-Mail-Client. | SMTP/IMAP |
| nano-pdf | PDF-Datenextraktion. | Kostenlos |
| open-hue | Smarte Lichtsteuerung. | Bridge-Verknüpfung |
Skills verwalten & Clawhub
Neukonfiguration:Um Skills hinzuzufügen oder zu entfernen, öffne eine neue Terminal-Sitzung und führe
openclaw onboard erneut aus.Clawhub (Skillhub):Mit dem Befehl
skillhub kannst du nach Community-entwickelten Skills suchen und diese herunterladen. Wichtig: Hier erhältst du auch öffentliche Updates für deinen Agenten.Mehr über Skills erfahren
6
System-Hooks aktivieren
Im letzten Schritt wirst du gefragt, ob du Hooks aktivieren möchtest. Diese sind essenziell für die Systemintegration des Agenten:
session-memory:Ermöglicht dem Agenten, Kontext zwischen verschiedenen Chat-Sitzungen zu speichern.
command-logger:Führt ein Protokoll ausgeführter Terminal-Befehle zur Fehleranalyse.
bootstrap-extra-files:Bereitet die Umgebung für spezialisierte Skills vor, die zusätzliche Abhängigkeiten benötigen.
boot-md:Erstellt beim Start einen Systemstatusbericht im Markdown-Format.
Script for new:Automatisiert die Ersteinrichtung neuer Workspaces oder Umgebungen.
Mehr über Hooks erfahren
Gateway-Service-Auswahl
Der Gateway-Service (WebGUI) ist bereits durch das PowerPanel auf deinem Server vorinstalliert. Wenn das Onboarding fragt, ob du ihn installieren möchtest, gib einfach
skip ein, um die Einrichtung abzuschließen.Letzter Schritt: Den Bot starten
Am Ende wirst du gefragt: „Wie möchtest du deinen Bot starten?". Dies legt fest, wie du jetzt sofort mit OpenClaw interagieren willst:
Watch in TUI (empfohlen):Öffnet die Terminal-Benutzeroberfläche direkt in deiner SSH-Sitzung. Ideal zum sofortigen Testen und Überwachen von System-Logs in Echtzeit.
Open the Web UI:Gibt die URL zum Web-Dashboard aus. Da dein SSH-Tunnel (Schritt 1) bereits aktiv ist, kannst du einfach
localhost:18789 im Browser neu laden.Do this later:Schließt das Onboarding ab und kehrt zur normalen Kommandozeile zurück. Du kannst den Agenten jederzeit mit
openclaw run starten.Ersteinrichtung abgeschlossen?
Hier erfährst du, wie du deinen Server und deine Daten absicherst.
Zum Sicherheitsleitfaden