ZeroClaw Entwickler-Guide
ZeroClaw ist eine local-first KI-Agent-Runtime, geschrieben in Rust. Du startest eine einzige Binary, verbindest sie mit den gewünschten Modell-Providern und Channels und behältst den Agent, seine Tools und seine Daten auf einer Infrastruktur, die du kontrollierst. Dieser Guide ist der praktische Einstiegspunkt für Entwickelnde: was ZeroClaw ist, wie die Runtime aufgebaut ist, wie Setup und Konfiguration funktionieren und wo du es erweitern kannst, wenn du upstream beitragen willst.
Dieser Guide basiert auf der offiziellen ZeroClaw-Dokumentation unter docs.zeroclawlabs.ai/v0.8.1/en/ und dem offiziellen zeroclaw-labs/zeroclaw-Repository, geprüft am 26. Juni 2026. Der öffentliche master-Branch kann v0.8.1 voraus sein, daher sollten Implementierungsdetails immer gegen den Tag oder Branch geprüft werden, mit dem du tatsächlich arbeitest.
In diesem Abschnitt
1. Was ZeroClaw ist
Die kürzeste zutreffende Beschreibung lautet:
ZeroClaw ist eine Single-Binary-Agent-Runtime, die LLM-Provider, Channels, Tools, Memory und eine Sicherheitsrichtlinie zu einem lokalen System verbindet.
Diese Kombination ist entscheidend:
- Es ist nicht nur ein CLI-Chat-Tool.
- Es ist nicht an einen Modellanbieter gebunden.
- Es ist nicht nur für Coding gedacht.
- Es ist keine gehostete SaaS-Steuerungsebene.
Stattdessen ist ZeroClaw um vier explizite Projekt-Grundhaltungen herum aufgebaut:
- Du besitzt es
- Security-first, mit Escape-Hatches
- Minimal
- Provider-agnostisch
Diese Prioritäten erklären die meisten Designentscheidungen, die du an anderer Stelle im Projekt siehst.
2. Das mentale Modell
Stell dir ZeroClaw als fünf kooperierende Schichten vor:
| Schicht | Was sie macht |
|---|---|
| Provider | Sprechen mit Anthropic, OpenAI, Ollama und anderen Modell-Backends |
| Channels | Stellen den Agent über Discord, Telegram, E-Mail, Webhooks, CLI, ACP und mehr bereit |
| Runtime | Betreibt die Agent-Schleife, Tool-Calling, Freigaben, Scheduling und Koordination |
| Tools & Memory | Lassen den Agent auf die Welt einwirken und sich nützlichen Kontext merken |
| Security & Config | Legen fest, was der Agent darf und wie alles verdrahtet ist |
Deshalb wirkt das Projekt breiter als Tools wie Claude Code oder Codex CLI. Das sind in erster Linie interaktive Coding-Agents. ZeroClaw ist eher eine Agent-Plattform-Runtime, die aus demselben Kern Coding-Workflows, persönliche Assistenten, Chatbots, Automatisierungen und hardwarebewusste Agents antreiben kann.
3. Warum Entwickelnde sich dafür entscheiden würden
ZeroClaw ergibt am meisten Sinn, wenn du eine oder mehrere dieser Eigenschaften willst:
- Lokale Kontrolle über Agent-Status, Credentials und Ausführung.
- Multi-Channel-Präsenz, ohne separate Bots für jede Plattform zu betreiben.
- Provider-Flexibilität, statt sich auf einen API-Anbieter festzulegen.
- Ein starkes Sicherheitsmodell mit Freigaben, Sandboxing und Receipts.
- Erweiterbarkeit in Rust für Channels, Provider, Tools und verwandte Runtime-Oberflächen.
- Ein Weg vom persönlichen Setup zum produktionsähnlichen Service-Modus.
Wenn dein einziges Ziel "im Terminal mit einem Modell chatten" ist, ist ZeroClaw meist mehr Plattform, als du brauchst. Wenn dein Ziel "ein echtes Agent-System betreiben, das ich besitzen und erweitern kann" ist, wird es deutlich überzeugender.
4. Was die Dokumentation ungewöhnlich macht
Die offizielle Dokumentation unterscheidet zwischen:
- handgeschriebenen Guides für Konzepte, Setup, Architektur und Betrieb
- generierten Referenzdokumenten für CLI und Konfiguration
Das ist ein wichtiges Detail für Beitragende. Wenn du ein CLI-Flag oder einen Config-Schlüssel nachschlägst, sind die generierten Referenzseiten die maßgebliche Quelle. Wenn du Designabsicht oder Workflows verstehen willst, zählen die Prosa-Guides mehr.
5. Empfohlene Lesereihenfolge
Nutze diese Reihenfolge, wenn du neu im Projekt bist:
- Diese Seite für die übergeordnete Karte
- Setup und erster Start, um den Installationsablauf und die Runtime-Oberflächen zu verstehen
- Architektur und Runtime für den Workspace und den Request-Lifecycle
- Konfiguration und Sicherheit für das eigentliche Betriebsmodell
- Erweitern und Beitragen, bevor du Upstream-Code anfasst