Wie man ZeroClaw installiert: Anfängerfreundliche Schnellstartanleitung für eine leichte OpenClaw-Alternative

Warum ZeroClaw die Installation wert ist

Wenn Sie jemals ein KI-Tool installiert haben, beobachtet haben, wie die Binärdatei in Ihrem “PATH” landet, und immer noch keinen Beweis hatten, dass es ein Modell erreichen, seinen Arbeitsbereich verstehen oder sicher antworten kann, verstehen Sie bereits das Problem, das dieser Leitfaden löst. Eine abgeschlossene Installation beweist nur, dass Dateien kopiert wurden. Sie beweist nicht, dass die Agent-Runtime nutzbar ist.

Hier wird ZeroClaw interessant. Es ist eine leichte KI-Agent-Runtime, die um eine einzelne Rust-Binärdatei herum aufgebaut ist und von Anfang an Unterstützung für gehostete Modell-Provider statt eines schweren lokalen Stacks bietet. In der Praxis bedeutet das, dass es näher an “einer kontrollierten Tool-nutzenden Runtime” ist als an “einem Chatbot in einem Terminal.” Für Leser, die neugierig auf den “OpenClaw-Alternative”-Winkel sind, ist der praktische Reiz nicht Hype oder Benchmarks. Es ist die leichtere Installationsgeschichte, das geringere Abhängigkeitsgewicht und die Tatsache, dass das Testen auf einem Ubuntu VPS verwaltbar wirkt, anstatt sich in ein vollständiges Infrastrukturprojekt zu verwandeln.

Dieser Artikel konzentriert sich eng auf ein Ergebnis: ZeroClaw installieren, “zeroclaw onboard” ausführen, eine sichere erste CLI-Sitzung überprüfen und mit einer realistischen Vorstellung davon gehen, was man als Nächstes versuchen kann. Das ist der richtige erste Meilenstein für eine anfängerfreundliche VPS-Anleitung, denn “funktionierend” sollte eine fundierte erste Antwort bedeuten, die Sie überprüfen können, nicht eine lange Feature-Tour.

📝 Hinweis: Dieser Leitfaden beweist die erste funktionierende CLI-Nutzung. Es ist kein Produktionsbereitstellungsleitfaden und versucht nicht, Docker, öffentliche Gateways oder Hintergrunddienste abzudecken

Was ZeroClaw ist — in einfachen Worten

ZeroClaw wird besser als Agent-Runtime verstanden als als “ein KI-Chatbot.” Das Modell ist nur ein Teil des Systems. ZeroClaw ist die Schicht, die ein Provider-Konto, eine Modellwahl, ein Agent-Profil und einen begrenzten Arbeitsbereich verbindet, damit das Tool mehr tun kann, als eine einzelne Eingabeaufforderung isoliert zu beantworten.

Die vier Begriffe unten sind die wichtigsten in diesem Tutorial:

Die Arbeitsbereich-Idee ist wichtiger, als sie klingt. In diesem Artikel ist der Arbeitsbereich der Raum, in dem der Agent arbeiten darf. Deshalb ist die Installation von ZeroClaw nicht dasselbe wie die Konfiguration von ZeroClaw: Die Binärdatei kann auf der Festplatte vorhanden sein, während Provider, Modell, Alias und Arbeitsbereich immer noch fehlen oder falsch verdrahtet sind.

📝 Hinweis: Eine erfolgreiche Installation ist nur die halbe Geschichte. Der aussagekräftige Meilenstein ist eine funktionierende Konfiguration unter ~/.zeroclaw, die einen Provider erreichen und in einem sichtbaren Arbeitsbereich arbeiten kann.

Dies ist auch die sauberste Möglichkeit zu erklären, warum manche Menschen ZeroClaw als OpenClaw-Alternative betrachten, ohne einen vollständigen Vergleich zu erzwingen. Der Wert ist nicht “OpenClaw in Rust umgeschrieben”, und dieser Leitfaden behandelt es nicht so. Der Wert ist eine leichtere Self-Hosting-Haltung, Provider-Flexibilität und eine Single-Binary-Runtime, die auf einem VPS leicht zu testen ist.

Gute erste Anwendungsfälle sind gleichermaßen fundiert: Zusammenfassung einer sicheren Repo-Kopie, Erklärung einer Konfigurationsdatei, Handhabung einer schreibgeschützten Helferaufgabe in einem risikoarmen Arbeitsbereich oder Verwendung als begrenzter Assistent für Operatoren, die Sichtbarkeit möchten, bevor sie echte Änderungen zulassen.

Vor der Installation: Ubuntu-Baseline, Voraussetzungen und Sicherheit

Bevor Sie das Installationsprogramm ausführen, verbringen Sie eine Minute damit, zu bestätigen, dass der VPS tatsächlich ein guter Kandidat für den Pfad ist, den dieser Artikel verwendet. Die Mindestanforderungen sind unkompliziert: SSH-Zugriff auf einen Ubuntu VPS, curl, ein gehostetes Provider-Konto mit einem API-Schlüssel und eine risikoarme Maschine oder ein Arbeitsbereich für die erste Sitzung.

Führen Sie zunächst die folgenden Überprüfungen durch. In der angezeigten Validierungslauf gaben sie Ubuntu 24.04.4 LTS (Noble Numbat), x86_64 und /usr/bin/curl zurück. Das reicht aus, um die Baseline des Leitfadens zu bestätigen, ohne so zu tun, als würde jeder Server identische Ausgaben zurückgeben.

cat /etc/os-release

uname -m
command -v curl

Für das gehostete Provider-Beispiel ist OpenRouter die sauberste Standardeinstellung, da es die VPS-Anleitung VPS-freundlich hält und die lokale Modelleinrichtung auf dem Server vermeidet. Wenn Sie bereits einen anderen unterstützten Provider verwenden, ist das in Ordnung, aber halten Sie den API-Schlüssel bereit, bevor zeroclaw onboard anfängt, Fragen zu stellen. Das Ziel hier ist erster Erfolg, nicht Provider-Shopping, also ist ein sauberer gehosteter Pfad besser als der Versuch, jeden Provider in derselben Sitzung zu evaluieren.

ZeroClaw unterstützt sowohl vorgefertigte als auch Source-Installationspfade. Denken Sie an die vorgefertigte Route als ein fertiges Gerät und die Source-Route als ein Bausatz zum Selbermachen. Beide sind legitim, aber sie dienen verschiedenen Lesern. Für diesen Schnelleinstieg ist das Wichtigste, den Unterschied jetzt zu verstehen und die eigentliche Empfehlung im Installationsschritt zu machen.

⚠️ Warnung: Verwenden Sie diese Checkliste für den ersten Lauf, bevor Sie fortfahren:

• bleiben Sie in einem risikoarmen Arbeitsbereich
• behalten Sie das Standard-Überwachungsverhalten bei
• vermeiden Sie öffentliche Exposition und Produktionsdaten
• machen Sie die erste Aufgabe absichtlich schreibgeschützt

Installieren Sie ZeroClaw mit dem offiziellen Skript

Nachdem die Vorflight-Überprüfung erledigt ist, verwenden Sie das offizielle Installationsprogramm als Hauptpfad. Dies ist der kürzeste unterstützte Weg für einen Ubuntu VPS-Schnelleinstieg:

curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | bash

Auf diesem Installationspfad wird das Skript nicht interaktiv ausgeführt und nimmt automatisch den vorgefertigten Release-Pfad. In der Validierungslauf für diesen Leitfaden erkannte es das Linux-Ziel, lud den entsprechenden GitHub-Release-Tarball herunter, überprüfte die Prüfsumme, installierte die Web-Dashboard-Assets unter ~/.local/share/zeroclaw/web/dist und platzierte die zeroclaw-Binärdatei in ~/.cargo/bin. Da die Screenshots vom Root-Konto erfasst wurden, sind die konkreten Pfade /root/.local/share/zeroclaw/web/dist, /root/.cargo/bin/zeroclaw und /root/.bashrc; auf einem regulären Benutzerkonto erwarten Sie das gleiche Layout in Ihrem eigenen Home-Verzeichnis.

Dieser schnelle Pfad ist keine Abkürzung oder eine weniger offizielle Installation. Es ist die normale Schnelleinstiegsroute für die Zielgruppe dieses Leitfadens: Laden Sie die entsprechende Release herunter, überprüfen Sie sie und platzieren Sie die Binärdatei in ~/.cargo/bin/zeroclaw. Wenn Sie absichtlich einen Source-Build möchten, verwenden Sie stattdessen den Repo-Clone-Pfad unten, anstatt zu erwarten, dass dieser Installer-Fluss stoppt und eine separate Build-Wahl anbietet.

💡 Tipp: Unter Linux ist das häufigste Problem nach der Installation PATH, nicht die Installation selbst. Folgen Sie dem Vorschlag des Installationsprogramms, export PATH=”$HOME/.cargo/bin:$PATH” zu Ihrem Shell-Profil hinzuzufügen und es mit source ~/.bashrc neu zu laden (oder öffnen Sie die Shell erneut). Wenn Sie nur eine temporäre Lösung für die aktuelle Sitzung benötigen, verwenden Sie den unten gezeigten einzeiligen Export.

Nachdem die Binärdatei vorhanden ist, beendet das Skript mit einer nicht-interaktiven Bestätigungsmeldung, anstatt das Setup automatisch zu starten. In der Validierungslauf für diesen Leitfaden wies diese Schlussmeldung auf zeroclaw quickstart hin, aber die installierte “v0.7.5”-Binärdatei zeigte onboard als den tatsächlichen Setup-Unterbefehl in zeroclaw –help. Es weist auch darauf hin, dass zeroclaw daemon der Pfad für den Always-On-Daemon plus Web-Dashboard ist, während zeroclaw agent der einmalige CLI-Chat-Pfad ist.

Fahren Sie für diesen Artikel als Nächstes mit zeroclaw onboard fort. Das hält die Anleitung an das tatsächliche Versprechen des Artikels ausgerichtet: erste funktionierende Agent-Sitzung im Terminal, nicht Dashboard-Pairing oder Always-On-Runtime.

Wenn Sie sicherheitsbewusst sind und das Installationsprogramm vor dem Ausführen überprüfen möchten, verwenden Sie diesen alternativen Ansatz:

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./install.sh

Bevor Sie über Provider oder Prompts nachdenken, überprüfen Sie, dass die Binärdatei in der Shell aufrufbar ist:

zeroclaw --version

Wenn das funktioniert, war die Installation selbst erfolgreich. Wenn die Shell command not found sagt, wenden Sie die temporäre PATH-Korrektur unten an und testen Sie erneut:

export PATH="$HOME/.cargo/bin:$PATH"

Die Trennung dieses Schritts von der Konfiguration ist wichtig. Ein funktionierendes zeroclaw –version sagt Ihnen, dass das Installationsproblem gelöst ist, bevor Sie mit dem Debugging der Provider-Einrichtung beginnen.

Führen Sie zeroclaw onboard aus und überprüfen Sie, was es erstellt hat

Dies ist der Punkt, an dem “installiert” “konfiguriert” werden muss. Auf dem nicht-interaktiven Installationspfad, der oben verwendet wird, überspringt das Skript explizit die Setup-Eingabeaufforderung. Wenn die Installermeldung zeroclaw quickstart erwähnt, aber die Binärdatei erkennt sie nicht, vertrauen Sie zeroclaw –help und starten Sie den First-Run-Assistenten mit:

zeroclaw onboard

Der Assistent öffnet sich auf dem Arbeitsbereich-Bildschirm. In der erfassten Ausführung war der Standard-Arbeitsbereich-Pfad /root/.zeroclaw/workspace. Wenn Sie keinen triftigen Grund haben, ihn zu verschieben, akzeptieren Sie den Standard. Auf einem Nicht-Root-Konto wird das gleiche Layout in Ihrem eigenen Home-Verzeichnis vorhanden sein.

Für diese anfängerfreundliche CLI-Anleitung lassen Sie Multi-Workspace-Profile deaktiviert. Wenn Sie sie aktivieren, werden separate Speicher-, Secrets- und Audit-Verzeichnisse pro Engagement erstellt, was später nützlich sein kann, aber es fügt zusätzliche mentale Belastung für einen ersten Smoke-Test hinzu.

Wählen Sie auf dem Provider-Bildschirm OpenRouter. Die Liste ist viel größer als ein Anfängerleitfaden benötigt, was genau der Grund ist, warum es hilft, einen sauberen gehosteten Pfad zu wählen und beim ersten Lauf dabei zu bleiben.

Fügen Sie Ihren OpenRouter API-Schlüssel ein, wenn Sie dazu aufgefordert werden. Die Eingabe ist verborgen, und die Eingabeaufforderung vermerkt ausdrücklich, dass ZeroClaw das Geheimnis über den OS-Schlüsselbund speichert, wenn möglich, anstatt Sie zu bitten, es in config.toml hart zu codieren.

Die OpenRouter-Modellliste ist lang. In der erfassten Ausführung wurde deepseek/deepseek-v4-pro ausgewählt. Sie können ein anderes aktuelles OpenRouter-Modell wählen, wenn Sie möchten, aber der Rest dieser Anleitung folgt dieser genauen Auswahl.

Wenn der Assistent nach erweiterten Einstellungen fragt, lassen Sie sie für diesen Leitfaden aus. Wenn Sie sie aktivieren, können Sie gezielt Overrides wie Temperatur, Timeout, Basis-URL oder Wire-Protokoll vornehmen.

Wählen Sie auf dem Kanäle-Bildschirm Fertig, ohne Discord, Telegram, Slack oder andere externe Oberflächen hinzuzufügen. Das hält die erste Validierung nur CLI. Sie können Kanäle später hinzufügen, sobald der lokale Agent-Pfad funktioniert.

Wählen Sie für den Speicher SQLite mit Vektorsuche (empfohlen). Es ist die stärkste Standardeinstellung hier, da alles lokal bleibt und Sie dennoch Hybrid-Suche und Embedding-Unterstützung erhalten.

Lassen Sie Auto-Speichern auf Ja eingestellt, damit Ihre eigenen Prompts als Gesprächsverlauf aufgezeichnet werden. Wenn Sie dies später möchten, können Sie dies ausschalten und den Speicher nur explizit speichern.

Lassen Sie die Hardwaresteuerung deaktiviert. Dieses VPS-Setup benötigt keine GPIO, USB-gebundenen Boards oder Debug-Sonden.

Für den öffentlichen Tunnel-Provider halten Sie ihn auf keine. Das entspricht der Sicherheitshaltung dieses Artikels: keine öffentliche Exposition während des ersten Smoke-Tests.

Wenn der Persönlichkeits-Schritt sagt, dass er bereits konfiguriert ist, lassen Sie Neu konfigurieren? auf Nein. Die Standard-Persönlichkeit reicht für die Validierung beim ersten Lauf aus.

Was hier wichtig ist, ist nicht, jeden Assistenten-Panel auswendig zu lernen. Was wichtig ist, ist der Pfad, den die Screenshots beweisen: einzelner Arbeitsbereich, OpenRouter-Provider, versteckte API-Schlüsseleingabe, eine konkrete Modellwahl, keine erweiterten Overrides, keine zusätzlichen Kanäle, lokaler SQLite-Speicher, Auto-Speichern an, Hardware aus, kein öffentlicher Tunnel und keine Persönlichkeitsumschreibung. Das ist mehr als genug, um eine nutzbare erste CLI-Konfiguration unter ~/.zeroclaw zu erstellen.

Nachdem das Onboarding abgeschlossen ist, bestätigen Sie, dass das Hauptkonfigurationsverzeichnis und der Arbeitsbereich vorhanden sind:

Wenn die Onboarding-Ausführung sauber abgeschlossen wird, sollten Sie mit einer Konfiguration-geladenen Meldung wie der unten gezeigten zur Shell zurückkehren:

ls ~/.zeroclaw
ls ~/.zeroclaw/workspace

In der erfassten Ausführung enthielt ~/.zeroclaw config.toml und workspace/, und der Arbeitsbereich selbst zeigte IDENTITY.md und SOUL.md.

Das reicht bereits aus, um zu beweisen, dass ZeroClaw jetzt einen Betriebsraum hat, nicht nur eine installierte Binärdatei. Das ist auch der Grund, warum die Arbeitsbereich-Analogie nützlich ist: Sie überprüfen, dass der Raum vorhanden ist, dass der Agent Kontext darin hat, und dass das Setup über “das Installationsprogramm ist fertig” hinausgegangen ist. Dateien wie IDENTITY.md und SOUL.md sind nicht dekorativ. Sie sind Teil des Kontexts, den ZeroClaw verwendet, um zu verstehen, wie es sich in diesem Arbeitsbereich verhalten sollte.

Führen Sie vor dem ersten Live-Prompt eine kompakte Integritätsprüfung durch:

zeroclaw status

zeroclaw doctor

Für diesen ersten CLI-only Smoke-Test geraten Sie nicht in Panik, wenn zeroclaw doctor nicht perfekt sauber ist. In der erfassten Ausführung bestanden die wichtigen Überprüfungen: Die Konfigurationsdatei wurde gefunden, der openrouter-Provider war gültig, der API-Schlüssel war konfiguriert, das Standard-Modell war eingestellt und der Arbeitsbereich existierte und war beschreibbar.

Die verbleibenden Warnungen und Fehler sind nicht kritisch für einen Terminal-Chat: “keine Kanäle konfiguriert” ist erwartet, da die Anleitung absichtlich Discord, Telegram und andere externe Kanäle übersprungen hat; AGENTS.md nicht gefunden (optional) ist explizit nicht blockierend; daemon_state.json nicht gefunden bedeutet nur, dass der Always-On-Daemon noch nicht läuft; und die OpenRouter-Live-Modell-Listing-Beschwerde wird besser als Sondierungsbeschränkung gelesen als Beweis, dass die Provider-Einrichtung fehlgeschlagen ist, besonders da die Ausgabe immer noch openrouter: 344 Modelle meldet.

grep -E 'default_provider|default_model|[agents.|[risk_profiles.' ~/.zeroclaw/config.toml

Das Erfolgssignal hier ist operativ, nicht kosmetisch. zeroclaw status ist die klarste Quelle der Wahrheit für die aktive Runtime-Zusammenfassung, zeroclaw doctor sagt Ihnen, ob etwas Wichtiges kaputt ist, und die grep-Ausgabe wird am besten als grober Blick auf Provider/Modell-bezogene Konfigurationseinträge behandelt, anstatt als perfekte Einzeilige Validierung. Erwarten Sie, dass sich Formulierungen und genaue Übereinstimmungen je nach Version unterscheiden. Sie suchen nicht nach einer perfekten Wand aus grünem Text. Sie suchen nach dem Fehlen von First-Run-Blockierern und dem Vorhandensein echter Konfigurationsdaten.

📝 Hinweis: config.toml zeigt möglicherweise Ihren API-Schlüssel nicht im Klartext an. Das kann normal sein. In der erfassten Onboarding-Ausführung sagte die API-Schlüssel-Eingabeaufforderung ausdrücklich, dass das Geheimnis über den OS-Schlüsselbund gespeichert würde, wenn möglich, also ist “kein sichtbarer Schlüssel in der TOML-Datei” nicht dasselbe wie “Setup fehlgeschlagen.”

Starten Sie den ersten sicheren CLI-Chat

Mit der Konfiguration und dem Arbeitsbereich vorhanden, starten Sie den Agent im interaktiven Modus:

zeroclaw agent

In der erfassten Ausführung lud ZeroClaw die Konfiguration, initialisierte SQLite-gestützten Speicher, druckte das Banner für den interaktiven Modus und fiel zur >-Eingabeaufforderung. Das Ziel ist nicht, eine flashy Demo zu starten. Das Ziel ist, End-to-End-Konnektivität, gültige Konfiguration und fundiertes Arbeitsbereich-Bewusstsein in einem risikoarmen Schritt zu beweisen. Ein schreibgeschützter Test gibt Ihnen zu diesem Zeitpunkt viel nützlichere Signale als ein schreibfähiger “schauen Sie, was es kann”-Prompt.

Verwenden Sie für den ersten Prompt diese genaue schreibgeschützte Überprüfung:

tell me your current workspace path, list the top-level files you can see there, and briefly explain what each one is for. Do not create, edit, or delete anything.

Da die Runtime im überwachten Modus ist, kann die erste nützliche Antwort eine Tool-Genehmigung erfordern. In der erfassten Ausführung fragte ZeroClaw, um einen schreibgeschützten Shell-Befehl auszuführen: “pwd && echo “—-” && ls -la”

Das ist genau die Art von Befehl, den Sie für diesen Smoke-Test möchten: Er druckt den Arbeitsbereich-Pfad und listet die Top-Level-Inhalte auf, ohne etwas zu ändern. Genehmigen Sie ihn mit Y für ein einmaliges Ja. Sie könnten ihn auch mit N ablehnen, aber dann würde der Agent die einfachste Möglichkeit verlieren, die Frage aus echtem Dateisystem-Status zu beantworten, anstatt zu raten.

📝 Hinweis:Sie können auch eine Kostenverfolgungs-Warnung für das ausgewählte OpenRouter-Modell vor der Genehmigungsaufforderung sehen. In der erfassten Ausführung warnte ZeroClaw, dass kein Preiseintrag für openrouter/deepseek/deepseek-v4-pro definiert war. Das blockiert den Chat selbst nicht. Es bedeutet nur, dass die Token-Nutzung möglicherweise mit Nullkosten aufgezeichnet wird, bis Sie die Modellpreise explizit definieren.

Dieser Prompt ist stark, weil er drei Dinge gleichzeitig testet. Erstens muss ZeroClaw den Provider erreichen und eine Antwort zurückbekommen. Zweitens muss der Agent den konfigurierten Arbeitsbereich verstehen. Drittens muss die Antwort spezifisch genug sein, dass Sie sie gegen das vergleichen können, was tatsächlich auf der Festplatte ist. Mit anderen Worten, dies beweist, dass der Agent in dem Raum bleibt, der ihm gegeben wurde.

Eine gute erste Antwort sollte vier Bedingungen erfüllen:

• keine Authentifizierungs- oder Provider-Fehler
• keine “Konfiguration nicht gefunden” oder fehlende Modell-Fehler
• der korrekte Arbeitsbereich-Pfad erscheint in der Antwort
• echte Top-Level-Dateien werden benannt, ohne zu behaupten, dass etwas geändert wurde

Wenn Sie eine andere Möglichkeit möchten, den Agent aufzurufen, können Sie denselben Prompt als einmaligen Befehl senden, anstatt in der interaktiven Sitzung zu bleiben. Behandeln Sie dies als optional, nicht als Hauptanleitung. Der interaktive Pfad ist immer noch die bessere erste Erfahrung, da er die Runtime beobachtbar wirken lässt, anstatt magisch.

zeroclaw agent -m "tell me your current workspace path, list the top-level files you can see there, and briefly explain what each one is for. Do not create, edit, or delete anything."

Was Sie tun sollten, wenn ZeroClaw funktioniert

Der richtige nächste Schritt ist nicht, jede Funktion einzuschalten, die