🦀 ZeroClaw — Persönlicher KI-Assistent

Null Overhead. Null Kompromisse. 100% Rust. 100% Agnostisch.
⚡️ Läuft auf $10-Hardware mit <5MB RAM: 99% weniger Speicher als OpenClaw und 98% günstiger als ein Mac mini!

Entwickelt von Studenten und Mitgliedern der Communitys von Harvard, MIT und Sundai.Club.

🌐 Sprachen: 🇺🇸 English · 🇨🇳 简体中文 · 🇯🇵 日本語 · 🇰🇷 한국어 · 🇻🇳 Tiếng Việt · 🇵🇭 Tagalog · 🇪🇸 Español · 🇧🇷 Português · 🇮🇹 Italiano · 🇩🇪 Deutsch · 🇫🇷 Français · 🇸🇦 العربية · 🇮🇳 हिन्दी · 🇷🇺 Русский · 🇧🇩 বাংলা · 🇮🇱 עברית · 🇵🇱 Polski · 🇨🇿 Čeština · 🇳🇱 Nederlands · 🇹🇷 Türkçe · 🇺🇦 Українська · 🇮🇩 Bahasa Indonesia · 🇹🇭 ไทย · 🇵🇰 اردو · 🇷🇴 Română · 🇸🇪 Svenska · 🇬🇷 Ελληνικά · 🇭🇺 Magyar · 🇫🇮 Suomi · 🇩🇰 Dansk · 🇳🇴 Norsk

ZeroClaw ist ein persönlicher KI-Assistent, den du auf deinen eigenen Geräten ausführst. Er antwortet dir auf den Kanälen, die du bereits nutzt (WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work und mehr). Er verfügt über ein Web-Dashboard für Echtzeitkontrolle und kann sich mit Hardware-Peripheriegeräten verbinden (ESP32, STM32, Arduino, Raspberry Pi). Das Gateway ist nur die Steuerungsebene — das Produkt ist der Assistent.

Wenn du einen persönlichen Einzelbenutzer-Assistenten willst, der sich lokal, schnell und immer verfügbar anfühlt, ist das genau das Richtige.

Website · Dokumentation · Architektur · Erste Schritte · Migration von OpenClaw · Fehlerbehebung · Discord

Empfohlene Einrichtung: Führe zeroclaw onboard in deinem Terminal aus. ZeroClaw Onboard führt dich Schritt für Schritt durch die Einrichtung von Gateway, Workspace, Kanälen und Provider. Es ist der empfohlene Einrichtungspfad und funktioniert auf macOS, Linux und Windows (über WSL2). Neue Installation? Starte hier: Erste Schritte

• OpenAI Codex (ChatGPT-Abonnement)
• Gemini (Google OAuth)
• Anthropic (API-Schlüssel oder Auth-Token)

Modellhinweis: Obwohl viele Provider/Modelle unterstützt werden, verwende für die beste Erfahrung das stärkste verfügbare Modell der neuesten Generation. Siehe Onboarding.

Modellkonfiguration + CLI: Provider-Referenz Auth-Profilrotation (OAuth vs API-Schlüssel) + Failover: Modell-Failover

Voraussetzung: Stabile Rust-Toolchain. Einzelnes Binary, keine Laufzeitabhängigkeiten.

brew install zeroclaw

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

zeroclaw onboard wird nach der Installation automatisch ausgeführt, um deinen Workspace und Provider zu konfigurieren.

Vollständige Einsteiger-Anleitung (Authentifizierung, Pairing, Kanäle): Erste Schritte

# Installieren + Onboard
./install.sh --api-key "sk-..." --provider openrouter

# Gateway starten (Webhook-Server + Web-Dashboard)
zeroclaw gateway                # Standard: 127.0.0.1:42617
zeroclaw gateway --port 0       # Zufälliger Port (gehärtete Sicherheit)

# Mit dem Assistenten sprechen
zeroclaw agent -m "Hello, ZeroClaw!"

# Interaktiver Modus
zeroclaw agent

# Vollständige autonome Laufzeit starten (Gateway + Kanäle + Cron + Hands)
zeroclaw daemon

# Status prüfen
zeroclaw status

# Diagnose ausführen
zeroclaw doctor

Aktualisierung? Führe zeroclaw doctor nach dem Update aus.

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

cargo build --release --locked
cargo install --path . --force --locked

zeroclaw onboard

Entwicklungs-Fallback (ohne globale Installation): Stelle Befehlen cargo run --release -- voran (Beispiel: cargo run --release -- status).

ZeroClaw kann deinen OpenClaw-Workspace, Speicher und Konfiguration importieren:

# Vorschau, was migriert wird (sicher, nur lesen)
zeroclaw migrate openclaw --dry-run

# Migration ausführen
zeroclaw migrate openclaw

Dies migriert deine Speichereinträge, Workspace-Dateien und Konfiguration von ~/.openclaw/ nach ~/.zeroclaw/. Die Konfiguration wird automatisch von JSON nach TOML konvertiert.

ZeroClaw verbindet sich mit echten Messaging-Oberflächen. Behandle eingehende DMs als nicht vertrauenswürdige Eingabe.

Vollständiger Sicherheitsleitfaden: SECURITY.md

Standardverhalten auf allen Kanälen:

• DM-Pairing (Standard): Unbekannte Absender erhalten einen kurzen Pairing-Code und der Bot verarbeitet ihre Nachricht nicht.
• Genehmige mit: zeroclaw pairing approve <channel> <code> (der Absender wird dann zu einer lokalen Allowlist hinzugefügt).
• Öffentliche eingehende DMs erfordern eine explizite Aktivierung in config.toml.
• Führe zeroclaw doctor aus, um riskante oder falsch konfigurierte DM-Richtlinien aufzudecken.

Autonomiestufen:

Sandboxing-Schichten: Workspace-Isolation, Pfad-Traversal-Blockierung, Befehls-Allowlisting, verbotene Pfade (/etc, /root, ~/.ssh), Ratenbegrenzung (max. Aktionen/Stunde, Kosten/Tag-Obergrenzen).

Verwende dieses Board für wichtige Hinweise (Breaking Changes, Sicherheitshinweise, Wartungsfenster und Release-Blocker).

• Leichte Laufzeitumgebung standardmäßig — gängige CLI- und Status-Workflows laufen in einem Speicherumfang von wenigen Megabyte bei Release-Builds.
• Kosteneffiziente Bereitstellung — entwickelt für $10-Boards und kleine Cloud-Instanzen, keine schwergewichtigen Laufzeitabhängigkeiten.
• Schnelle Kaltstarts — die Rust-Single-Binary-Laufzeit hält den Start von Befehlen und Daemon nahezu sofortig.
• Portable Architektur — ein Binary für ARM, x86 und RISC-V mit austauschbaren Providern/Kanälen/Tools.
• Local-first Gateway — einzelne Steuerungsebene für Sitzungen, Kanäle, Tools, Cron, SOPs und Events.
• Multi-Kanal-Posteingang — WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, Nostr, Mattermost, Nextcloud Talk, DingTalk, Lark, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, WebSocket und mehr.
• Multi-Agenten-Orchestrierung (Hands) — autonome Agentenschwärme, die nach Zeitplan laufen und mit der Zeit intelligenter werden.
• Standardbetriebsverfahren (SOPs) — ereignisgesteuerte Workflow-Automatisierung mit MQTT, Webhook, Cron und Peripherie-Triggern.
• Web-Dashboard — React 19 + Vite Web-UI mit Echtzeit-Chat, Speicher-Browser, Konfigurationseditor, Cron-Manager und Tool-Inspektor.
• Hardware-Peripheriegeräte — ESP32, STM32 Nucleo, Arduino, Raspberry Pi GPIO über den Peripheral-Trait.
• Erstklassige Tools — Shell, Datei-I/O, Browser, Git, Web Fetch/Search, MCP, Jira, Notion, Google Workspace und über 70 weitere.
• Lifecycle-Hooks — LLM-Aufrufe, Tool-Ausführungen und Nachrichten in jeder Phase abfangen und modifizieren.
• Skills-Plattform — mitgelieferte, Community- und Workspace-Skills mit Sicherheitsaudit.
• Tunnel-Unterstützung — Cloudflare, Tailscale, ngrok, OpenVPN und benutzerdefinierte Tunnel für Remote-Zugriff.

• Standardmäßig leicht: kleines Rust-Binary, schneller Start, geringer Speicherverbrauch.
• Sicher by Design: Pairing, striktes Sandboxing, explizite Allowlists, Workspace-Scoping.
• Vollständig austauschbar: Kernsysteme sind Traits (Provider, Kanäle, Tools, Speicher, Tunnel).
• Kein Vendor Lock-in: OpenAI-kompatible Provider-Unterstützung + steckbare benutzerdefinierte Endpunkte.

Schneller lokaler Benchmark (macOS arm64, Feb 2026), normalisiert für 0,8GHz Edge-Hardware.

Hinweise: ZeroClaw-Ergebnisse werden bei Release-Builds mit /usr/bin/time -l gemessen. OpenClaw benötigt die Node.js-Laufzeit (typischerweise ~390MB zusätzlicher Speicherverbrauch), während NanoBot die Python-Laufzeit benötigt. PicoClaw und ZeroClaw sind statische Binaries. Die RAM-Zahlen oben sind Laufzeitspeicher; die Kompilierungsanforderungen sind höher.

cargo build --release
ls -lh target/release/zeroclaw

/usr/bin/time -l target/release/zeroclaw --help
/usr/bin/time -l target/release/zeroclaw status

• Gateway HTTP/WS/SSE-Steuerungsebene mit Sitzungen, Präsenz, Konfiguration, Cron, Webhooks, Web-Dashboard und Pairing.
• CLI-Oberfläche: gateway, agent, onboard, doctor, status, service, migrate, auth, cron, channel, skills.
• Agenten-Orchestrierungsschleife mit Tool-Dispatch, Prompt-Konstruktion, Nachrichtenklassifizierung und Speicherladung.
• Sitzungsmodell mit Durchsetzung von Sicherheitsrichtlinien, Autonomiestufen und Genehmigungsgating.
• Resiliente Provider-Wrapper mit Failover, Retry und Modell-Routing über 20+ LLM-Backends.

Kanäle: WhatsApp (nativ), Telegram, Slack, Discord, Signal, iMessage, Matrix, IRC, Email, Bluesky, DingTalk, Lark, Mattermost, Nextcloud Talk, Nostr, QQ, Reddit, LinkedIn, Twitter, MQTT, WeChat Work, WATI, Mochat, Linq, Notion, WebSocket, ClawdTalk.

Feature-gated: Matrix (channel-matrix), Lark (channel-lark), Nostr (channel-nostr).

React 19 + Vite 6 + Tailwind CSS 4 Web-Dashboard, direkt vom Gateway bereitgestellt:

• Dashboard — Systemübersicht, Gesundheitsstatus, Betriebszeit, Kostenverfolgung
• Agenten-Chat — interaktiver Chat mit dem Agenten
• Speicher — Speichereinträge durchsuchen und verwalten
• Konfiguration — Konfiguration anzeigen und bearbeiten
• Cron — geplante Aufgaben verwalten
• Tools — verfügbare Tools durchsuchen
• Logs — Aktivitätsprotokolle des Agenten anzeigen
• Kosten — Token-Nutzung und Kostenverfolgung
• Doctor — Systemdiagnose
• Integrationen — Integrationsstatus und Einrichtung
• Pairing — Gerätekopplung verwalten

• Core: Shell, Datei lesen/schreiben/bearbeiten, Git-Operationen, Glob-Suche, Inhaltssuche
• Web: Browser-Steuerung, Web Fetch, Web Search, Screenshot, Bildinformation, PDF-Lesen
• Integrationen: Jira, Notion, Google Workspace, Microsoft 365, LinkedIn, Composio, Pushover
• MCP: Model Context Protocol Tool-Wrapper + verzögerte Tool-Sets
• Planung: cron add/remove/update/run, Planungstool
• Speicher: recall, store, forget, knowledge, project intel
• Erweitert: delegate (Agent-zu-Agent), swarm, Modellwechsel/-routing, Sicherheitsoperationen, Cloud-Operationen
• Hardware: board info, memory map, memory read (feature-gated)

• Autonomiestufen: ReadOnly, Supervised (Standard), Full.
• Sandboxing: Workspace-Isolation, Pfad-Traversal-Blockierung, Befehls-Allowlists, verbotene Pfade, Landlock (Linux), Bubblewrap.
• Ratenbegrenzung: max. Aktionen pro Stunde, max. Kosten pro Tag (konfigurierbar).
• Genehmigungsgating: interaktive Genehmigung für Operationen mit mittlerem/hohem Risiko.
• Notfall-Stopp: Notabschaltungsfähigkeit.
• 129+ Sicherheitstests in automatisiertem CI.

• Web-Dashboard direkt vom Gateway bereitgestellt.
• Tunnel-Unterstützung: Cloudflare, Tailscale, ngrok, OpenVPN, benutzerdefinierter Befehl.
• Docker-Laufzeitadapter für containerisierte Ausführung.
• CI/CD: beta (automatisch bei Push) → stable (manueller Dispatch) → Docker, crates.io, Scoop, AUR, Homebrew, Tweet.
• Vorgefertigte Binaries für Linux (x86_64, aarch64, armv7), macOS (x86_64, aarch64), Windows (x86_64).

Minimale ~/.zeroclaw/config.toml:

default_provider = "anthropic"
api_key = "sk-ant-..."

Vollständige Konfigurationsreferenz: docs/reference/api/config-reference.md.

Telegram:

[channels.telegram]
bot_token = "123456:ABC-DEF..."

Discord:

[channels.discord]
token = "your-bot-token"

Slack:

[channels.slack]
bot_token = "xoxb-..."
app_token = "xapp-..."

WhatsApp:

[channels.whatsapp]
enabled = true

Matrix:

[channels.matrix]
homeserver_url = "https://matrix.org"
username = "@bot:matrix.org"
password = "..."

Signal:

[channels.signal]
phone_number = "+1234567890"

[tunnel]
kind = "cloudflare"  # oder "tailscale", "ngrok", "openvpn", "custom", "none"

Details: Kanal-Referenz · Konfigurationsreferenz

• native (Standard) — direkte Prozessausführung, schnellster Pfad, ideal für vertrauenswürdige Umgebungen.
• docker — vollständige Container-Isolation, erzwungene Sicherheitsrichtlinien, erfordert Docker.

Setze runtime.kind = "docker" für striktes Sandboxing oder Netzwerkisolation.

ZeroClaw unterstützt native Abonnement-Authentifizierungsprofile (Multi-Account, verschlüsselt im Ruhezustand).

• Speicherdatei: ~/.zeroclaw/auth-profiles.json
• Verschlüsselungsschlüssel: ~/.zeroclaw/.secret_key
• Profil-ID-Format: <provider>:<profile_name> (Beispiel: openai-codex:work)

# OpenAI Codex OAuth (ChatGPT-Abonnement)
zeroclaw auth login --provider openai-codex --device-code

# Gemini OAuth
zeroclaw auth login --provider gemini --profile default

# Anthropic setup-token
zeroclaw auth paste-token --provider anthropic --profile default --auth-kind authorization

# Prüfen / aktualisieren / Profil wechseln
zeroclaw auth status
zeroclaw auth refresh --provider openai-codex --profile default
zeroclaw auth use --provider openai-codex --profile work

# Agenten mit Abonnement-Auth ausführen
zeroclaw agent --provider openai-codex -m "hello"
zeroclaw agent --provider anthropic -m "hello"

Workspace-Root: ~/.zeroclaw/workspace/ (konfigurierbar über Config).

Injizierte Prompt-Dateien:

• IDENTITY.md — Persönlichkeit und Rolle des Agenten
• USER.md — Benutzerkontext und Präferenzen
• MEMORY.md — Langzeitfakten und Lektionen
• AGENTS.md — Sitzungskonventionen und Initialisierungsregeln
• SOUL.md — Kernidentität und Betriebsprinzipien

Skills: ~/.zeroclaw/workspace/skills/<skill>/SKILL.md oder SKILL.toml.

# Installierte Skills auflisten
zeroclaw skills list

# Von Git installieren
zeroclaw skills install https://github.com/user/my-skill.git

# Sicherheitsaudit vor der Installation
zeroclaw skills audit https://github.com/user/my-skill.git

# Einen Skill entfernen
zeroclaw skills remove my-skill

# Workspace-Verwaltung
zeroclaw onboard              # Geführter Einrichtungsassistent
zeroclaw status               # Daemon/Agenten-Status anzeigen
zeroclaw doctor               # Systemdiagnose ausführen

# Gateway + Daemon
zeroclaw gateway              # Gateway-Server starten (127.0.0.1:42617)
zeroclaw daemon               # Vollständige autonome Laufzeit starten

# Agent
zeroclaw agent                # Interaktiver Chat-Modus
zeroclaw agent -m "message"   # Einzelnachrichten-Modus

# Service-Verwaltung
zeroclaw service install      # Als OS-Dienst installieren (launchd/systemd)
zeroclaw service start|stop|restart|status

# Kanäle
zeroclaw channel list         # Konfigurierte Kanäle auflisten
zeroclaw channel doctor       # Kanalgesundheit prüfen
zeroclaw channel bind-telegram 123456789

# Cron + Planung
zeroclaw cron list            # Geplante Aufgaben auflisten
zeroclaw cron add "*/5 * * * *" --prompt "Check system health"
zeroclaw cron remove <id>

# Speicher
zeroclaw memory list          # Speichereinträge auflisten
zeroclaw memory get <key>     # Speicher abrufen
zeroclaw memory stats         # Speicherstatistiken

# Auth-Profile
zeroclaw auth login --provider <name>
zeroclaw auth status
zeroclaw auth use --provider <name> --profile <profile>

# Hardware-Peripherie
zeroclaw hardware discover    # Angeschlossene Geräte scannen
zeroclaw peripheral list      # Angeschlossene Peripherie auflisten
zeroclaw peripheral flash     # Firmware auf Gerät flashen

# Migration
zeroclaw migrate openclaw --dry-run
zeroclaw migrate openclaw

# Shell-Vervollständigung
source <(zeroclaw completions bash)
zeroclaw completions zsh > ~/.zfunc/_zeroclaw

Vollständige Befehlsreferenz: docs/reference/cli/commands-reference.md

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

./install.sh --prefer-prebuilt

./install.sh --prebuilt-only

Release-Assets werden veröffentlicht für:

• Linux: x86_64, aarch64, armv7
• macOS: x86_64, aarch64
• Windows: x86_64

Lade die neuesten Assets herunter von: https://github.com/zeroclaw-labs/zeroclaw/releases/latest

Verwende diese Ressourcen, wenn du den Onboarding-Prozess abgeschlossen hast und die tiefere Referenz benötigst.

• Starte mit dem Docs-Index für die Navigation und "was ist wo."
• Lies die Architekturübersicht für das vollständige Systemmodell.
• Verwende die Konfigurationsreferenz, wenn du jede Einstellung und jedes Beispiel brauchst.
• Betreibe das Gateway nach Buch mit dem Betriebs-Runbook.
• Folge ZeroClaw Onboard für eine geführte Einrichtung.
• Behebe häufige Fehler mit der Fehlerbehebungsanleitung.
• Überprüfe die Sicherheitshinweise, bevor du etwas exponierst.

• Dokumentations-Hub: docs/README.md
• Einheitliches Docs-TOC: docs/SUMMARY.md
• Befehlsreferenz: docs/reference/cli/commands-reference.md
• Konfigurationsreferenz: docs/reference/api/config-reference.md
• Provider-Referenz: docs/reference/api/providers-reference.md
• Kanal-Referenz: docs/reference/api/channels-reference.md
• Betriebs-Runbook: docs/ops/operations-runbook.md
• Fehlerbehebung: docs/ops/troubleshooting.md

• Beitragsleitfaden: CONTRIBUTING.md
• PR-Workflow-Richtlinie: docs/contributing/pr-workflow.md
• CI-Workflow-Leitfaden: docs/contributing/ci-map.md
• Reviewer-Handbuch: docs/contributing/reviewer-playbook.md
• Sicherheitsoffenlegungsrichtlinie: SECURITY.md
• Dokumentationsvorlage: docs/contributing/doc-template.md

• Netzwerk-Bereitstellungsleitfaden: docs/ops/network-deployment.md
• Proxy-Agent-Handbuch: docs/ops/proxy-agent-playbook.md
• Hardware-Leitfäden: docs/hardware/README.md

ZeroClaw wurde für den glatten Krebs 🦀 gebaut, einen schnellen und effizienten KI-Assistenten. Entwickelt von Argenis De La Rosa und der Community.

• zeroclawlabs.ai
• @zeroclawlabs

Wenn ZeroClaw bei deiner Arbeit hilft und du die laufende Entwicklung unterstützen möchtest, kannst du hier spenden:

Ein herzliches Dankeschön an die Communitys und Institutionen, die diese Open-Source-Arbeit inspirieren und antreiben:

• Harvard University — für die Förderung intellektueller Neugier und das Verschieben der Grenzen des Möglichen.
• MIT — für den Einsatz für offenes Wissen, Open Source und den Glauben, dass Technologie für alle zugänglich sein sollte.
• Sundai Club — für die Community, die Energie und den unermüdlichen Antrieb, Dinge zu bauen, die wichtig sind.
• Die Welt und darüber hinaus 🌍✨ — an jeden Mitwirkenden, Träumer und Erbauer, der Open Source zu einer Kraft für das Gute macht. Das ist für dich.

Wir bauen offen, weil die besten Ideen von überall kommen. Wenn du das hier liest, bist du Teil davon. Willkommen. 🦀❤️

Neu bei ZeroClaw? Suche nach Issues mit dem Label good first issue — siehe unseren Beitragsleitfaden für den Einstieg. KI-/Vibe-coded PRs willkommen! 🤖

Siehe CONTRIBUTING.md und CLA.md. Implementiere einen Trait, reiche einen PR ein:

• CI-Workflow-Leitfaden: docs/contributing/ci-map.md
• Neuer Provider → src/providers/
• Neuer Channel → src/channels/
• Neuer Observer → src/observability/
• Neues Tool → src/tools/
• Neuer Memory → src/memory/
• Neuer Tunnel → src/tunnel/
• Neues Peripheral → src/peripherals/
• Neuer Skill → ~/.zeroclaw/workspace/skills/<name>/

Dies ist das einzige offizielle ZeroClaw-Repository:

https://github.com/zeroclaw-labs/zeroclaw

Jedes andere Repository, jede Organisation, Domain oder jedes Paket, das behauptet, "ZeroClaw" zu sein oder eine Zugehörigkeit zu ZeroClaw Labs impliziert, ist nicht autorisiert und nicht mit diesem Projekt verbunden. Bekannte nicht autorisierte Forks werden in TRADEMARK.md aufgelistet.

Wenn du auf Identitätsdiebstahl oder Markenrechtsmissbrauch stößt, eröffne bitte ein Issue.

ZeroClaw ist doppelt lizenziert für maximale Offenheit und Schutz der Mitwirkenden:

Du kannst eine der beiden Lizenzen wählen. Mitwirkende gewähren automatisch Rechte unter beiden — siehe CLA.md für die vollständige Mitwirkendenvereinbarung.

Der ZeroClaw-Name und das Logo sind Marken von ZeroClaw Labs. Diese Lizenz gewährt keine Erlaubnis, sie zu verwenden, um Unterstützung oder Zugehörigkeit zu implizieren. Siehe TRADEMARK.md für erlaubte und verbotene Verwendungen.

• Du behältst das Urheberrecht deiner Beiträge
• Patentgewährung (Apache 2.0) schützt dich vor Patentansprüchen anderer Mitwirkender
• Deine Beiträge werden dauerhaft in der Commit-Historie und NOTICE zugeordnet
• Keine Markenrechte werden durch Beiträge übertragen

ZeroClaw — Null Overhead. Null Kompromisse. Überall bereitstellen. Alles austauschen. 🦀

Diese Liste wird aus dem GitHub-Mitwirkendengraph generiert und aktualisiert sich automatisch.