OpenClaw einrichten: Dein kompletter Setup-Guide für KI-Agenten
Du willst OpenClaw einrichten und deinen ersten KI-Agenten starten? Diese Anleitung führt dich Schritt für Schritt durch die Installation, Konfiguration und den ersten laufenden Agenten – inklusive Video-Tutorials und Troubleshooting.
Was ist OpenClaw?
OpenClaw ist ein Open-Source-Framework zur Orchestrierung von KI-Agenten [4]. Statt mit einem einzelnen KI-Modell zu chatten, baust du dir damit ein ganzes digitales Team: Agenten, die eigenständig Aufgaben übernehmen, Werkzeuge nutzen und miteinander kommunizieren.
Das besondere: OpenClaw läuft lokal auf deiner Hardware – deine Daten bleiben bei dir. Du verbindest es mit API-Schlüsseln von Anthropic (Claude), OpenAI oder anderen Anbietern und steuerst alles über eine einfache Konfiguration.
Für Freelancer, Agenturen und Solo-Unternehmer ist OpenClaw ein Game-Changer: Du automatisierst SEO-Analysen, Content-Erstellung, E-Mail-Workflows und vieles mehr – ohne teure SaaS-Tools. Mehr zu konkreten Anwendungsfällen findest du im Artikel KI-Agenten für Freelancer.
Im Vergleich zu klassischen Automatisierungstools wie n8n oder Make arbeitet OpenClaw nicht regelbasiert, sondern intelligent und kontextbewusst. Eine detaillierte Gegenüberstellung findest du in unserem OpenClaw vs. n8n Vergleich.
Wie funktioniert OpenClaw?
OpenClaw basiert auf einem einfachen Prinzip: Du definierst Agenten mit Persönlichkeit, Gedächtnis und Werkzeugen — und die KI erledigt den Rest. Das System besteht aus vier Kernkomponenten:
🧠 SOUL.md
Definiert die Persönlichkeit, Rolle und Regeln deines Agenten. Wie eine Stellenbeschreibung für deine KI.
📝 MEMORY.md
Das Langzeitgedächtnis. Der Agent merkt sich Fakten, Entscheidungen und Kontext zwischen den Sessions.
💓 Heartbeats
Zeitgesteuerte Impulse, die den Agenten proaktiv arbeiten lassen — auch wenn du nicht am Rechner bist.
🔧 Tools & Webhooks
Externe Werkzeuge die dein Agent nutzen kann: APIs aufrufen, E-Mails senden, Dateien schreiben.
Mehr dazu in unserem ausführlichen Konfigurations-Guide und dem Artikel über proaktive Heartbeats.
Voraussetzungen vor der Installation
Für die OpenClaw-Installation benötigst du vier Dinge: Node.js (v18+), einen API-Key von Anthropic oder OpenAI, ein Terminal und optional Telegram für die mobile Steuerung. Alles ist kostenlos und in wenigen Minuten installiert.
Betriebssystem
Windows 10/11, macOS 12+ oder Linux (Ubuntu/Debian empfohlen). OpenClaw läuft auf allen gängigen Systemen — auch auf einem Raspberry Pi.
Node.js (v18+)
Node.js ist die Laufzeitumgebung für OpenClaw. Lade die LTS-Version von nodejs.org herunter und installiere sie [1].
API-Schlüssel
Du benötigst mindestens einen API-Key, z.B. von Anthropic (Claude) [2] oder OpenAI. Kostenlose Testguthaben sind bei beiden Anbietern verfügbar.
Telegram (optional)
Für die Steuerung über Telegram benötigst du einen Bot-Token [3]. Damit kannst du deinen Agenten per Smartphone erreichen — auch unterwegs.
OpenClaw einrichten: Schritt-für-Schritt
Diese OpenClaw Anleitung zeigt dir jeden Schritt — vom Download bis zum ersten laufenden Agenten. Du brauchst keine Programmierkenntnisse, nur ein Terminal und 15 Minuten Zeit.
OpenClaw installieren
Öffne dein Terminal (Windows: PowerShell oder CMD, Mac/Linux: Terminal) und führe folgenden Befehl aus:
npm install -g openclaw
Das installiert OpenClaw global auf deinem System. Der Vorgang dauert ca. 1–2 Minuten. Falls du Node.js noch nicht hast, installiere es zuerst von nodejs.org.
Ersten Start & Konfiguration
Starte OpenClaw nach der Installation mit:
openclaw start
Beim ersten Start führt dich ein Setup-Assistent durch die Grundkonfiguration – API-Keys, Workspace-Verzeichnis und Kanal (Telegram/Discord/CLI). OpenClaw legt automatisch einen Workspace-Ordner mit allen Konfigurationsdateien an.
API-Key hinterlegen
Trage deinen Anthropic- oder OpenAI-API-Key in die Konfiguration ein:
openclaw config set anthropic_api_key sk-ant-...
Du kannst mehrere Keys für verschiedene Modelle hinterlegen und pro Session wählen, welches Modell du nutzt. Wir empfehlen Claude Sonnet für den Einstieg — bestes Preis-Leistungs-Verhältnis.
Kanal verbinden (Telegram)
Um deinen Agenten per Telegram zu steuern, erstellst du einen Bot über @BotFather und trägst den Token in OpenClaw ein:
openclaw channel add telegram
Der Agent antwortet ab jetzt auf deine Nachrichten im Telegram-Chat – wie ein persönlicher Assistent, den du jederzeit erreichen kannst.
Workspace & SOUL.md anpassen
OpenClaw legt einen Workspace-Ordner an, in dem alle Konfigurationsdateien liegen. Die wichtigste ist SOUL.md – sie definiert die Persönlichkeit deines Agenten.
Passe SOUL.md, USER.md und MEMORY.md nach deinen Bedürfnissen an. Je präziser die Beschreibung, desto besser arbeitet dein Agent. Details dazu im nächsten Abschnitt.
OpenClaw konfigurieren: SOUL.md, MEMORY.md & Heartbeats
OpenClaw wird über drei Textdateien konfiguriert: SOUL.md definiert die Persönlichkeit, MEMORY.md speichert das Langzeitgedächtnis und Heartbeats steuern proaktive Aktionen. Mit diesen drei Dateien verwandelst du ein generisches KI-Modell in einen spezialisierten Assistenten:
SOUL.md — Die Persönlichkeit
In der SOUL.md definierst du, wer dein Agent ist und wie er arbeiten soll. Beispiel für einen SEO-Assistenten: Rolle, Tonalität, Regeln, bevorzugte Tools. Je detaillierter, desto konsistenter die Ergebnisse.
MEMORY.md — Das Langzeitgedächtnis
Der Agent speichert wichtige Erkenntnisse und Entscheidungen in der MEMORY.md. So behält er den Kontext über mehrere Sessions hinweg — ein fundamentaler Unterschied zu ChatGPT, das mit jeder neuen Sitzung alles vergisst. Mehr dazu im Memory-System Artikel.
Heartbeats — Proaktives Arbeiten
Mit Heartbeats kannst du deinen Agenten zu bestimmten Zeitpunkten automatisch aktiv werden lassen. Statt auf deine Anweisung zu warten, prüft er selbstständig SEO-Rankings, überwacht Systeme oder schreibt Reports. Wie du Heartbeats einrichtest, erfährst du im Guide OpenClaw Heartbeats.
Einen vollständigen Konfigurations-Guide mit Beispielen für jede Datei findest du in OpenClaw konfigurieren: SOUL.md, MEMORY.md und Heartbeats.
Dein erster automatisierter Workflow
Ein typischer erster OpenClaw-Workflow ist ein SEO-Monitoring-Agent: Er prüft täglich automatisch deine Website-Rankings über die Google Search Console API und sendet dir die Ergebnisse per Telegram. So richtest du ihn ein:
Beispiel-Workflow: SEO-Monitoring
- Agent wird morgens um 8:00 Uhr per Heartbeat geweckt
- Prüft Google Search Console Daten über die API
- Vergleicht Rankings mit dem Vortag
- Sendet dir eine Zusammenfassung per Telegram
- Bei Anomalien (Ranking-Einbruch) sendet er einen Alert
Weitere Praxisbeispiele — von Lead-Alerts bis Content-Pipeline — findest du in 5 KI-Workflow Praxisbeispiele. Und wenn du OpenClaw mit externen Events verbinden willst (z.B. Stripe-Zahlungen), schau dir die Webhook-Anleitung an.
Was kostet OpenClaw?
OpenClaw selbst ist Open Source und komplett kostenlos. Die Kosten entstehen durch die API-Nutzung der KI-Modelle — und die können je nach Modell und Nutzungsintensität erheblich variieren:
| Nutzungsprofil | Beschreibung | Kosten/Monat |
|---|---|---|
| Einstieg | 1 Agent, einfache Tasks, kleines Modell (Haiku/GPT-4o-mini) | 5-15 EUR |
| Regelmäßig | 2-3 Agenten, tägliche Automatisierungen (Sonnet/GPT-4o) | 30-80 EUR |
| Intensiv | Multi-Agenten-System, Sub-Agents, Content-Produktion | 100-300 EUR |
| Power-User | Viele Spawns, große Kontexte, Opus-Modell, ganztägiger Betrieb | 300+ EUR |
Wichtig: Die Kosten hängen stark vom gewählten KI-Modell ab. Claude Opus oder GPT-4 sind deutlich teurer als Haiku oder GPT-4o-mini. Auch die Anzahl der Sub-Agent-Spawns und die Kontextgröße treiben die Kosten. Setze unbedingt ein Budget-Limit in der Konfiguration und starte mit einem günstigen Modell.
Im Vergleich zu menschlichen Assistenten oder Agenturen sind selbst die höheren Stufen günstig — aber unterschätze die API-Kosten nicht, besonders bei intensiver Nutzung. Ein Kosten-Dashboard hilft dir, den Überblick zu behalten. Einen Tool-Vergleich findest du in Make vs. Zapier vs. n8n vs. OpenClaw.
OpenClaw Video-Tutorials: Schritt für Schritt erklärt
Diese Video-Reihe führt dich von der ersten Idee bis zur vollautomatisierten KI-Abteilung. Die Videos bauen aufeinander auf – ideal für Einsteiger und Fortgeschrittene.
Troubleshooting: Häufige Probleme beim Einrichten
Die meisten Probleme bei der OpenClaw-Einrichtung lassen sich in wenigen Minuten lösen. Hier die häufigsten Stolpersteine:
Sicherheitshinweise für die OpenClaw-Nutzung
Beim Einsatz von OpenClaw gelten fünf Sicherheitsregeln: API-Keys geheim halten, Workspace-Ordner schützen, externe Aktionen bewusst freigeben, Sub-Agenten regelmäßig prüfen und nur auf eigenen Geräten installieren. Im Detail:
- API-Keys geheim halten: Teile deine Keys niemals öffentlich oder in Chat-Nachrichten.
- Workspace-Ordner schützen: Sensible Dateien (MEMORY.md, API-Keys) vor unbefugtem Zugriff sichern.
- Externe Aktionen bewusst freigeben: Bestätige kritische Aktionen (E-Mails, API-Calls) immer bewusst.
- Sub-Agenten mit Bedacht einsetzen: Überprüfe regelmäßig automatisierte Tasks.
- Nicht auf öffentlichen Rechnern: Nur auf Geräten installieren, die du kontrollierst.
Zum Thema Datenschutz: OpenClaw speichert keine Daten in der Cloud. Wenn du in Deutschland arbeitest, lies auch unseren Artikel KI-Assistent & DSGVO.
Häufige Fragen zur OpenClaw-Einrichtung
Quellen
[1] Node.js Downloads — nodejs.org/de/download
[2] Anthropic API Documentation — docs.anthropic.com/claude/reference
[3] Telegram Bot API — core.telegram.org/bots
[4] OpenClaw GitHub Repository — github.com/openclaw/openclaw
Bereit, deinen ersten KI-Agenten zu starten?
Lade unseren kostenlosen Starter-Guide herunter — 11 Seiten von der Installation bis zum ersten automatisierten Workflow.