ZeroClaw Setup und erster Start

1. Was die Installation dir tatsächlich gibt

Der offizielle Installationsablauf ist bewusst meinungsstark: Er legt nicht einfach eine Binary irgendwo ab und hört dann auf. Er ist darauf ausgelegt, dich in einem Durchgang von "nichts installiert" zu "funktionierender Agent-Konfiguration" zu bringen.

Der Standard-Installer ist:

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

Oder aus einem Clone:

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

Der Installer kann:

• eine vorgefertigte Binary für das schnellste Setup installieren,
• aus dem Source bauen, wenn du Feature-Kontrolle willst,
• auswählen, welche Apps installiert werden,
• das Gateway einbeziehen oder weglassen,
• den Quickstart-Ablauf automatisch starten.

Nützliche Flags, die die Upstream-README hervorhebt:

./install.sh --prebuilt
./install.sh --source
./install.sh --preset minimal
./install.sh --apps zerocode
./install.sh --without-tui
./install.sh --with-gateway
./install.sh --without-gateway
./install.sh --skip-quickstart
./install.sh --list-features

2. Vorgefertigt vs. Source-Build

Für die meisten Menschen ist die eigentliche Entscheidung einfach:

Pfad	Am besten, wenn
Vorgefertigt	Du schnell eine funktionierende Runtime willst
Source-Build	Du eigene Features, bestimmte Channel-Sets brauchst oder am Code basteln willst

Source-Builds spielen in ZeroClaw eine größere Rolle als in vielen Agent-Tools, weil das Projekt feature-gegatete Oberflächen verwendet. Du kannst eine schlankere Binary kompilieren, wenn du nicht den vollen Channel-/Tool-Umfang brauchst.

3. Quickstart ist das eigentliche Onboarding

Nach der Installation ist der wichtigste Befehl:

zeroclaw quickstart

Quickstart ist nicht nur ein Wizard. Es ist der kanonische Weg, um eine funktionierende Konfiguration zu erstellen. Die offizielle Dokumentation beschreibt ihn als einen geführten Ablauf, der auf drei Oberflächen verfügbar ist:

• CLI
• zerocode Terminal-UI
• Web-Gateway-Dashboard

Alle drei schreiben dasselbe zugrunde liegende Konfigurationsmodell.

CLI

Am besten über SSH, auf Servern oder wenn du den kürzesten Weg willst:

zeroclaw quickstart

zerocode

Am besten, wenn du eine Terminal-UI willst für:

• Chat,
• Quickstart,
• Konfigurations-Inspektion,
• Live-Logs,
• Daemon-Monitoring.

Web-Gateway

Am besten, wenn du browserbasiertes Setup bevorzugst oder einen dashboard-zentrierten Workflow willst.

Die Dokumentation verweist auf:

zeroclaw daemon

Öffne dann:

http://127.0.0.1:42617/quickstart

Die offizielle Quickstart-Dokumentation merkt an, dass der daemon-gestützte Web-Ablauf die Konfiguration über dedizierte API-Endpunkte validieren und anwenden und den Daemon an Ort und Stelle neu laden kann.

4. Der minimale funktionierende Pfad

Die kleinste nützliche Sequenz für den ersten Start ist:

zeroclaw quickstart
zeroclaw agent -a <alias>

Sobald das funktioniert, wechsle in den Always-on-Modus:

zeroclaw service install
zeroclaw service start

Das gibt dir die beiden grundlegenden Betriebsstile:

• interaktive einmalige Agent-Sessions
• Hintergrund-Service-/Daemon-Modus

5. Was erstellt wird

Die offizielle Dokumentation verweist auf eine primäre Konfigurationsdatei:

~/.zeroclaw/config.toml

Die Provider-Konfigurationsdokumentation beschreibt außerdem einen lokalen Secrets-Store unter:

~/.zeroclaw/secrets

Diese Aufteilung ist wichtig:

• config.toml enthält die strukturelle Verdrahtung,
• der Secrets-Store ist der bevorzugte Ort für Credentials,
• Environment-Overrides können beim Prozessstart bei Bedarf trotzdem Vorrang haben.

6. Die wichtigsten Runtime-Oberflächen nach dem Setup

Nach der Installation gibt es vier Befehle, die man sich merken sollte:

Befehl	Wofür er da ist
zeroclaw quickstart	Ein funktionierendes Setup erstellen oder reparieren
zeroclaw agent -a <alias>	Einen Agent interaktiv ausführen
zeroclaw daemon	Die vollständige Runtime mit Gateway, Channels und Scheduler ausführen
zeroclaw service install && zeroclaw service start	Den Hintergrund-Service-Modus registrieren und starten

Und es gibt zwei wichtigste Betreiber-Oberflächen:

• zerocode für die Terminal-first-Nutzung
• Gateway-Dashboard für die Browser-first-Nutzung

7. Praktische Empfehlung

Wenn du ZeroClaw als Entwickelnder evaluierst:

1. installiere den Standard-Build,
2. führe zeroclaw quickstart aus,
3. validiere den Agent mit zeroclaw agent -a <alias>,
4. starte zerocode,
5. entscheide erst dann, ob du einen eigenen Source-Build oder den Always-on-Daemon-Modus brauchst.

Diese Sequenz vermittelt das Produkt in derselben Reihenfolge, die die Architektur erwartet.