Your ultra-lightweight bot deserves professional cloud infrastructure. Deploy to managed hosting with zero maintenance overhead.
Comprehensive installation reference for deploying Pico Claw AI assistant on all supported platforms
This guide covers everything you need to install picoclaw on your system. Whether you're using a $10 RISC-V device or a traditional x86 machine, Pico Claw's lightweight architecture makes installation straightforward and fast.
Pico Claw's ultra-lightweight design means it runs on minimal hardware. Even a $10 RISC-V board can host a full-featured AI assistant.
Works on devices like LicheeRV Nano ($9.9)
Optimal performance with skills enabled
The fastest way to install picoclaw is using pre-compiled binaries. Download, verify, and run in minutes.
# Download Pico Claw binary
wget https://github.com/sipeed/picoclaw/releases/download/v0.0.1/picoclaw-riscv64
# Make executable
chmod +x picoclaw-riscv64
# Verify installation
./picoclaw-riscv64 --version# Download Pico Claw binary
wget https://github.com/sipeed/picoclaw/releases/download/v0.0.1/picoclaw-arm64
# Make executable
chmod +x picoclaw-arm64
# Verify installation
./picoclaw-arm64 --version# Download Pico Claw binary
wget https://github.com/sipeed/picoclaw/releases/download/v0.0.1/picoclaw-amd64
# Make executable
chmod +x picoclaw-amd64
# Verify installation
./picoclaw-amd64 --versionRun ./picoclaw --version to verify Pico Claw v0.0.1 is installed correctly.
Execute ./picoclaw --help to see available commands and configuration options.
Generate default config.yaml with ./picoclaw init before first run.
Building picoclaw from source gives you full control and the latest development features. Requires Go 1.21 or later.
# Download Go 1.21+
wget https://go.dev/dl/go1.21.0.linux-amd64.tar.gz
# Extract and install
sudo tar -C /usr/local -xzf go1.21.0.linux-amd64.tar.gz
# Add to PATH
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
source ~/.bashrc
# Verify Go installation
go versionFor RISC-V/ARM: Use architecture-specific Go binaries
# Clone Pico Claw repository
git clone https://github.com/sipeed/picoclaw.git
# Navigate to source directory
cd picoclaw
# Check out stable release
git checkout v0.0.1Use main branch for latest development version
# Build Pico Claw
go build -o picoclaw .
# Or build with optimizations
go build -ldflags="-s -w" -o picoclaw .
# Verify build
./picoclaw --versionBuild produces single ~8MB binary with no dependencies
GOARCH=riscv64 go build for cross-compilationGOARCH=arm64 for 64-bit ARM targets-ldflags="-s -w" to reduce binary size by 20-30%CGO_ENABLED=0 for fully static binaryDetailed setup instructions for popular hardware platforms running picoclaw.
Hardware: $9.9 RISC-V board with 256MB RAM
# SSH into LicheeRV Nano
ssh [email protected]
# Download Pico Claw
wget https://github.com/sipeed/picoclaw/releases/download/v0.0.1/picoclaw-riscv64
# Install to /usr/local/bin
sudo mv picoclaw-riscv64 /usr/local/bin/picoclaw
sudo chmod +x /usr/local/bin/picoclaw
# Create config directory
mkdir -p ~/.picoclaw
picoclaw initSee complete LicheeRV guide for detailed setup
Hardware: Pi Zero, Pi 3/4/5 (ARM64 mode)
# Update system
sudo apt update && sudo apt upgrade -y
# Download Pico Claw ARM binary
wget https://github.com/sipeed/picoclaw/releases/download/v0.0.1/picoclaw-arm64
# Install system-wide
sudo mv picoclaw-arm64 /usr/local/bin/picoclaw
sudo chmod +x /usr/local/bin/picoclaw
# Initialize configuration
picoclaw initPico Claw runs efficiently on Pi Zero with <10MB RAM usage
Hardware: Any Intel/AMD x86-64 system
# Download x86-64 binary
wget https://github.com/sipeed/picoclaw/releases/download/v0.0.1/picoclaw-amd64
# Install to system path
sudo mv picoclaw-amd64 /usr/local/bin/picoclaw
sudo chmod +x /usr/local/bin/picoclaw
# Create config
mkdir -p ~/.picoclaw
picoclaw initIdeal for development, testing, or production servers
Hardware: Remote KVM device with Pico Claw support
# Access NanoKVM shell
# Download appropriate binary (check arch)
uname -m # Check architecture
# Install Pico Claw
wget https://github.com/sipeed/picoclaw/releases/download/v0.0.1/picoclaw-riscv64
chmod +x picoclaw-riscv64
mv picoclaw-riscv64 /usr/local/bin/picoclaw
# Configure for remote management
picoclaw initEnable remote AI-powered KVM management
Complete your picoclaw installation with systemd service setup, auto-start configuration, and updates.
# Check Pico Claw version
picoclaw --version
# Display help
picoclaw --help
# Validate config
picoclaw config validate# Create service file
sudo nano /etc/systemd/system/picoclaw.service
# Service configuration:
[Unit]
Description=Pico Claw AI Assistant
After=network.target
[Service]
Type=simple
User=picoclaw
WorkingDirectory=/home/picoclaw
ExecStart=/usr/local/bin/picoclaw start
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target# Reload systemd
sudo systemctl daemon-reload
# Enable Pico Claw service
sudo systemctl enable picoclaw
# Start service
sudo systemctl start picoclaw
# Check status
sudo systemctl status picoclaw# Stop service
sudo systemctl stop picoclaw
# Download new version
wget https://github.com/sipeed/picoclaw/releases/download/vX.X.X/picoclaw-[arch]
# Replace binary
sudo mv picoclaw-[arch] /usr/local/bin/picoclaw
sudo chmod +x /usr/local/bin/picoclaw
# Restart service
sudo systemctl start picoclawPico Claw boots in <1 second on 600MHz+ CPUs, making it ideal for auto-start configurations.
Idle memory consumption <10MB RAM ensures picoclaw runs efficiently as a background service.
Systemd auto-restart ensures Pico Claw recovers automatically from any unexpected failures.
Solutions to common installation issues when setting up picoclaw on various platforms.
Symptoms: Permission denied or "cannot execute binary file"
# Fix permissions
chmod +x picoclaw
# Verify architecture
file picoclaw
uname -m
# Check execution
./picoclaw --versionEnsure binary architecture matches your system (RISC-V/ARM/x86)
Symptoms: Pico Claw crashes or fails to start
# Check available memory
free -m
# Monitor Pico Claw usage
top -p $(pgrep picoclaw)
# Reduce memory in config.yaml
max_memory: 8MB
persistent_memory: falsePico Claw requires minimum 64MB system RAM (uses <10MB)
Symptoms: "config.yaml not found" error
# Create default config
picoclaw init
# Specify config path
picoclaw start --config /path/to/config.yaml
# Check config location
picoclaw config pathDefault location: ~/.picoclaw/config.yaml
Symptoms: Go build errors or missing dependencies
# Update Go version
go version # Should be 1.21+
# Clear Go cache
go clean -cache -modcache
# Rebuild with verbose output
go build -v -o picoclaw .
# Check Go environment
go envPico Claw requires Go 1.21 or later to build from source
Join the Pico Claw community for installation support, troubleshooting assistance, and configuration help.