Installationsanleitung

ZeroClaw zum Laufen bringen

Ein einzelnes Rust-Binary, mehrere Installationswege. Wähle, was für dich passt.

checklist Systemanforderungen

build Rust

Rust-Toolchain (stable) via rustup.rs — nur für Source-Builds nötig

computer OS

Linux (x86_64, aarch64, armv7), macOS (x86_64, aarch64), Windows (x86_64)

memory RAM

Runtime: <5MB RAM. Aus Quellcode bauen: 2GB+ RAM, 4GB empfohlen

hard_drive Disk

Binary: ~8,8MB. Aus Quellcode bauen: 6GB freier Speicher, 10GB empfohlen

extension Optional

Optional: Docker (für Sandbox-Runtime), Git (für Source-Builds)

wifi Network

Internet für KI-API-Aufrufe. Lokale Modelle via Ollama funktionieren komplett offline.

Ein-Zeilen-Skripte, die alles erledigen. Für die meisten empfohlen.

bolt

Remote One-Liner

macOS / Linux. Single command.

$ curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash
rocket_launch

Local Bootstrap

Clone first, then bootstrap. More options.

$ git clone https://github.com/zeroclaw-labs/zeroclaw.git
$ cd zeroclaw && ./bootstrap.sh
$ # With system deps + Rust: ./bootstrap.sh --install-system-deps --install-rust
$ # With onboarding: ./bootstrap.sh --onboard --api-key "sk-..." --provider openrouter

verified Installation überprüfen

Führe diese Befehle aus, um zu prüfen, ob ZeroClaw korrekt installiert ist.

1
$ zeroclaw --version

Sollte die installierte Version ausgeben. Läuft in ~0,02s mit ~3,9MB Peak-Memory.

2
$ zeroclaw doctor

Führt Systemdiagnosen durch: Rust-Version, Konfigurationsdateien, Provider-Konnektivität, Channel-Zustand.

3
$ zeroclaw onboard --interactive

Interaktiver Setup-Assistent für API-Keys, Provider-Auswahl und Channel-Konfiguration.

settings Erstkonfiguration

Nach der Installation führt dich der Onboard-Assistent durch das Setup. Hier ist, was jeder Schritt macht.

1

KI-Anbieter wählen

Aus dem Provider-Katalog wählen: OpenAI, Anthropic, Google Gemini, xAI, Mistral, DeepSeek, OpenRouter (100+ Modelle) oder jeden OpenAI-kompatiblen Endpoint inklusive Ollama für lokale Modelle.

2

API-Key hinzufügen

Füge deinen API-Key ein. Keys werden lokal in config.toml gespeichert — werden nirgendwohin gesendet außer zum KI-Anbieter. Subscription-Auth (OpenAI Codex, Anthropic) wird ebenfalls mit verschlüsselten Profilen unterstützt.

3

Channel verbinden

Telegram (Bot-Token einfügen), Discord (Bot-Token einfügen), Slack (Workspace-App), WhatsApp (QR-Code) oder einen der 17+ unterstützten Channels verbinden. Deny-by-Default-Allowlist-Policy.

4

Agent starten

Führe 'zeroclaw agent -m "Hallo!"' für einen schnellen Test aus, 'zeroclaw daemon' für die vollständige autonome Runtime oder 'zeroclaw service install' für den Hintergrunddienst.

.env — Die gesamte Konfiguration wird in ~/.zeroclaw/config.toml gespeichert. Direkt bearbeiten, um Provider, Channels, Memory-Backends, Tunnels und Sicherheitseinstellungen zu ändern. Siehe docs/reference/README.md für die vollständige Referenz.

system_update_alt ZeroClaw aktualisieren

Halte ZeroClaw aktuell, um die neuesten Features, Integrationen und Sicherheits-Patches zu erhalten.

Homebrew
$ brew upgrade zeroclaw
Cargo
$ cargo install zeroclaw --force
Git
$ cd zeroclaw && git pull && cargo build --release --locked
Docker
$ ./bootstrap.sh --docker --skip-build

Schau dir den Changelog auf github.com/zeroclaw-labs/zeroclaw/releases an, um zu sehen, was in jeder Version neu ist.

build Fehlerbehebung

Häufige Probleme und wie du sie löst.

Brauchst du Hilfe?

Tritt unserer Community für Installations-Support und Fehlerbehebung bei.

Auf dem Laufenden bleiben

Erhalte Updates zu neuen Releases, Integrationen und Rust-basierter Agent-Infrastruktur. Kein Spam, jederzeit abbestellbar.