Der vollständige OpenClaw-Leitfaden: Von der ersten Installation zum Power User

Was ist OpenClaw und warum sollte es Sie interessieren?

OpenClaw ist ein Open-Source-KI-Agent, der auf Ihrem eigenen Rechner läuft — Ihrem Laptop, einem Heimserver oder einem Cloud-VPS. Im Gegensatz zu browserbasierten KI-Tools, die nur Fragen beantworten, handelt OpenClaw aktiv: Es liest Ihre E-Mails, plant Meetings, organisiert Dateien, sendet Nachrichten über WhatsApp, Telegram und Discord und automatisiert wiederkehrende Arbeitsabläufe — alles durch natürliche Sprache.

Seit dem Start im Januar 2026 hat das Projekt 244.000 GitHub Stars überschritten und ist damit eines der am schnellsten wachsenden Open-Source-Repositories aller Zeiten. Der Grund ist einfach: Menschen wollen einen KI-Assistenten, der tatsächlich Dinge erledigt, und nicht nur darüber redet.

Hier ein kurzes Beispiel, um den Unterschied zu verdeutlichen:

Traditioneller KI-Chatbot:

Sie: "Hilf mir, meine Desktop-Dateien zu ordnen." KI: "Klar! Hier sind einige Tipps: 1. Erstellen Sie Ordner nach Dateityp... 2. Verschieben Sie die Dateien entsprechend..."

OpenClaw:

Sie: "Hilf mir, meine Desktop-Dateien zu ordnen." OpenClaw: benennt um, sortiert und verschiebt 47 Dateien in 5 Ordner — "Fertig! Ich habe alles nach Dateityp organisiert."

Das ist der entscheidende Unterschied: vom Chatbot zum Agent.

Dieser Leitfaden begleitet Sie durch die gesamte Reise — von der ersten Installation bis zum Schreiben eigener Skills und der Verwaltung mehrerer Agents. Ob Sie 30 Minuten oder einen ganzen Nachmittag Zeit haben, arbeiten Sie jeden Abschnitt in Ihrem eigenen Tempo durch.

Erste Schritte: Installation & Einrichtung

Voraussetzungen

• Node.js 22+ (LTS empfohlen) — prüfen Sie mit node --version
• Ein AI Model API Key — Anthropic Claude (empfohlen), OpenAI oder ein lokales Modell über Ollama
• macOS, Linux oder Windows mit WSL2

OpenClaw installieren

Der schnellste Weg ist der Einzeilen-Installer:

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

Dieser erkennt Ihr System, installiert bei Bedarf Abhängigkeiten und startet den Einrichtungsassistenten. Falls Sie npm bevorzugen:

npm install -g openclaw@latest

Für Docker-Nutzer:

docker pull openclaw/openclaw:latest
docker run -d --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

Eine detaillierte Anleitung zu jeder Methode finden Sie in unserem Quickstart-Leitfaden.

Den Onboarding-Assistenten ausführen

Nach der Installation führt Sie der Assistent durch alle Schritte:

openclaw onboard

Sie konfigurieren drei Dinge:

1. AI-Anbieter & API Key — Anthropic Claude funktioniert am besten. Falls Sie noch keinen Key haben, erstellen Sie einen unter anthropic.com. Kostenbewusst? Lesen Sie unseren Leitfaden zur Modellauswahl und Kosten.
2. Messaging-Kanal — Wählen Sie mindestens einen: Telegram ist am einfachsten zum Starten (5-Minuten-Setup). Wir haben dedizierte Anleitungen für Telegram, WhatsApp und Discord.
3. Sicherheitsmodus — Wählen Sie vorerst Sandbox. Sie können später auf vollen Zugriff upgraden, sobald Sie sich sicher fühlen.

Überprüfen, ob alles funktioniert

openclaw status

Sie sollten Folgendes sehen:

Gateway: Running ✓
Model: Connected ✓
Channels: 1 active

Öffnen Sie jetzt Ihre gewählte Messaging-App und senden Sie Ihre erste Nachricht. Probieren Sie etwas Einfaches:

• "Was kannst du alles?"
• "Wie spät ist es?"
• "Fasse die neuesten Tech-Nachrichten zusammen."

Wenn Ihr Bot antwortet, herzlichen Glückwunsch — Sie haben einen funktionierenden KI-Agent.

Grundkonzepte: Wie OpenClaw funktioniert

Bevor wir tiefer eintauchen, ist es hilfreich, die vier Grundbausteine von OpenClaw zu verstehen. Stellen Sie sie sich so vor:

Gateway — Die Eingangstür

Das Gateway ist die Verbindung von OpenClaw zur Außenwelt. Es verarbeitet Nachrichten von Telegram, Discord, WhatsApp, einer Web-API oder sogar der Kommandozeile. Sie können mehrere Gateways gleichzeitig betreiben — zum Beispiel Telegram für den privaten Gebrauch und Slack für die Arbeit.

Skills — Der Werkzeugkasten

Skills sind das, was OpenClaw tun kann. Jeder Skill ist eine gebündelte Fähigkeit: E-Mails senden, im Web suchen, Dateien verwalten, Ihren Browser steuern. Stellen Sie sich diese wie Apps auf einem Smartphone vor. OpenClaw wird mit einigen integrierten Skills ausgeliefert, aber die wahre Stärke liegt im Community-Ökosystem auf Clawhub und in Ihren eigenen Skills.

Durchsuchen Sie unser Skills-Verzeichnis, um zu sehen, was verfügbar ist.

Memory — Das Gedächtnis

OpenClaw merkt sich Dinge über Konversationen hinweg. Teilen Sie ihm Ihren Namen, Ihren Arbeitsplan und Ihre Vorlieben mit — und es behält diesen Kontext bei. Im Gegensatz zu zustandslosen Chatbots baut OpenClaw ein dauerhaftes Verständnis davon auf, wer Sie sind und wie Sie arbeiten, lokal gespeichert in ~/.openclaw/memory/.

Sandbox — Das Sicherheitsnetz

Die Sandbox kontrolliert, was OpenClaw auf Ihrem System tun darf. Im Sandbox-Modus kann es nicht auf beliebige Dateien zugreifen oder destruktive Befehle ausführen. Dies ist Ihre Sicherheitsebene — besonders wichtig beim Experimentieren mit neuen Skills oder wenn Sie OpenClaw erweiterte Berechtigungen geben.

Für eine detaillierte Sicherheitskonfiguration lesen Sie unsere Vorlage für sichere Konfiguration.

Skills installieren und verwenden

Skills sind der Punkt, an dem OpenClaw von einer "interessanten Demo" zum "täglichen Werkzeug" wird. So starten Sie.

Durchsuchen & Installieren

# Skills nach Stichwort suchen
openclaw skills search email

# Details zu einem bestimmten Skill anzeigen
openclaw skills info @openclaw/email-manager

# Installieren
openclaw skills install @openclaw/email-manager

Fünf Skills, die Sie zuerst installieren sollten

| Skill | Funktion | Installationsbefehl | |-------|----------|---------------------| | Email Manager | E-Mails lesen, verfassen und senden | openclaw skills install @openclaw/email-manager | | Calendar | Termine erstellen, Zeitplan prüfen, Einladungen senden | openclaw skills install @openclaw/calendar | | File Organizer | Dateien sortieren, umbenennen und aufräumen | openclaw skills install @openclaw/file-organizer | | Web Search | Im Web suchen und Ergebnisse zusammenfassen | openclaw skills install @openclaw/tavily-search | | Browser Control | Browser-Aufgaben automatisieren | openclaw plugins install @openclaw/browser-control |

Nach der Installation sprechen Sie einfach natürlich mit Ihrem Agent:

• "Prüfe meine ungelesenen E-Mails und fasse die 3 wichtigsten zusammen."
• "Was steht morgen in meinem Kalender?"
• "Suche nach den neuesten OpenClaw Release Notes."

Ihre Skills verwalten

# Alle installierten Skills auflisten
openclaw skills list

# Alle Skills aktualisieren
openclaw skills update

# Einen nicht mehr benötigten Skill entfernen
openclaw skills remove @openclaw/file-organizer

Bevor Sie Skills von Drittanbietern installieren, lesen Sie unsere Skills-Sicherheits-Checkliste, um sicher zu bleiben.

Automatisierungen einrichten (Cron Jobs)

Eine der praktischsten Funktionen von OpenClaw sind geplante Automatisierungen. Anstatt Ihren Agent jeden Morgen um etwas zu bitten, können Sie es einmal einrichten und laufen lassen.

Ein tägliches Briefing erstellen

Sagen Sie Ihrem Agent einfach in natürlicher Sprache:

"Jeden Morgen um 8 Uhr, sende mir ein Briefing mit dem heutigen Wetter, meinen Kalendereinträgen und der Anzahl ungelesener E-Mails."

OpenClaw erstellt automatisch einen Cron Job. Sie können diese auch manuell verwalten:

# Alle geplanten Aufgaben auflisten
openclaw cron list

# Details einer bestimmten Aufgabe anzeigen
openclaw cron show <task-id>

# Eine Aufgabe pausieren
openclaw cron disable <task-id>

# Wieder aktivieren
openclaw cron enable <task-id>

# Dauerhaft löschen
openclaw cron delete <task-id>

Automatisierungsideen

• Tägliches Briefing — Wetter + Kalender + ungelesene E-Mails jeden Morgen
• Wochenzusammenfassung — Freitagnachmittag-Bericht über Ihre Wochenaktivitäten
• Preistracker — Eine Produktseite überwachen und benachrichtigen, wenn der Preis sinkt
• Feierabend-Erinnerung — Ein freundlicher Hinweis um 18 Uhr, die Arbeit abzuschließen
• Postfach aufräumen — Jeden Abend E-Mails mit niedriger Priorität automatisch archivieren

Persistenten Speicher konfigurieren

Das Memory-System von OpenClaw ist das, was es persönlich macht. Je mehr Kontext Sie ihm geben, desto besser kann es Ihnen helfen.

Bringen Sie Ihrem Agent etwas über sich bei

Senden Sie eine Nachricht wie diese:

"Merke dir Folgendes über mich: Mein Name ist Alex. Ich bin Produktmanager. Ich arbeite Montag bis Freitag, 9 bis 18 Uhr, Zeitzone GMT+8. Ich bevorzuge knappe Antworten. Ich kommuniziere auf Englisch, kann aber auch Chinesisch lesen."

OpenClaw speichert dies im Langzeitgedächtnis und wendet es auf jede zukünftige Interaktion an.

Speicher anzeigen und bearbeiten

# Sehen, was sich Ihr Agent gemerkt hat
cat ~/.openclaw/memory/long-term.json

# Oder direkt im Chat fragen
"Was weißt du über mich?"

Sie können Erinnerungen auch korrigieren oder entfernen:

"Vergiss meinen alten Arbeitsplan. Ich arbeite jetzt von 10 bis 19 Uhr."

Wie der Speicher funktioniert

OpenClaw verwendet drei Speicherebenen:

• Kurzzeit — Aktueller Konversationskontext (wird nach jeder Sitzung gelöscht)
• Langzeit — Dauerhafte Fakten über Sie (Vorlieben, Gewohnheiten, biografische Informationen)
• Episodisch — Protokolle vergangener Interaktionen (werden für Mustererkennung im Zeitverlauf genutzt)

Dieser mehrschichtige Ansatz bedeutet, dass Ihr Agent umso nützlicher wird, je länger Sie ihn nutzen — ohne ständige Erinnerungen.

Ihren ersten eigenen Skill schreiben

Wenn die integrierten und Community-Skills Ihren speziellen Bedarf nicht abdecken, können Sie Ihren eigenen schreiben. OpenClaw Skills verwenden ein einfaches YAML-Format.

Skill-Struktur

Erstellen Sie eine neue Datei unter ~/.openclaw/skills/daily-news.yaml:

name: "Daily Tech News"
description: "Fetches and summarizes today's top tech headlines"
version: "1.0.0"

triggers:
  - "tech news"
  - "today's news"
  - "news summary"

steps:
  - action: web_search
    query: "top tech news today"
    max_results: 5

  - action: summarize
    content: "{{search_results}}"
    style: "bullet_points"

  - action: respond
    message: |
      Here's your tech news summary:

      {{summary}}

Testen

# Skills neu laden, um die neue Datei zu erkennen
openclaw skills reload

# Testen
openclaw skills test "Daily Tech News"

Probieren Sie es dann in einer Konversation aus: "Gib mir die heutigen Tech-News."

Komplexere Skills erstellen

Skills können mehrere Aktionen verketten:

• web_search — Im Web suchen
• summarize — Text in Stichpunkte oder Absätze zusammenfassen
• respond — Eine formatierte Antwort senden
• file_read / file_write — Dateien lesen oder erstellen
• shell_exec — Shell-Befehle ausführen (erfordert entsprechende Berechtigungen)
• http_request — Externe APIs aufrufen

Sie können diese kombinieren, um Workflows zu erstellen wie: Flugpreise suchen, Ergebnisse vergleichen, eine Zusammenfassung in eine Datei schreiben und Sie über Telegram benachrichtigen.

Multi-Agent-Verwaltung

Wenn Ihre Nutzung wächst, möchten Sie möglicherweise separate Agents für verschiedene Lebensbereiche — einen für die Arbeit, einen für persönliche Aufgaben, einen für Experimente.

Agents erstellen

# Einen Arbeits-Agent mit Claude Sonnet erstellen
openclaw create-agent work
openclaw config --agent work set ai.model "claude-sonnet-4-6"

# Einen persönlichen Agent erstellen
openclaw create-agent personal
openclaw config --agent personal set ai.model "claude-haiku-4-5"

# Alle Agents auflisten
openclaw list-agents

# Zwischen ihnen wechseln
openclaw switch-agent work

Warum mehrere Agents verwenden?

| Agent | Modell | Verbunden mit | Zweck | |-------|--------|---------------|-------| | Work | Claude Sonnet | Slack, Gmail, Linear | Berufliche Aufgaben, E-Mail-Triage | | Personal | Claude Haiku | Telegram, Google Calendar | Terminplanung, Erinnerungen, persönliche Erledigungen | | Lab | Ollama (lokal) | Nur CLI | Neue Skills testen, Experimente |

Jeder Agent hat seinen eigenen Speicher, eigene Skills und eigene Kanalverbindungen — vollständig voneinander isoliert.

Browser-Automatisierung

OpenClaw kann einen Browser steuern, um Aufgaben auszuführen, die über einfache API-Aufrufe hinausgehen: Formulare ausfüllen, Daten von Webseiten extrahieren, Preise über verschiedene Seiten vergleichen oder Screenshots erstellen.

Browser Control aktivieren

# Das Browser-Plugin installieren
openclaw plugins install @openclaw/browser-control

# Aktivieren
openclaw config set browser.enabled true

# Das Browserfenster anzeigen (auf true setzen zum Debuggen)
openclaw config set browser.headless false

Anwendungsfälle

• "Öffne GitHub und finde die am meisten trendenden Repositories von heute."
• "Gehe zu Amazon, suche nach mechanischen Tastaturen und liste die Top 3 nach Bewertung mit Preisen auf."
• "Fülle das Kontaktformular auf example.com mit meinen Informationen aus."
• "Mache einen Screenshot meiner Portfolio-Website."

Browser-Automatisierung ist leistungsstark, aber ressourcenintensiv. Verwenden Sie sie für Aufgaben, die tatsächlich visuelle Interaktion mit Webseiten erfordern — für einfache Datenabfragen ist ein Web Search Skill schneller und günstiger.

Integrationen über den Chat hinaus

OpenClaw verbindet sich mit mehr als nur Messaging-Apps. Hier sind einige beliebte Integrationen:

Google Workspace

openclaw config set integrations.google.enabled true
openclaw config set integrations.google.credentialsPath "/path/to/credentials.json"
openclaw integrations google authorize

Einmal verbunden, können Sie Gmail, Google Calendar und Google Drive durch natürliche Sprache verwalten.

Projektmanagement (Linear, Jira)

openclaw skills install @openclaw/linear
openclaw config set integrations.linear.apiKey "YOUR_API_KEY"

"Erstelle eine Aufgabe mit hoher Priorität in Linear: Behebe den Login-Seiten-Redirect-Bug."

Notizverwaltung (Obsidian, Notion)

openclaw skills install @openclaw/obsidian
openclaw config set integrations.obsidian.vaultPath "/path/to/vault"

"Erstelle eine neue Notiz in Obsidian mit dem Titel 'Meeting-Notizen — 2. März' mit den heutigen Diskussionspunkten."

Eine vollständige Liste der unterstützten Plattformen finden Sie in unserem Kanal-Integrationsverzeichnis.

Sicherheit & Kostenkontrolle

Docker Sandbox

Für maximale Isolation führen Sie OpenClaw in einer Docker Sandbox aus:

openclaw config set sandbox.mode "docker"
openclaw config set sandbox.docker.image "openclaw/sandbox:latest"
openclaw sandbox test

Dies beschränkt den Dateisystemzugriff, Netzwerkzugriff und die Shell-Ausführung auf vordefinierte Grenzen.

Ein Sicherheits-Audit durchführen

openclaw security audit --deep

Dies prüft auf falsch konfigurierte Berechtigungen, offengelegte Tokens und andere häufige Probleme.

Für einen vollständigen Leitfaden zur Sicherheitshärtung lesen Sie Port-Exposition & Fernzugriff.

Ihre Ausgaben kontrollieren

API-Kosten können sich summieren. So setzen Sie Schutzmaßnahmen:

# Ein tägliches Anfragelimit setzen
openclaw config set ai.dailyLimit 1000

# Ein monatliches Budgetlimit setzen (in USD)
openclaw config set ai.monthlyBudget 50

# Ihre Nutzung überprüfen
openclaw stats usage
openclaw stats cost

Typische monatliche Kosten:

| Nutzungsstufe | Beschreibung | Geschätzte Kosten | |---------------|-------------|-------------------| | Leicht | 10-20 Konversationen/Tag | 5-10 $/Monat | | Mittel | 50-100 Konversationen + Cron Jobs | 20-30 $/Monat | | Intensiv | Automatisierungen + Browser Control | 50-100 $/Monat |

Möchten Sie tiefer in die Kostenoptimierung einsteigen? Lesen Sie unseren Leitfaden zur Modellauswahl und Kosten.

Fehlerbehebung — Kurzreferenz

| Symptom | Wahrscheinliche Ursache | Lösung | |---------|------------------------|--------| | EADDRINUSE beim Start | Port 18789 bereits belegt | openclaw gateway start --port 18790 | | 401 Unauthorized | Ungültiger oder abgelaufener API Key | openclaw config set api-key | | Bot antwortet nicht | Kanal nicht verbunden | Prüfen Sie openclaw status und die Kanalkonfiguration | | Langsame Antworten | Modell überlastet oder Netzwerkprobleme | Versuchen Sie ein leichteres Modell oder prüfen Sie die Verbindung | | Skills laden nicht | Neustart nach Installation nötig | openclaw skills reload |

Für eine ausführlichere Fehlerbehebung lesen Sie unseren Leitfaden zu häufigen Fehlern.

Nützliche Diagnosebefehle

# Vollständiger Gesundheitscheck
openclaw doctor

# Logs anzeigen
openclaw logs

# Debug-Modus
openclaw config set logging.level "debug"

Wie geht es weiter?

Sie haben viel Stoff durchgearbeitet. Hier sind Ihre nächsten Schritte je nach Interesse:

• Mehr Kanäle gewünscht? Entdecken Sie unsere 50+ Kanal-Integrationsanleitungen — von Slack und Teams bis WeChat und Line.
• Interessiert an Sicherheit? Lesen Sie die Skills-Sicherheits-Checkliste und den Leitfaden zur sicheren Konfiguration.
• Self-Hosting gewünscht? Lesen Sie unseren Leitfaden zu Fernzugriff und Port-Exposition.
• Bereit, beizutragen? Das OpenClaw GitHub Repository freut sich über Pull Requests, Skill-Beiträge und Fehlermeldungen.

OpenClaw steht für einen echten Wandel in der Art, wie wir mit KI interagieren — vom Ratsuchen zum Delegieren realer Aufgaben. Das Projekt entwickelt sich rasant, die Community wächst, und der beste Zeitpunkt, Ihr eigenes KI-Agent-Setup aufzubauen, ist jetzt.