Erste Schritte mit OpenClaw

Der grte Fehler von Anfngern: versuchen, sofort alles anzuschlieen. Tu es nicht. Bring das Grundsystem mit einem Kanal und einem Modell zum Laufen. Beweise, dass es funktioniert. Dann schichte den Rest dazu. OpenClaw belohnt saubere Reihenfolge. Es bestraft Chaos mit Zinsen.

Was du brauchst, bevor du startest

Einen Rechner oder VPS, auf dem OpenClaw laufen soll (Ubuntu 22.04/24.04 LTS empfohlen)
Mindestens 2GB RAM (4GB empfohlen) und 10GB+ Speicher
Node.js v20 oder neuer
Einen API-Schlssel von einem KI-Anbieter (Anthropic, OpenAI oder Google)
Docker und Docker Compose (falls du den Container-Weg gehst, was empfohlen wird)

Schritt 1: OpenClaw installieren

Zwei Wege. Whle einen.

Option A: Direkte Installation (schneller Start)

Fhre npm install -g openclaw aus, dann openclaw init. Der Einrichtungsassistent fhrt dich durch die Grundlagen.

Option B: Docker-Installation (empfohlen fr VPS)

Repo klonen, .env-Datei konfigurieren und das Setup-Skript ausfhren. Docker gibt dir Isolierung, Persistenz und eine saubere Umgebung, die dein Host-Betriebssystem in Ruhe lsst.

Die vollstndigen Docker-Schritte stehen in der offiziellen Docker-Doku.

Schritt 2: KI-Anbieter konfigurieren

OpenClaw ist kein eigenes KI-Modell. Es gibt Werkzeuge und Struktur zu dem Modell, das du verbindest. Du brauchst einen API-Schlssel von mindestens einem Anbieter.

Anthropic (Claude): Hufigster Startpunkt. Sonnet fr allgemeine Nutzung, Haiku fr gnstige/schnelle Aufgaben.
OpenAI (GPT): Solide Wahl, wenn du bereits ein OpenAI-Konto hast.
Google (Gemini): Gut fr web-basierte Aufgaben.
Lokale Modelle (Ollama, LM Studio): Kostenlos, aber langsamer. Gut fr datenschutzorientierte Setups.

Schritt 3: Ersten Kanal verbinden

Hier wird OpenClaw greifbar. Du verbindest es mit einer Chat-App, die du schon nutzt, und auf einmal hast du einen KI-Assistenten in deinem Telegram, WhatsApp oder Discord.

Telegram: Am einfachsten einzurichten. Bot ber BotFather erstellen, Token hinzufgen. In Minuten erledigt.
WhatsApp: Nutzt QR-Pairing. Funktioniert gut, aber Sessions knnen ablaufen und mssen neu gekoppelt werden.
Discord: Gut fr Team-Setups. Bot im Discord Developer Portal erstellen.

Whle einen. Teste ihn. Stelle sicher, dass Nachrichten in beide Richtungen flien, bevor du weitere hinzufgst.

Schritt 4: Gesundheits-Check ausfhren

Nach der Einrichtung openclaw doctor ausfhren. Das ist der Befehl, den die meisten Anfnger berspringen und spter bereuen. Er prft deine Konfiguration, Verbindungen und hufige Fehler automatisch.

Schritt 5: Ersten Skill installieren

Skills machen OpenClaw mehr als eine Chat-Oberflche. Sie sind modulare Pakete, die deinem Agenten neue Fhigkeiten beibringen: Web-Suche, Kalenderverwaltung, E-Mail-Bearbeitung, Coding-Workflows und viele mehr.

Einen von ClawHub mit einem einzigen Befehl installieren. Fang mit etwas Einfachem und sofort Ntzlichem an. Lies den Quellcode vor der Installation (wichtig fr die Sicherheit).

Schritt 6: Setup absichern

In Docker ausfhren, nicht direkt auf deinem Hauptrechner
Gateway an localhost (127.0.0.1) binden, nicht 0.0.0.0
Starkes Gateway-Token in .env setzen
Port 18789 auf dem VPS durch Firewall blockieren
API-Schlssel in .env mit eingeschrnkten Berechtigungen (chmod 600)
openclaw security audit ausfhren

10 Fehler, die Anfnger machen

Falscher API-Schlssel: OpenAI-Key bei Anthropic-Konfiguration (oder umgekehrt). Gateway zeigt "0 tokens used."
Zu altes Node.js: Braucht v20+. ltere Versionen verursachen kryptische Syntax-Fehler.
Fehlende Build-Tools: Auf Linux brauchst du build-essential, git und python3.
Port-Konflikt: Standard-Port 18789 wird von einem anderen Dienst blockiert.
Nicht in Docker: Direkt auf dem Host-Betriebssystem setzt mehr aufs Spiel als ntig.
DM-Richtlinie offen: Jeder kann deinem Agenten schreiben.
openclaw doctor bersprungen: Verpasst einfach behebbare Konfigurationsprobleme.
Docker-Volumes vergessen: Daten gehen bei Container-Neustart verloren.
Gateway ohne Authentifizierung: Port 18789 ffentlich zugnglich.
Nie frische Sessions: Angewachsener Kontext erhht Token-Kosten. /new vor aufwendigen Aufgaben nutzen.

Was als nchstes

Einen Skill installieren, den du wirklich brauchst
Einen echten Workflow Ende-zu-Ende testen
Den Sicherheits-Guide lesen, bevor du mehr Werkzeuge hinzufgst (EN)
Hufige Fehler checken, wenn etwas nicht stimmt (EN)

Need help from people who already use this stuff?

Schneller zum stabilen Setup?

Tritt My AI Agent Profit Lab bei: praktische Hilfe von Leuten, die denselben Einrichtungs-Frust schon berwunden haben.

Join My AI Agent Profit Lab See the community page

FAQ

Wie lange dauert die Einrichtung?

Die Grundinstallation dauert 15 bis 30 Minuten. Eine vollstndige VPS-Einrichtung mit Docker, einem Kanal und ein paar Skills etwa eine Stunde. Plane extra Zeit ein, wenn Docker oder Terminal-Befehle neu fr dich sind.

Brauche ich einen VPS?

Nicht zwingend. Du kannst es auf einem Mac, einem Linux-Desktop oder einem Raspberry Pi betreiben. Fr stndige Verfgbarkeit ist ein gnstiger VPS (2GB+ RAM) mit Docker aber der zuverlssigste Weg.

Welches KI-Modell sollte ich nutzen?

Anthropic Claude Sonnet ist die hufigste Wahl fr ein gutes Preis-Leistungs-Verhltnis. Du kannst Modelle spter wechseln. Vermeide die teuersten Modelle (wie Opus) als Standard fr Routine-Aufgaben.

Wie halte ich die Kosten unter Kontrolle?

Nutze ein mittelklassiges Modell als Standard, starte frische Sessions mit /new vor aufwendigen Aufgaben, ordne Modelle nach Aufgabenkomplexitt zu und berwache deinen API-Verbrauch.