Installation
Option 1: Precompiled Binary (Recommended)β
Download the latest release from the Releases page. All releases are packaged as .tar.gz (Linux/macOS/FreeBSD) or .zip (Windows).
| Platform | Architecture | Download |
|---|---|---|
| π§ Linux | x86_64 | picoclaw_Linux_x86_64.tar.gz |
| π§ Linux | ARM64 | picoclaw_Linux_arm64.tar.gz |
| π§ Linux | ARMv6 (32-bit) | picoclaw_Linux_armv6.tar.gz |
| π§ Linux | RISC-V 64 | picoclaw_Linux_riscv64.tar.gz |
| π§ Linux | LoongArch64 | picoclaw_Linux_loong64.tar.gz |
| π macOS | ARM64 (Apple Silicon) | picoclaw_Darwin_arm64.tar.gz |
| π macOS | x86_64 | picoclaw_Darwin_x86_64.tar.gz |
| πͺ Windows | x86_64 | picoclaw_Windows_x86_64.zip |
| πͺ Windows | ARM64 | picoclaw_Windows_arm64.zip |
| π FreeBSD | x86_64 | picoclaw_Freebsd_x86_64.tar.gz |
| π FreeBSD | ARM64 | picoclaw_Freebsd_arm64.tar.gz |
| π FreeBSD | ARMv6 | picoclaw_Freebsd_armv6.tar.gz |
# Example for Linux ARM64
wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw_Linux_arm64.tar.gz
tar -xzf picoclaw_Linux_arm64.tar.gz
./picoclaw onboard
Option 2: Build from Sourceβ
Requires Go 1.21+.
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
# Install dependencies
make deps
# Build for current platform
make build
# Build for all platforms
make build-all
# Build and install to PATH
make install
The binary is placed in build/picoclaw-{platform}-{arch}.
Option 3: Docker Composeβ
Run PicoClaw without installing anything locally.
# 1. Clone the repo
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
# 2. Set your API keys
cp config/config.example.json config/config.json
vim config/config.json
# 3. Build and start
docker compose --profile gateway up -d
# 4. Check logs
docker compose logs -f picoclaw-gateway
# 5. Stop
docker compose --profile gateway down
Docker: Agent Modeβ
# One-shot chat
docker compose run --rm picoclaw-agent -m "What is 2+2?"
# Interactive mode
docker compose run --rm picoclaw-agent
Docker: Rebuildβ
docker compose --profile gateway build --no-cache
docker compose --profile gateway up -d
Docker Network
By default, the Gateway listens on 127.0.0.1. To expose it to the host, set PICOCLAW_GATEWAY_HOST=0.0.0.0 in your environment or config.json.
Innovative Low-Cost Hardwareβ
PicoClaw runs on almost any Linux device:
| Device | Price | Use Case |
|---|---|---|
| LicheeRV-Nano E/W | ~$9.9 | Minimal home assistant |
| NanoKVM | $30-50 | Automated server maintenance |
| MaixCAM | ~$50 | Smart monitoring |
| NanoKVM Pro | $80-120 | Full-featured KVM with AI assistant |
| MaixCAM2 | $80-120 | Next-gen 4K AI camera |
Raspberry Pi Compatibilityβ
| Model | Architecture | File | Recommended OS |
|---|---|---|---|
| Pi Zero / Zero W | ARMv6 (32-bit) | picoclaw_Linux_armv6.tar.gz | Raspberry Pi OS Lite (32-bit) |
| Pi Zero 2 W | ARM64 | picoclaw_Linux_arm64.tar.gz | Raspberry Pi OS Lite (64-bit) |
| Pi 1 (A/B/B+) | ARMv6 (32-bit) | picoclaw_Linux_armv6.tar.gz | Raspberry Pi OS Lite (32-bit) |
| Pi 3 A+/B/B+ | ARM64 | picoclaw_Linux_arm64.tar.gz | Raspberry Pi OS Lite (64-bit) |
| Pi 4 B | ARM64 | picoclaw_Linux_arm64.tar.gz | Raspberry Pi OS Lite (64-bit) |
| Pi 5 | ARM64 | picoclaw_Linux_arm64.tar.gz | Raspberry Pi OS Lite (64-bit) |
Pi 2 B uses ARMv7 which is not currently supported.
Next Stepsβ
- Getting Started β configure and run your first chat
- Configuration β full configuration reference
- Chat Channels β connect to Telegram, Discord, and more