Cara Install NullClaw
untuk AI Agent Modular Berbasis CLI

🦴 Apa itu NullClaw?

NullClaw adalah AI agent infrastructure yang ditulis dalam bahasa Zig — bahasa sistem modern yang menghasilkan binary statis tanpa runtime dependency. Dengan binary berukuran hanya 678 KB dan konsumsi RAM sekitar 1 MB, NullClaw adalah solusi AI agent paling ringan yang tersedia saat ini.

Slogan NullClaw adalah "Null overhead. Null compromise. 100% Zig. 100% Agnostic." — dan ini bukan sekadar klaim marketing. Dengan 2.843 unit test, binary yang bisa jalan di hardware seharga $5, dan startup time kurang dari 2 milidetik, NullClaw benar-benar mendeliver performa ekstrem.

Meski sangat ringan, NullClaw tetap mendukung fitur lengkap:

📊 Benchmark: NullClaw vs Kompetitor

Berikut perbandingan performa berdasarkan benchmark yang dipublikasikan (macOS arm64, Feb 2026, dinormalisasi untuk edge hardware 0.8 GHz):

🛠️ Persiapan Server VPS

NullClaw sangat hemat resource. Bahkan VPS dengan 256 MB RAM pun bisa menjalankannya — meski untuk production tetap disarankan minimal 512 MB untuk kenyamanan:

# Update sistem
sudo apt update && sudo apt upgrade -y

# NullClaw adalah binary statis — tidak perlu install runtime apapun!
# Hanya butuh curl/wget untuk download binary

📦 Install via Pre-built Binary (Direkomendasikan)

Cara paling mudah install NullClaw adalah download binary yang sudah dikompilasi. NullClaw menyediakan binary untuk Linux x86_64, aarch64 (ARM64), dan armv7:

Untuk Linux x86_64 (Server VPS Umumnya)

# Download binary terbaru untuk x86_64
curl -fsSLO https://github.com/nullclaw/nullclaw/releases/latest/download/nullclaw-x86_64-unknown-linux-musl.tar.gz

# Extract
tar xzf nullclaw-x86_64-unknown-linux-musl.tar.gz

# Install ke PATH
sudo install -m 0755 nullclaw /usr/local/bin/nullclaw

# Verifikasi
nullclaw --version

Untuk Linux ARM64 (Raspberry Pi, ARM Server)

# Download binary aarch64
curl -fsSLO https://github.com/nullclaw/nullclaw/releases/latest/download/nullclaw-aarch64-unknown-linux-musl.tar.gz
tar xzf nullclaw-aarch64-unknown-linux-musl.tar.gz
sudo install -m 0755 nullclaw /usr/local/bin/nullclaw

Script Otomatis

# Script deteksi arsitektur otomatis
ARCH=$(uname -m)
case $ARCH in
  x86_64)  TRIPLE="x86_64-unknown-linux-musl" ;;
  aarch64) TRIPLE="aarch64-unknown-linux-musl" ;;
  armv7l)  TRIPLE="armv7-unknown-linux-musleabihf" ;;
  *) echo "Arsitektur tidak didukung: $ARCH"; exit 1 ;;
esac

curl -fsSLO "https://github.com/nullclaw/nullclaw/releases/latest/download/nullclaw-${TRIPLE}.tar.gz"
tar xzf "nullclaw-${TRIPLE}.tar.gz"
sudo install -m 0755 nullclaw /usr/local/bin/nullclaw
echo "NullClaw berhasil diinstall: $(nullclaw --version)"

🔨 Build dari Source Code (Zig)

Untuk mendapatkan binary yang paling optimal atau ingin berkontribusi ke NullClaw, kamu bisa build dari source. Perlu install Zig 0.15 terlebih dahulu:

# Download dan install Zig 0.15
ZIG_VER="0.15.0"
ZIG_ARCH=$(uname -m | sed 's/x86_64/x86_64/' | sed 's/aarch64/aarch64/')
curl -fsSLO "https://ziglang.org/download/${ZIG_VER}/zig-linux-${ZIG_ARCH}-${ZIG_VER}.tar.xz"
tar xJf "zig-linux-${ZIG_ARCH}-${ZIG_VER}.tar.xz"
sudo mv zig-linux-${ZIG_ARCH}-${ZIG_VER} /usr/local/zig
sudo ln -sf /usr/local/zig/zig /usr/local/bin/zig

# Verifikasi
zig version

# Clone dan build NullClaw
git clone https://github.com/nullclaw/nullclaw.git
cd nullclaw

# Build release kecil (678 KB)
zig build -Doptimize=ReleaseSmall

# Cek ukuran binary
ls -lh zig-out/bin/nullclaw

# Install
sudo install -m 0755 zig-out/bin/nullclaw /usr/local/bin/nullclaw

⚙️ Setup Onboarding NullClaw

Setelah binary terinstall, jalankan onboarding untuk setup konfigurasi awal:

# Quick setup dengan API key langsung
nullclaw onboard --api-key sk-or-... --provider openrouter

# Atau mode interaktif (direkomendasikan untuk pertama kali)
nullclaw onboard --interactive

# Cek status setelah setup
nullclaw status
nullclaw doctor

Konfigurasi tersimpan di ~/.nullclaw/config.json. Contoh konfigurasi minimal:

{
  "default_provider": "openrouter",
  "default_temperature": 0.7,
  "models": {
    "providers": {
      "openrouter": { "api_key": "sk-or-..." },
      "anthropic": { "api_key": "sk-ant-..." }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "anthropic/claude-sonnet-4" },
      "heartbeat": { "every": "30m" }
    }
  },
  "gateway": {
    "port": 3000,
    "require_pairing": true,
    "allow_public_bind": false
  },
  "autonomy": {
    "level": "supervised",
    "workspace_only": true,
    "max_actions_per_hour": 20
  },
  "secrets": { "encrypt": true }
}

Test Cepat

# Kirim pesan test
nullclaw agent -m "Halo NullClaw! Berapa ukuran binary-mu?"

# Mode interaktif
nullclaw agent

# Mulai gateway
nullclaw gateway

# Mulai daemon lengkap
nullclaw daemon

🏗️ Arsitektur Modular NullClaw

Salah satu keunggulan utama NullClaw adalah arsitektur berbasis vtable yang sepenuhnya modular. Setiap subsistem adalah interface yang bisa di-swap dengan implementasi lain hanya melalui perubahan konfigurasi:

Contoh swap implementasi melalui config saja (tanpa ubah kode):

# Ganti runtime ke Docker untuk sandbox yang lebih ketat
"runtime": {
  "kind": "docker",
  "docker": {
    "image": "alpine:3.20",
    "network": "none",
    "memory_limit_mb": 128,
    "read_only_rootfs": true
  }
}

# Aktifkan sandbox Landlock (Linux 5.13+)
"security": {
  "sandbox": { "backend": "landlock" },
  "secrets": { "encrypt": true }
}

📡 Setup Channel Komunikasi

Telegram

# Di ~/.nullclaw/config.json
"channels": {
  "telegram": {
    "accounts": {
      "main": {
        "bot_token": "123456:ABCDEF",
        "allow_from": ["username_kamu"],
        "reply_in_private": true
      }
    }
  }
}

IRC (Unik untuk NullClaw)

"channels": {
  "irc": {
    "accounts": {
      "main": {
        "host": "irc.libera.chat",
        "port": 6697,
        "nick": "nullclaw_bot",
        "channel": "#mychannel",
        "tls": true,
        "allow_from": ["username_irc_kamu"]
      }
    }
  }
}

Cek Status Channel

nullclaw channel doctor
nullclaw status

🔄 Install sebagai Background Service

# Install service systemd (user-level, tanpa sudo)
nullclaw service install
nullclaw service start
nullclaw service status

# Atau untuk Alpine Linux dengan OpenRC:
sudo nullclaw service install
sudo rc-update add nullclaw default
sudo rc-service nullclaw start

NullClaw secara otomatis mendeteksi init system yang tersedia (systemd atau OpenRC) dan menginstall service yang sesuai.

# Update NullClaw ke versi terbaru
curl -fsSLO https://github.com/nullclaw/nullclaw/releases/latest/download/nullclaw-x86_64-unknown-linux-musl.tar.gz
tar xzf nullclaw-x86_64-unknown-linux-musl.tar.gz
sudo install -m 0755 nullclaw /usr/local/bin/nullclaw
nullclaw service restart

🚀 VPS Ideal untuk NullClaw

NullClaw adalah solusi terbaik jika kamu mau memaksimalkan efisiensi resource. Di VPS dengan 512 MB RAM, NullClaw masih memiliki ratusan MB space untuk OS dan aktivitas lain — sesuatu yang tidak mungkin dengan OpenClaw (Node.js).

Untuk pengguna Indonesia, VPS Indonesia SufaNet dengan paket entry-level sudah sangat cukup untuk menjalankan NullClaw dengan full features — Telegram, Discord, dan beberapa channel lainnya secara bersamaan.

❓ FAQ NullClaw

🎯 Kesimpulan

NullClaw membuktikan bahwa AI agent yang powerful tidak harus berat dan mahal. Dengan binary 678 KB, RAM ~1 MB, dan startup kurang dari 2 milidetik, NullClaw adalah pilihan ideal untuk deployment di hardware minimal atau VPS entry-level.

Arsitektur modular berbasis vtable memastikan kamu bisa swap provider, channel, memory backend, dan sandbox tanpa mengubah kode — hanya konfigurasi. Ini memberikan fleksibilitas luar biasa untuk berbagai use case.

Mulai deploy NullClaw hari ini di VPS Indonesia SufaNet — server yang andal dengan harga yang bersahabat untuk developer Indonesia.