campaign Aankondigingen

info Introductie

ZeroClaw is een snelle, kleine, volledig autonome AI-assistent-infrastructuur gebouwd in Rust. Eén statische binary draait op hardware van €10 met <5MB RAM — 99% minder geheugen dan Node-gebaseerde alternatieven. Elk subsysteem is een trait: wissel providers, kanalen, tools, geheugenbackends en tunnels met een configuratiewijziging.

download Installatie

ZeroClaw wordt geleverd als één Rust binary. Installeer via Homebrew, bootstrap-script of handmatige broncode-build.

Homebrew (macOS / Linuxbrew)

# macOS / Linuxbrew
brew install zeroclaw

One-Click Bootstrap (Aanbevolen)

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

# With system deps + Rust install on fresh machines
./bootstrap.sh --install-system-deps --install-rust

# With onboarding in the same flow
./bootstrap.sh --onboard --api-key "sk-..." --provider openrouter

# Remote one-liner
curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash

Handmatige Build & Installatie

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
cargo build --release --locked
cargo install --path . --force --locked

# Ensure ~/.cargo/bin is in PATH
export PATH="$HOME/.cargo/bin:$PATH"

Dev-fallback: gebruik 'cargo run --release --' als prefix voor commando's om globale installatie over te slaan.

rocket_launch Snel Starten

Voer onboarding eenmalig uit om je configuratie in te stellen, en begin dan met chatten.

# Interactive onboarding wizard
zeroclaw onboard --interactive

# Or quick setup (no prompts)
zeroclaw onboard --api-key sk-... --provider openrouter --model "openrouter/auto"

# Quickly repair channels/allowlists only
zeroclaw onboard --channels-only

# Chat with the agent
zeroclaw agent -m "Hello, ZeroClaw!"

# Interactive mode
zeroclaw agent

# Start gateway + daemon
zeroclaw gateway
zeroclaw daemon

# Check status
zeroclaw status
zeroclaw doctor
zeroclaw channel doctor

# Bind Telegram identity into allowlist
zeroclaw channel bind-telegram 123456789

# Service + migration helpers
zeroclaw service install
zeroclaw config schema
zeroclaw migrate openclaw --dry-run
zeroclaw migrate openclaw

Configuratielocatie: ~/.zeroclaw/config.toml — automatisch aangemaakt door zeroclaw onboard.

terminal Commando's

ZeroClaw is één binary met subcommando's voor elke workflow.

smart_toy Agent-modus

Het zeroclaw agent commando draait een AI-assistent die tools kan gebruiken, geheugen kan oproepen en taken kan uitvoeren.

# Single message
zeroclaw agent -m "List files in the current directory"

# Interactive REPL
zeroclaw agent

# Use a specific provider/model
zeroclaw agent --provider anthropic --model claude-sonnet-4-6 -m "Hello"

# Use a subscription auth profile
zeroclaw agent --provider openai-codex --auth-profile openai-codex:work -m "Hello"

dns Gateway & Daemon

De gateway biedt een webhookserver voor kanaalintegraties. De daemon draait de volledige autonome runtime inclusief heartbeat, cron en kanalen.

# Start the gateway (webhook server, default 127.0.0.1:3000)
zeroclaw gateway
zeroclaw gateway --port 0        # random port (security hardened)

# Start full autonomous runtime
zeroclaw daemon

# Manage as a background service
zeroclaw service install
zeroclaw service status

forum Kanalen

Kanalen laten ZeroClaw berichten ontvangen en beantwoorden van Telegram, Discord, Slack, Mattermost, iMessage, Matrix, Signal, WhatsApp, E-mail, IRC, Lark, DingTalk en meer. Alle kanalen gebruiken een deny-by-default allowlist.

# Telegram
[channels_config.telegram]
bot_token = "123456:ABC..."
allowed_users = ["your_username"]   # or ["*"] for all

# Discord
[channels_config.discord]
bot_token = "..."
allowed_users = ["your-discord-id"]

# Slack
[channels_config.slack]
bot_token = "xoxb-..."
allowed_users = ["UMEMBERID"]

# Start channels via daemon
zeroclaw daemon

Tip: Voer zeroclaw onboard --channels-only uit om kanalen te herconfigureren zonder andere instellingen aan te raken.

build Tools

Tools zijn mogelijkheden die de agent kan aanroepen tijdens een gesprek. Alle ingebouwde tools zijn standaard gesandboxed en workspace-scoped.

# Built-in tools:
# shell, file_read, file_write, memory, cron,
# git, http_request, browser (opt-in), composio (opt-in),
# delegate, hardware, screenshot, pushover

# Enable browser tools
[browser]
enabled = true
allowed_domains = ["docs.rs", "github.com"]

# Enable Composio (1000+ OAuth integrations)
[composio]
enabled = true
api_key = "cmp_..."

database Geheugensysteem

Volledige zoekengine zonder externe dependencies — geen Pinecone, geen Elasticsearch, geen LangChain.

[memory]
backend = "sqlite"             # sqlite | lucid | postgres | markdown | none
auto_save = true
embedding_provider = "none"    # none | openai | custom:https://...
vector_weight = 0.7
keyword_weight = 0.3

# PostgreSQL remote backend
# [storage.provider.config]
# provider = "postgres"
# db_url = "postgres://user:pass@host:5432/zeroclaw"

settings Configuratiebestand

Configuratie staat in ~/.zeroclaw/config.toml — aangemaakt door zeroclaw onboard.

api_key = "sk-..."
default_provider = "openrouter"
default_model = "anthropic/claude-sonnet-4-6"
default_temperature = 0.7

[memory]
backend = "sqlite"
auto_save = true

[gateway]
port = 3000
host = "127.0.0.1"
require_pairing = true
allow_public_bind = false

[autonomy]
level = "supervised"
workspace_only = true
allowed_commands = ["git", "npm", "cargo", "ls", "cat", "grep"]

[runtime]
kind = "native"

[tunnel]
provider = "none"

[secrets]
encrypt = true

model_training AI-providers

ZeroClaw ondersteunt 28+ ingebouwde providers plus elk OpenAI-compatibel of Anthropic-compatibel aangepast endpoint.

Voer zeroclaw providers uit om alle beschikbare providers en aliassen weer te geven.

key Omgevingsvariabelen

Provider API-keys en optionele overrides.

# Provider API keys
OPENROUTER_API_KEY=sk-or-v1-...
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...

# Lucid memory backend
ZEROCLAW_LUCID_CMD=/usr/local/bin/lucid
ZEROCLAW_LUCID_BUDGET=200

# Ollama remote endpoint
OLLAMA_API_KEY=your-key

shield Beveiliging

ZeroClaw dwingt beveiliging af op elke laag en voldoet aan alle items van de community-beveiligingschecklist.

[gateway]
require_pairing = true
allow_public_bind = false   # refuse 0.0.0.0 without tunnel

[autonomy]
workspace_only = true       # scoped to workspace by default

account_tree Architectuur

Elk subsysteem is een Rust trait — wissel implementaties met een configuratiewijziging, geen codewijzigingen.

runtime.kind = "native" en "docker" worden vandaag ondersteund. WASM/edge runtimes zijn gepland.

api Gateway API

Minimale HTTP API voor kanaalintegraties en health checks.

# Health check (no auth required)
curl http://127.0.0.1:3000/health

# Exchange pairing code for bearer token
curl -X POST http://127.0.0.1:3000/pair \
  -H "X-Pairing-Code: 847291"

# Send a message (requires bearer token)
curl -X POST http://127.0.0.1:3000/webhook \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello, ZeroClaw!"}'

lock Auth & Koppeling

Abonnement-native auth-profielen (multi-account, versleuteld at rest) voor OpenAI Codex en Anthropic.

# OpenAI Codex (device code — recommended for servers)
zeroclaw auth login --provider openai-codex --device-code

# Browser/callback flow
zeroclaw auth login --provider openai-codex --profile default

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

# Check / refresh / switch profile
zeroclaw auth status
zeroclaw auth refresh --provider openai-codex --profile default
zeroclaw auth use --provider openai-codex --profile work

code Ontwikkeling

Standaard Rust-workflow. Een pre-push git hook draait automatisch fmt + clippy + test.

# Dev build
cargo build

# Release build (works on all devices including Raspberry Pi)
cargo build --release

# Run tests
cargo test

# Lint
cargo clippy --locked --all-targets -- -D clippy::correctness

# Format
cargo fmt

# Enable pre-push hook (fmt + clippy + test)
git config core.hooksPath .githooks

menu_book Docs Hub

Voor taakgerichte documentatie, begin bij de docs hub in de officiële repository.

brew install zeroclaw && zeroclaw onboard --interactive