Panduan Install ZeroClaw
di VPS Ubuntu untuk Workflow Otomatisasi

⚡ Apa itu ZeroClaw?

ZeroClaw adalah AI agent infrastructure yang dibangun dengan Rust — bahasa sistem yang terkenal dengan performa, keamanan memori, dan zero-cost abstraction. ZeroClaw menggabungkan keandalan Rust dengan arsitektur trait-driven yang memungkinkan setiap komponen bisa diganti tanpa mengubah kode inti.

Dengan 16.400+ GitHub stars, ZeroClaw adalah salah satu AI agent paling populer di komunitas developer. Slogan-nya: "Zero config. Zero runtime. Infinite extensibility." — dan ini tercermin dalam desain yang dibuat untuk developer yang peduli pada performa dan keandalan.

🦀 Kenapa Rust untuk AI Agent?

Rust memberikan beberapa keunggulan kritis untuk AI agent infrastructure:

🛠️ Persiapan VPS Ubuntu

Untuk ZeroClaw, spesifikasi minimum sangat rendah berkat efisiensi Rust:

# Update dan install dependency
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git build-essential pkg-config libssl-dev

# Opsional: tambah swap jika RAM < 2GB
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

🚀 Install via bootstrap.sh (Paling Cepat)

Cara termudah dan tercepat install ZeroClaw adalah menggunakan script bootstrap yang sudah disediakan. Script ini akan mendeteksi OS, download binary pre-built, dan menginstallnya secara otomatis:

# Download dan jalankan bootstrap script
curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/bootstrap.sh | bash

# Script bootstrap akan:
# 1. Deteksi OS dan arsitektur
# 2. Download binary terbaru dari GitHub Releases
# 3. Install ke ~/.local/bin/zeroclaw
# 4. Update PATH di ~/.bashrc (atau ~/.zshrc)
# 5. Verifikasi instalasi

# Apply PATH changes
source ~/.bashrc

# Verifikasi
zeroclaw --version

Install Manual via Binary Pre-built

# Download binary langsung
curl -fsSLO https://github.com/zeroclaw-labs/zeroclaw/releases/latest/download/zeroclaw-x86_64-unknown-linux-gnu.tar.gz

# Extract
tar xzf zeroclaw-x86_64-unknown-linux-gnu.tar.gz

# Install global
sudo install -m 0755 zeroclaw /usr/local/bin/zeroclaw

# Verifikasi
zeroclaw --version

🦀 Build dari Source via Cargo

Untuk mendapatkan binary yang paling optimal atau ingin customize feature flags:

# Install Rust toolchain
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --default-toolchain stable
source $HOME/.cargo/env

# Verifikasi Rust
rustc --version && cargo --version

# Install ZeroClaw via cargo install (tanpa clone repo)
cargo install zeroclaw --locked

# Atau clone dan build manual
git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
cargo build --release

# Binary ada di target/release/zeroclaw
ls -lh target/release/zeroclaw

# Install ke PATH
sudo install -m 0755 target/release/zeroclaw /usr/local/bin/zeroclaw

⚙️ Setup Onboarding ZeroClaw

Setelah terinstall, jalankan wizard onboarding untuk konfigurasi awal:

# Onboarding dengan API key langsung (paling cepat)
zeroclaw onboard --api-key sk-or-v1-... --provider openrouter

# Atau pilih Anthropic
zeroclaw onboard --api-key sk-ant-... --provider anthropic

# Mode interaktif (panduan step-by-step)
zeroclaw onboard

# Cek status setup
zeroclaw status
zeroclaw doctor

📄 File Konfigurasi TOML

ZeroClaw menggunakan format TOML untuk konfigurasi — berbeda dari OpenClaw (JSON) dan Nanobot (JSON). TOML lebih mudah dibaca manusia dan mendukung komentar:

# ~/.zeroclaw/config.toml

# --- Provider AI ---
[models]
default_provider = "openrouter"
default_temperature = 0.7

[models.providers.openrouter]
api_key = "sk-or-v1-..."

[models.providers.anthropic]
api_key = "sk-ant-..."

# --- Agent defaults ---
[agents.defaults]
model.primary = "anthropic/claude-sonnet-4"
model.fallback = "openai/gpt-4o-mini"

[agents.defaults.heartbeat]
every = "30m"
model = "anthropic/claude-haiku-3-5"

# --- Gateway ---
[gateway]
port = 42617
require_pairing = true
allow_public_bind = false

# --- Autonomy ---
[autonomy]
level = "supervised"          # none | supervised | semi | auto
workspace_only = true
max_actions_per_hour = 30

# --- Security ---
[security.secrets]
encrypt = true

[security.sandbox]
backend = "auto"              # auto | landlock | firejail | docker | none

📡 Setup Channel Komunikasi

Telegram

# ~/.zeroclaw/config.toml
[channels.telegram.accounts.main]
bot_token = "123456789:ABCDEF"
allow_from = ["username_telegram_kamu"]
reply_in_private = true
parse_mode = "MarkdownV2"

Discord

[channels.discord.accounts.main]
bot_token = "Bot TOKEN_DISCORD"
guild_id = "1234567890"
allowed_channel_ids = ["987654321"]
allow_from = ["username#0001"]

Slack

[channels.slack.accounts.main]
bot_token = "xoxb-..."
app_token = "xapp-..."
signing_secret = "..."
allow_from = ["U12345678"]

Cek Status Channel

zeroclaw channel doctor
zeroclaw status

🔄 Jalankan sebagai Systemd Daemon

# Install service autostart (built-in command)
zeroclaw service install

# Aktifkan dan mulai
zeroclaw service start
zeroclaw service status

# Cek log
journalctl --user -u zeroclaw -f

# Restart service
zeroclaw service restart

# Stop service
zeroclaw service stop

Alternatif buat file service manual:

# Buat file systemd manual
mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/zeroclaw.service << 'EOF'
[Unit]
Description=ZeroClaw AI Agent
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/zeroclaw daemon
Restart=always
RestartSec=10
Environment=RUST_LOG=info

[Install]
WantedBy=default.target
EOF

# Enable dan start
systemctl --user enable zeroclaw
systemctl --user start zeroclaw
systemctl --user status zeroclaw

🔀 Migrasi dari OpenClaw ke ZeroClaw

ZeroClaw menyediakan tool migrasi built-in untuk pindah dari OpenClaw. Ini termasuk konversi konfigurasi JSON ke TOML dan migrasi database memori agent:

# 1. Backup OpenClaw config dulu
cp -r ~/.openclaw ~/.openclaw.backup

# 2. Jalankan perintah migrasi ZeroClaw
zeroclaw migrate openclaw

# Proses ini akan:
# - Konversi ~/.openclaw/openclaw.json ke ~/.zeroclaw/config.toml
# - Import memory database (jika ada)
# - Mapping channel config dari format OpenClaw

# 3. Verifikasi hasil migrasi
zeroclaw config validate
zeroclaw doctor

🚀 VPS Terbaik untuk ZeroClaw

ZeroClaw dengan RAM <5 MB membuatnya sangat fleksibel — bisa jalan di VPS paling entry-level. Namun untuk workflow otomatisasi production yang intensif (banyak channel, heartbeat aktif, banyak task agent), disarankan VPS dengan minimal 1 GB RAM.

VPS Indonesia SufaNet adalah pilihan ideal untuk developer Indonesia yang ingin menjalankan ZeroClaw dengan latensi rendah ke klien-klien lokal. Infrastruktur data center Indonesia menjamin respon cepat dan koneksi stabil.

❓ FAQ ZeroClaw

🎯 Kesimpulan

ZeroClaw menawarkan sweet spot yang unik: performa dan keamanan Rust, dengan fleksibilitas trait-driven architecture yang membuatnya sangat extensible. Config TOML yang manusiawi dan dukungan migrasi dari OpenClaw memudahkan transisi.

Dengan RAM <5 MB di runtime, ZeroClaw bisa jalan berdampingan dengan banyak service lain di VPS entry-level, sambil tetap memberikan performa AI agent class production. Ini adalah pilihan ideal untuk developer yang ingin workflow otomatisasi yang andal dan efisien.

Siap deploy? Mulai dengan VPS Indonesia SufaNet — pilihan paling ekonomis untuk AI agent infrastructure yang handal!