OpenClaw in Stuttgart: ein Builder-Guide für deinen eigenen Agenten

Wir haben den Workshop OpenClaw Hands-On Stuttgart mit rund 50 Builderinnen und Buildern durchgezogen, einem gemeinsamen Ziel und einer einzigen Regel: Am Ende des Abends spricht dein Laptop mit einem Agenten, der in Markdown-Dateien lebt, die du selbst lesen kannst. Dieser Beitrag ist die Kurzfassung des Talks plus der Pfad, dem du auf eigene Faust folgen kannst. Alle Slides, Workflow-Starter und Deployment-Rezepte liegen im Repo openclaw-guides.

Was ist OpenClaw?

OpenClaw ist ein Open-Source-Agent-Gateway. Es leitet Nachrichten von beliebigen Channels (Web-UI, CLI, Telegram, Discord, Slack, WhatsApp) an einen KI-Agenten weiter und zurück, und persistiert Langzeitgedächtnis als einfache Markdown-Dateien auf der Festplatte. Local-first, MIT-lizenziert, mit dem Pi Coding Agent (badlogic/pi-mono) als eingebettetem Agent — der Assistent kann also Dateien lesen, schreiben, editieren und Shell-Befehle ausführen.

• Gateway — ein normalisierter Hub zwischen Mensch und Agent.
• Markdown-Memory — SOUL.md, USER.md, MEMORY.md, notes/. Du kannst das Gedächtnis deines Agenten mit cat, vim und git diff anschauen.
• Pi inside — Read, Write, Edit, Bash. Der Agent macht Dinge, statt nur zu chatten.

OpenClaw vs Claude Code, Cursor, Hermes und Pi

Diese Namen werden ständig verwechselt. Die Kurzfassung:

• Claude Code und Cursor sind Coding-Assistenten in deiner IDE oder im Terminal. Sie laufen nicht auf einem Cron und sind nicht über Telegram erreichbar.
• Pi (badlogic/pi-mono) ist ein Coding-Agent-Toolkit von Mario Zechner. OpenClaw bettet Pi als Agent-Runtime ein; Pi alleine ähnelt eher Claude Code als OpenClaw.
• Hermes von Nous Research ist der nächste Verwandte zu OpenClaw: ein Open-Source-Agent zum Selbst-Hosten mit persistentem Gedächtnis, Multi-Plattform-Gateway und über 40 eingebauten Skills. Python-basiert, sehr aktiv 2026.
• OpenClaw ist Gateway plus Markdown-Memory plus Pi, in TypeScript. Wenn du eine selbst gehostete Claude-Code-Alternative willst, die immer läuft und dich auf dem Handy erreicht, ist das die Form.

Was wir im Stuttgarter Hands-On gemacht haben

• Die fünf Konzepte: Gateway, Channels, Agents, Sessions, Memory.
• Drei Workflow-Tracks: ein News-Briefing-Agent (Einsteiger), ein Preis-Monitor (Fortgeschritten) und ein E-Mail-Monitor (Profi).
• Wo es läuft: Laptop, coral.inc oder ein VPS. Wir haben pro Tisch eine Variante gewählt.
• Live-Demo: Nachricht rein, Markdown-Datei geschrieben, Antwort raus.

Slides, Facilitator-Skript, drei Starter-Projekte und der komplette Troubleshooting-Guide liegen in sachin-aag/openclaw-guides. Einmal klonen und du hast alles aus dem Raum.

Dein erster Workflow in 10 Minuten

Das Hello-World ist kein Chatbot. Es ist ein News-Briefing-Agent, der RSS-Feeds einsammelt, ein strukturiertes Digest baut und es in eine Markdown-Datei schreibt, die du editieren kannst.

git clone https://github.com/sachin-aag/openclaw-guides.git
cd openclaw-guides/workflows/news-briefing-agent
npm install
cp .env.example .env   # füge deinen Model-API-Key ein
npm run briefing

Lege einen Model-API-Key dazu (Anthropic, OpenAI, Google oder Featherless), starte das Skript, und unter workspace/briefings/ erscheint eine neue Datei. Das ist der Output deines Agenten — in einer Datei, die dein Editor öffnen kann.

Ist OpenClaw eine Alternative zu Claude Code?

So halb. Claude Code ist ein Assistent in deinem Terminal. OpenClaw ist das Gateway um einen Assistenten herum — gleiche Tool-Primitiven (Read, Write, Edit, Bash) via Pi, aber erreichbar aus Chat-Apps, lauffähig auf einem Cron und mit einem Gedächtnis, das du grep-pen kannst. Wenn du Claude Code willst, das auf einem VPS lebt und dir per Telegram schreibt, ist das die OpenClaw-Form.

Wo es läuft: Laptop vs coral.inc vs VPS

Drei realistische Ziele. Die meisten starten lokal, beweisen den Workflow, der ihnen wichtig ist, und ziehen dann auf einen VPS, sobald Cron tatsächlich zählt.

Lokaler Laptop

Kostenlos, schnellste Iteration, perfekt zum Editieren der Memory-Dateien in deiner IDE. Großer Haken: Laptops gehen schlafen, also feuert Cron nur, wenn du wach bist. Behandle es als Dev-Umgebung, nicht als Deployment.

coral.inc

Managed Host, Setup in fünf Minuten. Etwa 50 USD Basis pro Monat; der Workshop-Code STUTTGART zieht 30 USD vom ersten Monat ab. Nimm das, wenn du Nicht-Technikerinnen und Nicht-Technikern eine Demo zeigen willst, ohne erst zu erklären, was ein VPS ist.

VPS (Hostinger oder GCP Compute Engine)

Rund 5–15 € pro Monat, 30–60 Minuten beim ersten Mal. Das ist die richtige Heimat für einen Always-on-Agenten: Cron feuert wirklich, dein Gedächtnis bleibt erhalten, und du kontrollierst die Firewall. Ausführliche Deploy-Guides für Hostinger und GCP liegen im Repo.

Markdown als Memory verändert, wie du mit Agenten baust

Die meisten Agent-Frameworks machen aus Memory eine Blackbox: einen Vektor-Index, einen versteckten Conversation-Log, einen managed Graph. Du kannst es nicht lesen. Du kannst es nicht greppen. Du kannst es nicht git diff-en.

OpenClaw geht den anderen Weg. Das Gedächtnis deines Agenten ist ein Ordner.

• SOUL.md — Persönlichkeit, Stimme, Arbeitsprinzipien. Aufmachen, einen Satz ändern, speichern. Der Agent denkt im nächsten Turn anders.
• USER.md — was der Agent über die Person(en) weiß, mit denen er spricht.
• MEMORY.md — Langzeitnotizen, die der Agent über die Zeit ergänzt. Entscheidungen, wiederkehrende Muster, alles mit #keep markiert.
• notes/ — Tageslogs und Scratchpads, alles Domänenspezifische.

Drei Dinge werden möglich, mit denen Vektor-DB-Agenten kämpfen: Du kannst das Gedächtnis im Meeting laut vorlesen (Audit), du kannst es ohne Retraining ändern (Edit), und du kannst es in git versionieren und zurückrollen, wenn der Agent eine seltsame Angewohnheit entwickelt.

Pi als Coding-Brain

OpenClaw erfindet die Agent-Loop nicht neu. Es bettet Pi (badlogic/pi-mono) direkt ein. Pi gibt dem Assistenten vier primitive Tools:

• Read(path) — Dateien öffnen, Ordner scannen.
• Write(path, content) — neue Dateien anlegen.
• Edit(path, patch) — chirurgische Patches für bestehende Dateien.
• Bash(cmd) — alles in einer Shell ausführen. Mächtig und gefährlich; behandle deine Tool-Policy wie eine Sicherheitsgrenze.

Deshalb kann ein OpenClaw-Agent in MEMORY.md schreiben, ein Python-Skript starten, git status prüfen oder eine E-Mail verfassen, ohne dass du Custom-Tools verdrahten musst. Funktional ist das ein Junior-Dev mit Shell-Zugriff und einem Markdown-Notizbuch.

Häufige Stolpersteine aus dem Workshop

• Cannot find module … — npm install im Workflow-Ordner ausführen, nicht im Repo-Root.
• Skript läuft, aber es wird nichts geschrieben — prüfe, ob das Output-Verzeichnis aus .env existiert und beschreibbar ist.
• 401 wird als 500 ausgegeben — die meisten Provider verschlucken Auth-Fehler. Prüfe, ob der Key zum OPENCLAW_PROVIDER passt.
• Cron feuert auf meinem Laptop nicht — Laptops gehen schlafen. Auf macOS hilft caffeinate -i, sonst auf einen VPS umziehen.

Die vollständige Liste liegt im howto-Ordner von openclaw-guides.

Wie es weitergeht

• Einen zweiten Channel anhängen — Telegram oder Discord verkabeln, damit du vom Handy aus mit dem Agenten reden kannst.
• Multi-Agent-Routing — ein Researcher und ein Writer reichen die Arbeit hin und her.
• Hybrides Model-Routing — günstiges Modell für Routing, teures für das eigentliche Denken.
• Einen Workflow als wiederverwendbaren Skill paketieren, sodass andere Agenten ihn aufrufen können.

Wenn du in Stuttgart bist, stehen die nächsten CREATORS-Sessions auf der Event-Seite, und weitere praktische Notizen landen im Blog.

FAQ

Was ist der Pi Coding Agent?

Pi ist ein Open-Source-Coding-Agent-Toolkit von Mario Zechner, ausgeliefert als TypeScript-Monorepo unter badlogic/pi-mono. Enthalten sind ein CLI-Coding-Agent, ein einheitliches Multi-Provider-LLM-API, eine Agent-Runtime mit Tool-Calling und ein Terminal-UI. OpenClaw nutzt Pi für die eigentliche Agent-Loop.

Was ist der Unterschied zwischen OpenClaw und Hermes?

Beide sind Open-Source-Agent-Runtimes zum Selbst-Hosten mit persistentem Gedächtnis und Multi-Plattform-Gateway. Hermes (von Nous Research, Februar 2026 veröffentlicht) ist Python, hat über 40 eingebaute Skills, unterstützt automatische Skill-Erstellung und mehrere Execution-Sandboxes (lokal, Docker, SSH, Modal, Singularity). OpenClaw ist TypeScript, bringt Pi als eingebetteten Coding-Agenten mit und speichert Memory als Klartext-Markdown, das du git diff-en kannst. OpenClaw nehmen für editierbares Memory und minimale bewegliche Teile; Hermes nehmen für einen reicheren Skill-Katalog und stärkere Sandboxing-Optionen out of the box.

Kann ich OpenClaw ohne VPS selbst hosten?

Ja — auf einem Laptop oder einem Raspberry-Pi-artigen Heimserver. Einen VPS brauchst du erst, wenn Always-on-Cron, echte Nutzer oder externe Webhooks zählen. Die Runtime selbst ist klein.

Welchen Open-Source-KI-Agenten sollte ich 2026 nehmen?

Wenn du Coding-Workflows auf eigenen Dateien bauen willst: Pi oder Claude Code. Wenn du einen selbst gehosteten Assistenten willst, der aus Chat-Apps erreichbar ist und ein Gedächtnis hat, das dir gehört: OpenClaw oder Hermes. Wenn du ein managed Framework in einer Next.js-App willst: das Vercel AI SDK plus Workflow DevKit. Sie lösen verschiedene Problemformen; zwei davon im selben Stack zu mischen ist normal.

Funktioniert OpenClaw mit Telegram, Discord, Slack und WhatsApp?

Ja. Channels sind pluggable. Der Workshop deckt das Web-UI standardmäßig ab und Telegram/Discord als einfachsten zweiten Channel. Slack und WhatsApp brauchen mehr Setup (Bot-Tokens, Webhook-Verifikation), folgen aber demselben Muster.

Wie unterscheidet sich Markdown-Memory von einer Vektor-Datenbank?

Eine Vektor-DB speichert Embeddings, die du semantisch suchen, aber nicht lesen kannst. Markdown-Memory sind einfach Dateien: Du liest sie in jedem Turn, du editierst sie von Hand, und du versionierst sie in git. Du gibst etwas Retrieval-Cleverness auf; du bekommst Auditierbarkeit, Edit-Fähigkeit und null Infrastruktur.

Ist OpenClaw produktionsreif?

Für den persönlichen Einsatz und kleine Teams: ja, viele Builder fahren es heute auf VPSes. Für Public-Produkte mit hohem Traffic: behandle es wie jedes Agent-System — Rate-Limiting, Observability, Secret-Rotation und eine Tool-Policy ohne unbeschränktes Bash.

Weiterführend

Stand: Mai 2026.

• Recap des ersten OpenClaw-Meetups in Stuttgart (März 2026)
• sachin-aag/openclaw-guides — Slides, Workflow-Starter, Deploy-Guides
• openclaw.cc — offizielle Seite
• docs.openclaw.ai — offizielle Docs
• badlogic/pi-mono — das Pi-Coding-Agent-Monorepo
• hermes-agent.org — Hermes von Nous Research
• OpenClaw Hands-On Stuttgart auf Luma