docs: update installation guide with v0.1.2 binaries

- Add VERSION variable for easy updates
- Update download links to match release naming (picoclaw_OS_arch)
- Add all supported platforms: Linux, macOS, Windows, FreeBSD
- Add one-liner install script for Linux/macOS
- Update all download examples to use tar.gz format

Generated with [Z.ai](https://z.ai/subscribe?ic=JGTYCX7ZO7)

Co-Authored-By: Z.ai GLM-5
This commit is contained in:
Kadic Mirzet 2026-02-21 17:49:56 +01:00
parent 7f913babb8
commit b1ac1d70e5

View file

@ -2,15 +2,21 @@
This guide covers installing PicoClaw on your system. Choose the method that best fits your needs. This guide covers installing PicoClaw on your system. Choose the method that best fits your needs.
> **Current Version:** `v0.1.2` — [View all releases](https://github.com/sipeed/picoclaw/releases)
## Quick Install ## Quick Install
Download the precompiled binary for your platform from the [Releases page](https://github.com/sipeed/picoclaw/releases). Download the precompiled binary for your platform from the [Releases page](https://github.com/sipeed/picoclaw/releases).
```bash ```bash
# Set version (update this when new versions are released)
VERSION="v0.1.2"
# Example: Download for Linux ARM64 # Example: Download for Linux ARM64
wget https://github.com/sipeed/picoclaw/releases/download/v0.1.1/picoclaw-linux-arm64 wget https://github.com/sipeed/picoclaw/releases/download/${VERSION}/picoclaw_Linux_arm64.tar.gz
chmod +x picoclaw-linux-arm64 tar -xzf picoclaw_Linux_arm64.tar.gz
./picoclaw-linux-arm64 onboard chmod +x picoclaw
./picoclaw onboard
``` ```
## Installation Methods ## Installation Methods
@ -19,22 +25,54 @@ chmod +x picoclaw-linux-arm64
The easiest way to get started. Download the appropriate binary for your platform: The easiest way to get started. Download the appropriate binary for your platform:
| Platform | Architecture | Binary Name | | Platform | Architecture | Download |
|----------|-------------|-------------| |----------|-------------|----------|
| Linux | x86_64 | `picoclaw-linux-amd64` | | **Linux** | x86_64 | `picoclaw_Linux_x86_64.tar.gz` |
| Linux | ARM64 | `picoclaw-linux-arm64` | | **Linux** | ARM64 | `picoclaw_Linux_arm64.tar.gz` |
| Linux | RISC-V | `picoclaw-linux-riscv64` | | **Linux** | ARMv6 | `picoclaw_Linux_armv6.tar.gz` |
| Linux | LoongArch | `picoclaw-linux-loong64` | | **Linux** | RISC-V 64 | `picoclaw_Linux_riscv64.tar.gz` |
| macOS | ARM64 (M1/M2/M3) | `picoclaw-darwin-arm64` | | **Linux** | MIPS64 | `picoclaw_Linux_mips64.tar.gz` |
| Windows | x86_64 | `picoclaw-windows-amd64.exe` | | **Linux** | s390x | `picoclaw_Linux_s390x.tar.gz` |
| **macOS** | ARM64 (M1/M2/M3/M4) | `picoclaw_Darwin_arm64.tar.gz` |
| **macOS** | x86_64 (Intel) | `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` |
**Download and install:**
```bash ```bash
# Download and make executable # Set version
wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw-linux-amd64 VERSION="v0.1.2"
chmod +x picoclaw-linux-amd64
# Download for your platform (example: Linux x86_64)
wget https://github.com/sipeed/picoclaw/releases/download/${VERSION}/picoclaw_Linux_x86_64.tar.gz
# Extract
tar -xzf picoclaw_Linux_x86_64.tar.gz
# Make executable
chmod +x picoclaw
# Move to PATH (optional) # Move to PATH (optional)
sudo mv picoclaw-linux-amd64 /usr/local/bin/picoclaw sudo mv picoclaw /usr/local/bin/
```
**One-liner install:**
```bash
# Linux/macOS - detect platform and install
VERSION="v0.1.2"
OS=$(uname -s)
ARCH=$(uname -m)
[ "$OS" = "Darwin" ] && OS="Darwin"
[ "$OS" = "Linux" ] && OS="Linux"
[ "$ARCH" = "x86_64" ] && ARCH="x86_64"
[ "$ARCH" = "aarch64" ] && ARCH="arm64"
wget -qO- https://github.com/sipeed/picoclaw/releases/download/${VERSION}/picoclaw_${OS}_${ARCH}.tar.gz | tar xz
sudo mv picoclaw /usr/local/bin/
``` ```
### Option 2: Build from Source ### Option 2: Build from Source
@ -112,15 +150,18 @@ Run PicoClaw on old Android phones using Termux.
# Install Termux from F-Droid or Google Play # Install Termux from F-Droid or Google Play
# Open Termux and run: # Open Termux and run:
VERSION="v0.1.2"
# Download binary # Download binary
wget https://github.com/sipeed/picoclaw/releases/download/v0.1.1/picoclaw-linux-arm64 wget https://github.com/sipeed/picoclaw/releases/download/${VERSION}/picoclaw_Linux_arm64.tar.gz
chmod +x picoclaw-linux-arm64 tar -xzf picoclaw_Linux_arm64.tar.gz
chmod +x picoclaw
# Install proot for chroot environment # Install proot for chroot environment
pkg install proot pkg install proot
# Initialize # Initialize
termux-chroot ./picoclaw-linux-arm64 onboard termux-chroot ./picoclaw onboard
``` ```
See [Termux Deployment](../deployment/termux.md) for more details. See [Termux Deployment](../deployment/termux.md) for more details.
@ -155,14 +196,15 @@ PicoClaw runs on a wide range of hardware:
| MaixCAM | $50 | AI camera | | MaixCAM | $50 | AI camera |
| NanoKVM | $30-100 | Server maintenance | | NanoKVM | $30-100 | Server maintenance |
| Android phones | Free (old) | Via Termux | | Android phones | Free (old) | Via Termux |
| macOS | $500+ | M1/M2/M3 native | | macOS | $500+ | M1/M2/M3/M4 native |
| FreeBSD servers | Varies | Server deployment |
## Troubleshooting ## Troubleshooting
### Permission denied ### Permission denied
```bash ```bash
chmod +x picoclaw-* chmod +x picoclaw
``` ```
### Command not found ### Command not found
@ -173,7 +215,7 @@ Make sure the binary is in your PATH:
export PATH="$PWD:$PATH" export PATH="$PWD:$PATH"
# Or move to a standard location # Or move to a standard location
sudo mv picoclaw-* /usr/local/bin/picoclaw sudo mv picoclaw /usr/local/bin/
``` ```
### Go version too old ### Go version too old