Install PicoClaw

Precompiled binary

Download the binary for your platform from the releases page. Current builds (v0.1.1):

Linux: amd64, arm64, riscv64
Windows: amd64
macOS: darwin-arm64 (Apple Silicon)

Rename the binary to picoclaw, make it executable (on Unix), and optionally move it to your PATH.

From source (recommended for development)

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

# Build only
make build

# Build for multiple platforms
make build-all

# Build and install
make install

Docker Compose

Run PicoClaw without installing Go or a local binary.

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

# Set API keys
cp config/config.example.json config/config.json
# Edit config/config.json

# Start gateway
docker compose --profile gateway up -d

# Logs
docker compose logs -f picoclaw-gateway

Agent mode (one-shot)

docker compose run --rm picoclaw-agent -m "What is 2+2?"

# Interactive
docker compose run --rm picoclaw-agent

Quick start (2 minutes)

Config file: ~/.picoclaw/config.json. Get API keys: OpenRouter (LLM), Zhipu (LLM). Web search is optional — Brave Search (2000 free/month) or built-in DuckDuckGo.

Initialize: picoclaw onboard
Edit ~/.picoclaw/config.json: set providers.openrouter.api_key (or zhipu, etc.) and optionally tools.web.
Chat: picoclaw agent -m "What is 2+2?"

Full configuration reference →

Configuration Troubleshooting