安装
方式一：使用预编译二进制文件（推荐）
从 Releases 页面 下载对应平台的二进制文件。
| 平台 | 架构 | 文件名 |
|---|---|---|
| Linux | x86_64 | picoclaw-linux-amd64 |
| Linux | ARM64 | picoclaw-linux-arm64 |
| Linux | RISC-V | picoclaw-linux-riscv64 |
| macOS | x86_64 | picoclaw-darwin-amd64 |
| macOS | ARM64 (Apple Silicon) | picoclaw-darwin-arm64 |
# Linux ARM64 示例
wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw-linux-arm64
chmod +x picoclaw-linux-arm64
./picoclaw-linux-arm64 onboard
方式二：从源码构建
需要 Go 1.21+。
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
# 安装依赖
make deps
# 为当前平台构建
make build
# 为所有平台构建
make build-all
# 构建并安装到 PATH
make install
方式三：Docker Compose
无需本地安装，直接运行。
# 1. 克隆仓库
git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
# 2. 配置 API Key
cp config/config.example.json config/config.json
vim config/config.json
# 3. 构建并启动
docker compose --profile gateway up -d
# 4. 查看日志
docker compose logs -f picoclaw-gateway
# 5. 停止
docker compose --profile gateway down
Docker 网络配置
默认情况下，Gateway 监听 127.0.0.1。如需从外部访问，请在环境变量或 config.json 中设置 PICOCLAW_GATEWAY_HOST=0.0.0.0。
低成本硬件部署
PicoClaw 可以运行在几乎任何 Linux 设备上：
| 设备 | 价格 | 用途 |
|---|---|---|
| 荔枝派 RV-Nano E/W | ~$9.9 | 极简家庭助手 |
| NanoKVM | $30-50 | 自动化服务器运维 |
| MaixCAM | ~$50 | 智能监控 |