Cara Deploy PicoClaw di Linux
Versi Ringan untuk Edge Device dan Mini Server

🐾 Apa itu PicoClaw?

PicoClaw adalah AI agent infrastructure yang dibangun dengan Go (Golang) — bahasa yang dikenal karena kemudahan deployment, kompilasi cepat, dan binary yang compact. PicoClaw dirancang khusus untuk edge computing: hardware murah, koneksi tidak stabil, dan resource yang sangat terbatas.

Dengan 17.500+ GitHub stars dan tag line "Pico resources. Pico price. Nano intelligence.", PicoClaw sudah dipakai untuk deploy AI agent di board Linux seharga $10 — dari LicheeRV-Nano hingga Raspberry Pi Zero 2W.

PicoClaw mendukung fitur lengkap sebuah AI agent production:

🐹 Kenapa Go untuk Edge AI Agent?

🔧 Target Hardware yang Kompatibel

🛠️ Persiapan Server atau Device

# Untuk VPS Linux (Ubuntu/Debian)
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git make

# Verifikasi koneksi
curl -fsSL https://api.openrouter.ai/api/v1/models -o /dev/null && echo "Koneksi OK"

📦 Install via Binary Pre-built

# Untuk Linux x86_64 (VPS biasa)
curl -fsSLO https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw-linux-amd64.tar.gz
tar xzf picoclaw-linux-amd64.tar.gz
sudo install -m 0755 picoclaw /usr/local/bin/picoclaw

# Untuk Linux ARM64 (Raspberry Pi 4/5, AWS Graviton)
curl -fsSLO https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw-linux-arm64.tar.gz
tar xzf picoclaw-linux-arm64.tar.gz
sudo install -m 0755 picoclaw /usr/local/bin/picoclaw

# Untuk Linux ARMv7 (Raspberry Pi 2/3, Orange Pi)
curl -fsSLO https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw-linux-armv7.tar.gz
tar xzf picoclaw-linux-armv7.tar.gz
sudo install -m 0755 picoclaw /usr/local/bin/picoclaw

# Untuk RISC-V64 (LicheeRV-Nano)
curl -fsSLO https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw-linux-riscv64.tar.gz
tar xzf picoclaw-linux-riscv64.tar.gz
sudo install -m 0755 picoclaw /usr/local/bin/picoclaw

# Verifikasi
picoclaw --version

Script Auto-Detect Arsitektur

ARCH=$(uname -m)
case $ARCH in
  x86_64)  GOARCH="amd64" ;;
  aarch64) GOARCH="arm64" ;;
  armv7l)  GOARCH="armv7" ;;
  riscv64) GOARCH="riscv64" ;;
  *) echo "Arsitektur tidak dikenal: $ARCH"; exit 1 ;;
esac

curl -fsSLO "https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw-linux-${GOARCH}.tar.gz"
tar xzf "picoclaw-linux-${GOARCH}.tar.gz"
sudo install -m 0755 picoclaw /usr/local/bin/picoclaw
picoclaw --version

🐹 Build dari Source Code (Go)

Install Go 1.23+

GO_VER="1.23.0"
ARCH=$(uname -m | sed 's/x86_64/amd64/' | sed 's/aarch64/arm64/')
curl -fsSLO "https://go.dev/dl/go${GO_VER}.linux-${ARCH}.tar.gz"
sudo tar -C /usr/local -xzf "go${GO_VER}.linux-${ARCH}.tar.gz"
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
source ~/.bashrc
go version

Clone dan Build PicoClaw

git clone https://github.com/sipeed/picoclaw.git
cd picoclaw

# Build untuk arsitektur saat ini
make build

# Cross-compile untuk ARM64 (dari laptop x86)
GOOS=linux GOARCH=arm64 make build

# Cross-compile untuk RISC-V64 (LicheeRV-Nano)
GOOS=linux GOARCH=riscv64 make build

# Binary ada di ./bin/picoclaw
ls -lh bin/picoclaw

# Install
sudo make install
# atau manual: sudo install -m 0755 bin/picoclaw /usr/local/bin/picoclaw

⚙️ Setup Onboarding PicoClaw

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

# Atau dengan Ollama (offline, untuk edge device tanpa internet)
picoclaw onboard --provider ollama --api-base http://localhost:11434

# Mode interaktif
picoclaw onboard

# Verifikasi setup
picoclaw status
picoclaw doctor

📄 Konfigurasi JSON PicoClaw

Konfigurasi tersimpan di ~/.picoclaw/config.json:

{
  "default_provider": "openrouter",
  "default_temperature": 0.7,
  "models": {
    "providers": {
      "openrouter": { "api_key": "sk-or-..." },
      "ollama": {
        "api_base": "http://localhost:11434",
        "default_model": "llama3.2:3b"
      }
    },
    "model_list": [
      { "provider": "openrouter", "model": "anthropic/claude-sonnet-4", "alias": "primary" },
      { "provider": "ollama", "model": "llama3.2:3b", "alias": "offline" }
    ]
  },
  "agents": {
    "defaults": {
      "model": { "primary": "primary", "fallback": "offline" },
      "heartbeat": { "every": "30m" }
    }
  },
  "gateway": {
    "port": 8420,
    "require_pairing": true,
    "allow_public_bind": false
  },
  "autonomy": {
    "level": "supervised",
    "workspace_only": true,
    "max_actions_per_hour": 20
  },
  "hardware": {
    "platform": "auto",
    "low_power_mode": false,
    "throttle_on_thermal": true
  },
  "secrets": { "encrypt": true }
}

🐋 Deploy via Docker Compose

# docker-compose.yml
version: '3.8'
services:
  picoclaw:
    image: ghcr.io/sipeed/picoclaw:latest
    container_name: picoclaw-agent
    restart: unless-stopped
    volumes:
      - ~/.picoclaw:/root/.picoclaw
    environment:
      - PICOCLAW_LOG_LEVEL=info
    ports:
      - "8420:8420"
    # Untuk edge device dengan platform ARM
    platform: linux/arm64

  # Opsional: jalankan Ollama untuk mode offline
  ollama:
    image: ollama/ollama:latest
    container_name: ollama
    restart: unless-stopped
    volumes:
      - ollama_data:/root/.ollama
    ports:
      - "11434:11434"

volumes:
  ollama_data:

# Jalankan dengan Docker Compose
docker compose up -d

# Cek status
docker compose ps

# Lihat log
docker compose logs -f picoclaw

📡 Setup Channel Komunikasi

Telegram

{
  "channels": {
    "telegram": {
      "accounts": {
        "main": {
          "bot_token": "123456789:ABCDEF",
          "allow_from": ["username_kamu"],
          "reply_in_private": true
        }
      }
    }
  }
}

WhatsApp (via WA-Bridge)

{
  "channels": {
    "whatsapp": {
      "accounts": {
        "main": {
          "bridge_url": "http://localhost:29318",
          "allow_from": ["+6281234567890"]
        }
      }
    }
  }
}

🔄 Install sebagai Background Service

# Install service systemd (user-level)
picoclaw service install
picoclaw service start
picoclaw service status

# Lihat log
journalctl --user -u picoclaw -f

# Untuk edge device dengan OpenRC (Alpine Linux):
sudo picoclaw service install
sudo rc-update add picoclaw default
sudo rc-service picoclaw start

🚀 PicoClaw di VPS SufaNet

Meskipun PicoClaw dirancang untuk edge device, menjalankannya di VPS tetap memberikan beberapa keuntungan penting: uptime 99.9%, koneksi internet stabil, dan kemudahan management via SSH. Untuk use case Telegram/Discord bot yang harus online 24/7, VPS adalah pilihan terbaik.

VPS Indonesia SufaNet dengan paket entry-level sudah lebih dari cukup untuk PicoClaw — bahkan bisa menjalankan PicoClaw bersama layanan lain seperti Nginx, MariaDB, atau aplikasi web ringan sekaligus, berkat konsumsi RAM yang minimal.

❓ FAQ PicoClaw

🎯 Kesimpulan

PicoClaw adalah pilihan terbaik ketika kamu perlu AI agent yang bisa deploy di hardware apa saja — dari VPS cloud hingga Raspberry Pi Zero di lantai pabrik. Single binary Go, cross-compile mudah, dan kemampuan offline menjadikannya solusi yang sangat fleksibel.

Dengan dukungan 22+ AI provider dan kemampuan fallback ke Ollama lokal, PicoClaw memberikan keandalan service level bahkan di kondisi jaringan yang tidak stabil. Inilah yang membedakannya dari agent lain dalam ekosistem ini.

Untuk deployment production yang butuh uptime tinggi, kombinasikan PicoClaw dengan VPS Indonesia SufaNet — infrastruktur handal dengan harga yang terjangkau untuk developer Indonesia.