Skip to main content

Installation

Download the binary for your platform from the Releases page.

PlatformArchitectureFile
Linuxx86_64picoclaw-linux-amd64
LinuxARM64picoclaw-linux-arm64
LinuxRISC-Vpicoclaw-linux-riscv64
macOSx86_64picoclaw-darwin-amd64
macOSARM64 (Apple Silicon)picoclaw-darwin-arm64
# Example for Linux ARM64
wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw-linux-arm64
chmod +x picoclaw-linux-arm64
./picoclaw-linux-arm64 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:

DevicePriceUse Case
LicheeRV-Nano E/W~$9.9Minimal home assistant
NanoKVM$30-50Automated server maintenance
MaixCAM~$50Smart monitoring

Next Steps​