OpenClaw installieren: Einrichtung Schritt für Schritt (Mac/Windows/Linux)

"Wenn Sie Instant-Nudeln kochen können, können Sie auch OpenClaw installieren. Dauert ungefähr genauso lange."

Heutiges Ziel

Schritt 0: Entscheiden, wo Ihr Assistent lebt

Die erste Entscheidung: Wo läuft Ihr Assistent?

Empfohlene Spezifikationen für VPS: Ubuntu 22.04, 2 CPU-Kerne, 4 GB RAM, 40 GB SSD.

Welche Umgebung sollte ich wählen?

• Nur zum Testen → Laptop (am einfachsten, aber nur aktiv, wenn der Laptop an ist)
• 24/7-Uptime gewünscht → VPS (5-10 USD/Monat, läuft weiter, während Sie schlafen)
• 24/7 ohne Cloud → Mac Mini oder alter PC

Die Arbeitsdateien von OpenClaw liegen normalerweise unter ~/.openclaw/workspace/, egal welche Umgebung Sie wählen, und installierte Skills liegen typischerweise unter ~/.openclaw/skills/.

Sie wissen, dass dieser Schritt erledigt ist, wenn Sie beantworten können: "Welche genaue Maschine bleibt für meinen Assistenten online?"

Schritt 1: Voraussetzungen besorgen

Bevor Sie den Installer ausführen, sollten Sie Folgendes bereithalten:

Node 22.16 oder neuer (Node 24 ist die standardmäßig empfohlene Runtime)

• Warum Sie es brauchen: Die openclaw CLI läuft auf Node.js.
• Prüfen Sie mit node -v. Wenn Sie Node 22.16 oder neuer sehen, sind Sie bereit.

Zugang zu einem KI-Modell (eins auswählen)

• Claude-Abonnement (Pro/Max/Team)
  • Warum Sie es brauchen: Der Assistent benötigt weiterhin einen Modellanbieter für jede Antwort und jeden Tool-Plan.
  • Verwenden Sie OAuth im Assistenten, dann müssen Sie keinen API-Key einfügen.
• Anthropic API-Key
  • Warum Sie ihn brauchen: Diese Zugangsdaten nutzt OpenClaw für direkte Aufrufe an Anthropic.
  • Erhältlich unter console.anthropic.com.
• Ebenfalls unterstützt: OpenAI, Gemini, OpenRouter, Qwen, Mistral und weitere.
  • Warum Sie das brauchen: Jeder unterstützte Anbieter kann den Assistenten betreiben, wenn Claude nicht Ihre Wahl ist.

Telegram Bot Token

1. Öffnen Sie Telegram und suchen Sie nach @BotFather.
2. Senden Sie /newbot und wählen Sie einen Namen sowie Benutzernamen.
3. Kopieren Sie das Token, das BotFather zurückgibt.

Warum Sie es brauchen: Dieses Token erlaubt OpenClaw, über Ihren Bot Telegram-Nachrichten zu empfangen und zu senden.

Ihre Telegram User ID

• Suchen Sie in Telegram nach @userinfobot und kopieren Sie Ihre numerische ID.
• Warum Sie sie brauchen: Das Onboarding markiert Sie damit als Admin, sodass keine zufälligen Personen Ihren Assistenten steuern können.

Sie wissen, dass dieser Schritt erledigt ist, wenn Sie vier Dinge zur Hand haben: eine Maschine, Node 22.16 oder neuer, einen Modellzugang und beide Telegram-Werte.

Schritt 2: Installieren

Ausführen:

curl -fsSL https://openclaw.ai/install.sh | bash

Das ist der offizielle Einzeiler. Er installiert OpenClaw und installiert bei Bedarf automatisch Node.

Alternative manuelle Installation:

npm install -g openclaw@latest && openclaw onboard

Dieser manuelle Weg installiert die CLI direkt und startet danach den Onboarding-Assistenten, der Ihre initiale Konfiguration unter ~/.openclaw/workspace/ schreibt.

Plattform-Anleitung: macOS → Plattform-Anleitung: Windows → Plattform-Anleitung: Linux / VPS →

Sie wissen, dass es funktioniert hat, wenn sich der Assistent öffnet statt command not found zurückzugeben und nach dem Onboarding openclaw status einen laufenden Dienst zeigt.

Schritt 3: Was der Assistent abfragt

Der Setup-Assistent führt durch fünf Eingaben:

1. Mode - Wählen Sie QuickStart, wenn dies Ihre erste Installation ist.
2. AI Model - Anbieter auswählen und authentifizieren.
3. Chat Channel - Telegram auswählen und Ihren Bot Token einfügen.
4. Admin Setup - Ihre Telegram User ID eingeben.
5. Daemon Install - Mit Ja bestätigen, damit der Assistent im Hintergrund läuft und Neustarts überlebt.

Unter Linux ist das normalerweise eine systemd User Unit. Unter macOS ist es normalerweise ein LaunchAgent. Das Ziel ist in beiden Fällen gleich: OpenClaw soll nach einem Neustart automatisch wieder starten.

Sie wissen, dass dieser Schritt funktioniert hat, wenn die Daemon-Installation ohne Fehler endet und openclaw status statt "stopped" ein gesundes System meldet.

Schritt 4: Ihre erste Nachricht senden

Wenn der Assistent fertig ist, öffnen Sie Telegram, suchen Sie Ihren Bot und senden Sie:

Hello - who are you?

Sie sollten innerhalb weniger Sekunden eine Antwort bekommen. Sie klingt im Moment noch generisch, weil Sie Dateien wie ~/.openclaw/workspace/SOUL.md noch nicht angepasst haben. Das kommt an Tag 3.

Probieren Sie noch ein paar aus:

• "Write a Python quicksort"
• "What's the square root of 1024?"
• "Can you check my email?" (Es sollte fürs Erste Nein sagen.)

Sie wissen, dass dieser Schritt funktioniert hat, wenn Telegram eine echte Bot-Antwort zeigt und openclaw logs --follow keinen wiederkehrenden Fehler für diese Nachricht ausgibt.

Mindest-Erfolgskriterien

Nach heute sollten Sie Folgendes können:

• openclaw status ausführen und einen laufenden Dienst sehen
• In Telegram eine Nachricht senden und eine Antwort erhalten
• Computer aus- und wieder einschalten - Dienst startet automatisch neu

Prüfung: Machen Sie den Neustart-Test jetzt, nicht später. Wenn der Dienst nicht automatisch zurückkommt, beheben Sie das, bevor Sie weitermachen.

Befehle für den täglichen Betrieb

Diese Befehle werden Sie regelmäßig nutzen:

openclaw status           # Overall health
openclaw doctor           # Full diagnostic check
openclaw gateway restart  # Restart background service
openclaw logs --follow    # View runtime logs
openclaw configure        # Change model, channel, or any setting

Sie wissen, dass diese Befehle für den Grundbetrieb reichen, wenn Sie zwei Fragen schnell beantworten können: "Läuft es?" und "Was sagen die Logs?"

Häufige Probleme

Port bereits belegt - Ein anderer Prozess belegt bereits den Port, den OpenClaw verwenden möchte. Prüfen Sie den Fehler in openclaw logs --follow, beenden Sie den konfliktenden Prozess und führen Sie dann openclaw daemon restart aus. Sie wissen, dass es behoben ist, wenn die Logs den Bind-Fehler nicht mehr wiederholen und openclaw status gesund zurückmeldet.

Telegram-Bot antwortet nicht - Meist ist das Bot-Token falsch, Ihre Telegram User ID fehlt oder der Daemon wurde nie gestartet. Führen Sie openclaw configure oder openclaw onboard erneut aus und senden Sie danach eine frische Testnachricht. Sie wissen, dass es funktioniert, wenn der Bot antwortet und die Logs die eingehende Nachricht statt eines Auth-Fehlers zeigen.

Dienst startet nach Neustart nicht - Der Schritt zur Daemon-Installation ist wahrscheinlich fehlgeschlagen oder wurde übersprungen. Führen Sie openclaw doctor aus, installieren Sie den Daemon bei Bedarf erneut und starten Sie dann noch einmal neu. Sie wissen, dass es behoben ist, wenn openclaw status direkt nach Login oder Serverstart "running" zeigt.

Vollständige Troubleshooting-Anleitung →

Was als Nächstes kommt

Ihr Assistent kann chatten, aber er hat noch keine Persönlichkeit und keine Anweisungen. Morgen formen Sie das, indem Sie zentrale Dateien unter ~/.openclaw/workspace/ bearbeiten, darunter ~/.openclaw/workspace/SOUL.md, ~/.openclaw/workspace/USER.md, ~/.openclaw/workspace/AGENTS.md und ~/.openclaw/workspace/IDENTITY.md.