zeroclaw/docs/one-click-bootstrap.md

2.1 KiB

One-Click Bootstrap

This page defines the fastest supported path to install and initialize ZeroClaw.

Last verified: February 18, 2026.

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

What it does by default:

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

Dual-mode bootstrap

Default behavior is app-only (build/install ZeroClaw) and expects existing Rust toolchain.

For fresh machines, enable environment bootstrap explicitly:

./bootstrap.sh --install-system-deps --install-rust

Notes:

  • --install-system-deps installs compiler/build prerequisites (may require sudo).
  • --install-rust installs Rust via rustup when missing.

Option B: Remote one-liner

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

For high-security environments, prefer Option A so you can review the script before execution.

Legacy compatibility:

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

This legacy endpoint prefers forwarding to scripts/bootstrap.sh and falls back to legacy source install if unavailable in that revision.

If you run Option B outside a repository checkout, the bootstrap script automatically clones a temporary workspace, builds, installs, and then cleans it up.

Optional onboarding modes

Quick onboarding (non-interactive)

./bootstrap.sh --onboard --api-key "sk-..." --provider openrouter

Or with environment variables:

ZEROCLAW_API_KEY="sk-..." ZEROCLAW_PROVIDER="openrouter" ./bootstrap.sh --onboard

Interactive onboarding

./bootstrap.sh --interactive-onboard

Useful flags

  • --install-system-deps
  • --install-rust
  • --skip-build
  • --skip-install
  • --provider <id>

See all options:

./bootstrap.sh --help