hello-claw: ein Lernpfad zu OpenClaw, von der Adoption bis zum eigenen Agenten
哈喽!龙虾 🙋♀️ Adopt from scratch and build your first claw 🦞 来领养你的第一只龙虾!
Auf einen Blick
- Was ist das?
- Das Repository datawhalechina/hello-claw ist kein Agent und keine Bibliothek, sondern eine dreiteilige Lehrsammlung rund um das CLI-System OpenClaw. Wer den Aufwand für Setup, Modellbetrieb und Nebenläufigkeit selbst tragen will, findet hier eine sortierte Route, aber keinen wartenden Betreuer.
- Für wen ist es gedacht?
- Wer OpenClaw auf eigener Hardware oder VM betreiben will, eine der drei Routen aus dem README wählt und die Lizenz CC BY-NC-SA 4.0 akzeptiert, bekommt hier eine sortierte Lernstrecke mit Anleitung zum manuellen Installationsweg. Wer einen fertigen Assistenten sucht, der nach dem Auspacken Aufgaben übernimmt, ist hier falsch; hello-claw liefert Text, Konfigurationsschritte und Beispiel-Skills, keinen laufenden Dienst.
- Darf ich es kommerziell nutzen?
- Nicht ohne Erlaubnis. GitHub findet in diesem Repository keine Lizenzdatei, und ohne Lizenz sind standardmäßig alle Rechte vorbehalten: Sie dürfen den Code lesen, aber nicht wiederverwenden. Prüfen Sie die README oder fragen Sie die Autoren, bevor Sie ihn nutzen.
- Wird es noch gepflegt?
- Ja. Die letzten Commits kamen vor 27 Tagen.
- In welcher Sprache ist es geschrieben?
- Hauptsächlich JavaScript, laut der Sprachstatistik von GitHub.
Die Antworten beruhen auf den GitHub-Daten des Projekts (zuletzt abgeglichen am 15. September 2026) und auf unserer Analyse. Sie sind keine Rechtsberatung.
TIEFGEHENDE OPEN-SOURCE-ANALYSE
Ein Tutorial-Repository, kein Agent zum Auspacken
Der Name führt in die Irre. hello-claw ist kein Agent, den man installiert, und keine Bibliothek, die man importiert. Es ist eine Sammlung von Lehrmaterial rund um OpenClaw, ein Kommandozeilen-System für KI-Assistenten. Die Selbstbeschreibung im README nennt das Ziel direkt: ein vollständiger Lernkurs, der von null an führt, egal ob man OpenClaw nur benutzen oder die Funktionsweise verstehen und eine eigene Variante bauen will. Die primäre Sprache im Repository ist JavaScript, die Lizenz ist CC BY-NC-SA 4.0, und die Online-Version liegt unter datawhalechina.github.io/hello-claw.
Wer eine fertige Anwendung sucht, wird enttäuscht. Wer verstehen will, wie ein Agent aus Prompt-System, Tool-Schicht und Nachrichtenschleife zusammengesetzt ist, bekommt hier eine Route durch genau diese Bausteine. Das ist der eigentliche Wert: nicht der Code, sondern die Reihenfolge, in der man die Teile kennenlernt.
Drei Leserollen, drei Routen durch dasselbe Material
Das README teilt die Sammlung in drei Module. Der erste Teil, im README als Adoptions-Teil bezeichnet, umfasst elf Kapitel plus sieben Anhänge und ist in Installationskapitel, Kernkonfiguration, Erweiterung und Betrieb sowie Sicherheit und Clients gegliedert. Der zweite Teil heißt im README Universität und sammelt Szenario-Beispiele rund um Skills und typische Arbeitsabläufe. Der dritte Teil behandelt den Bau eines eigenen Claws in elf Kapiteln, beginnend mit der Analyse des OpenClaw-Quellcodes und möglicher Alternativen.
Die Zielgruppen sind explizit getrennt. Wer keine Programmiererfahrung hat, soll mit dem Adoptionsteil beginnen und zuerst Installation und Basisautomatisierung zum Laufen bringen. Wer direkt Ergebnisse will, springt in die Universität und wählt dort fünf bis zehn Skills für ein Szenario. Entwickler gehen in den dritten Teil. Diese Aufteilung ist nützlich, weil sie verhindert, dass Anfänger in der Architekturanalyse hängen bleiben. Sie ist zugleich eine Schwäche: Die drei Teile setzen unterschiedlich viel voraus, und das README sagt nicht, wie viel Zeit jede Route kostet.
Was im Repository tatsächlich liegt
Die Universität ist nach Szenarien sortiert. Genannt werden unter anderem ein E-Mail-Assistent für 163, ein lokaler Gesundheitsassistent, Morgenbriefing, Kalenderverwaltung, Vibe Coding, ein CI/CD-Assistent, Dokumentationsautomatisierung, Recherche-Automatisierung, ein Content-Studio, CRM-Unterstützung, Meeting-Protokolle, Multi-Agent-Kollaboration mit mehreren OpenClaw-Instanzen, eine Wissensdatenbank, ein Ein-Personen-Unternehmen, eine Sicherheitscheckliste, ein Paper-Push-Assistent, Smart-Home-Steuerung, Finanzanalyse und ein Trainingsassistent. Alle Einträge verlinken auf Markdown-Dateien unter docs/cn/university/.
Der Adoptionsteil deckt Installation über AutoClaw oder manuell, den Konfigurationsassistenten, die Anbindung von Chat-Plattformen mit Feishu als durchgezogenem Beispiel, Modellverwaltung samt API-Key-Rotation und Failover, Agent-Verwaltung mit Workspaces und Bindungsregeln, Tools und Cron-Jobs, Gateway-Betrieb, Fernzugriff über SSH-Tunnel und Tailscale sowie Bedrohungsmodelle ab. Der Bauteil widmet sich Prompt-System, Tool-System, Nachrichtenschleife und Mehrkanal-Anbindung. Das ist eine breite Abdeckung für ein einzelnes Repository. Ob die Kapitel inhaltlich gleich tief sind, lässt sich aus der Verzeichnisstruktur allein nicht ableiten.
Installation und Konfiguration: was das Material vorgibt
Das README nennt für die manuelle Installation ausdrücklich Node.js, npm install und den onboard-Konfigurationsassistenten. Der zweite Teil des Adoptionsteils beschreibt diesen Weg, der erste Teil bietet mit AutoClaw einen Desktop-Client als Abkürzung. Für die Modellseite nennt das Material CLI-Verwaltung, mehrere Provider und API-Key-Rotation mit Failover. Für Chat-Anbindungen wird Feishu als vollständiges Beispiel durchgespielt, Pairing und Gruppenchats inklusive.
Für den Betrieb sind Gateway-Start, Hot-Reload, Authentifizierung, Schlüsselverwaltung, Sandbox-Richtlinien und Log-Monitoring als eigene Kapitel ausgewiesen. Fernzugriff läuft laut Material über SSH-Tunnel oder Tailscale. Das sind konkrete Konfigurationsbereiche, keine allgemeinen Ratschläge. Was das README nicht liefert, sind die tatsächlichen Befehlszeilen: Es beschreibt die Kapitel, nicht deren Inhalt. Wer prüfen will, ob die Anleitung zum eigenen Setup passt, muss die verlinkten Markdown-Dateien öffnen.
Die Skill-Idee und wo sie an Grenzen stößt
Der wiederkehrende Baustein ist das Skill: eine Erweiterung, die einem Agenten eine konkrete Fähigkeit gibt. Das README verweist auf einen Abschnitt zu Skill-Dateistruktur, Frontmatter, asynchroner Verarbeitung und Debugging. In den Release-Notizen zu OpenClaw 3.22 wird zudem ein Plugin-SDK-Refactoring erwähnt, bei dem die alte extension-api als veraltet markiert wurde. Wer eigene Skills gegen diese API schreibt, muss also mit Bruchstellen zwischen Versionen rechnen.
Genau hier liegt die praktische Grenze des Materials. Ein Tutorial kann einen stabilen Stand beschreiben, die zugrunde liegende Plattform ändert sich aber schneller. Die Dynamik-Liste im README nennt für März 2026 unter anderem neue Gateway-Endpunkte, eine Microsoft-Teams-Integration, einen before_dispatch-Hook und einen Container-Schalter für die CLI. Das zeigt die Richtung, in die sich OpenClaw bewegt, und gleichzeitig, wie schnell einzelne Kapitel veralten können. Wer das Tutorial als dauerhaft gültige Referenz behandelt, wird an Stellen wie der Plugin-API oder den Gateway-Endpunkten nachbessern müssen.
Wartung, Lizenz und ein Blick auf Alternativen
Die Lizenz ist CC BY-NC-SA 4.0. Das ist eine Inhaltslizenz, keine Softwarelizenz, und sie schließt kommerzielle Nutzung aus. Wer das Material in einem bezahlten Schulungsangebot verwenden will, muss das vorab klären; eine rechtliche Bewertung kann dieser Text nicht leisten. Für den Code, den das Tutorial beschreibt, gilt diese Lizenz ohnehin nicht, da er in einem separaten Projekt liegt.
Die Wartungslage lässt sich an der Aktivität ablesen: Der letzte Push datiert auf August 2026, Releases werden für das Repository selbst nicht ausgewiesen. Die Dynamik-Einträge zeigen eine laufende Pflege, aber auch, dass die Inhalte an eine schnell wechselnde Plattform gekoppelt sind. Das unterscheidet hello-claw von einem eigenständigen Framework, das seine eigene Versionierung kontrolliert.
Als Alternative bietet sich an, direkt in die OpenClaw-Dokumentation und den Quellcode zu gehen. Der Unterschied ist einer der Reihenfolge: hello-claw liefert eine didaktische Progression mit Szenarien und einer Trennung nach Lesertypen, die offizielle Dokumentation liefert Referenzmaterial ohne Lernkurve. Wer bereits weiß, was er sucht, ist mit der Referenz schneller. Wer eine Route durch die Bausteine braucht, profitiert vom Tutorial. Ein weiterer Unterschied: hello-claw verlinkt auf ein Schwesterprojekt namens easy-vibe für Vibe Coding, was den Charakter als Lernökosystem unterstreicht.
Redaktionelles Fazit
Wer OpenClaw auf eigener Hardware oder VM betreiben will, eine der drei Routen aus dem README wählt und die Lizenz CC BY-NC-SA 4.0 akzeptiert, bekommt hier eine sortierte Lernstrecke mit Anleitung zum manuellen Installationsweg. Wer einen fertigen Assistenten sucht, der nach dem Auspacken Aufgaben übernimmt, ist hier falsch; hello-claw liefert Text, Konfigurationsschritte und Beispiel-Skills, keinen laufenden Dienst. Vor dem Start sollte man klären, ob die eigene Node.js-Version zum im Tutorial beschriebenen Installationsweg passt und ob das geplante Einsatzfeld eine nicht-kommerzielle Lizenz zulässt.
Community-Notizen