Przewodnik instalacji

Uruchom ZeroClaw

Jeden binary w Rust, wiele ścieżek instalacji. Wybierz to, co ci pasuje.

checklist Wymagania systemowe

build Rust

Toolchain Rust (stable) przez rustup.rs — potrzebny tylko do budowania ze źródła

computer OS

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

memory RAM

Runtime: <5MB RAM. Budowanie ze źródła: 2GB+ RAM, zalecane 4GB

hard_drive Disk

Binary: ~8.8MB. Budowanie ze źródła: 6GB wolnego miejsca, zalecane 10GB

extension Optional

Opcjonalnie: Docker (do sandboxowanego runtime), Git (do budowania ze źródła)

wifi Network

Internet do wywołań API AI. Lokalne modele przez Ollama działają w pełni offline.

Jednoliniowe skrypty, które robią wszystko. Zalecane dla większości użytkowników.

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 Weryfikacja instalacji

Uruchom te komendy, żeby potwierdzić poprawną instalację ZeroClaw.

1
$ zeroclaw --version

Powinno wyświetlić zainstalowaną wersję. Działa w ~0.02s ze szczytowym zużyciem ~3.9MB pamięci.

2
$ zeroclaw doctor

Uruchamia diagnostykę systemu: wersja Rust, pliki konfiguracyjne, łączność z providerami, stan kanałów.

3
$ zeroclaw onboard --interactive

Interaktywny kreator konfiguracji kluczy API, wyboru providerów i ustawień kanałów.

settings Początkowa konfiguracja

Po instalacji kreator onboard przeprowadzi cię przez konfigurację. Oto co robi każdy krok.

1

Wybierz dostawcę AI

Wybierz z katalogu providerów: OpenAI, Anthropic, Google Gemini, xAI, Mistral, DeepSeek, OpenRouter (100+ modeli) lub dowolny endpoint kompatybilny z OpenAI, w tym Ollama dla modeli lokalnych.

2

Dodaj klucz API

Wklej klucz API. Klucze są przechowywane lokalnie w config.toml — nigdy nie są wysyłane nigdzie poza dostawcę AI. Uwierzytelnianie subskrypcyjne (OpenAI Codex, Anthropic) również obsługiwane z szyfrowanymi profilami.

3

Połącz kanał

Podłącz Telegram (wklej token bota), Discord (wklej token bota), Slack (aplikacja workspace), WhatsApp (kod QR) lub dowolny z 17+ obsługiwanych kanałów. Polityka allowlist deny-by-default.

4

Uruchom agenta

Uruchom 'zeroclaw agent -m "Cześć!"' do szybkiego testu, 'zeroclaw daemon' do pełnego autonomicznego runtime lub 'zeroclaw service install' do usługi w tle.

.env — Cała konfiguracja jest przechowywana w ~/.zeroclaw/config.toml. Edytuj bezpośrednio, żeby zmienić providerów, kanały, backendy pamięci, tunele i ustawienia bezpieczeństwa. Zobacz docs/reference/README.md po pełną referencję.

system_update_alt Aktualizacja ZeroClaw

Aktualizuj ZeroClaw, żeby mieć najnowsze funkcje, integracje i poprawki bezpieczeństwa.

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

Sprawdź changelog na github.com/zeroclaw-labs/zeroclaw/releases, żeby zobaczyć co nowego w każdej wersji.

build Rozwiązywanie problemów

Częste problemy i jak je naprawić.

Potrzebujesz pomocy?

Dołącz do naszej społeczności po wsparcie instalacji i rozwiązywanie problemów.

Bądź na bieżąco

Otrzymuj informacje o nowych wydaniach, integracjach i infrastrukturze agentów w Rust. Bez spamu, wypisanie w każdej chwili.