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 this repo
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw

# 2. First run — auto-generates docker/data/config.json then exits
docker compose -f docker/docker-compose.yml --profile gateway up
# The container prints "First-run setup complete." and stops.

# 3. Set your API keys
vim docker/data/config.json   # Set provider API keys, bot tokens, etc.

# 4. Start
docker compose -f docker/docker-compose.yml --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.

# 5. Check logs
docker compose -f docker/docker-compose.yml logs -f picoclaw-gateway

# 6. Stop
docker compose -f docker/docker-compose.yml --profile gateway down

Docker: Agent Mode

# Ask a question
docker compose -f docker/docker-compose.yml run --rm picoclaw-agent -m "What is 2+2?"

# Interactive mode
docker compose -f docker/docker-compose.yml run --rm picoclaw-agent

Docker: Update

docker compose -f docker/docker-compose.yml pull
docker compose -f docker/docker-compose.yml --profile gateway up -d

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)

Next Steps

• Getting Started — configure and run your first chat
• Configuration — full configuration reference
• Chat Channels — connect to Telegram, Discord, and more