在低资源设备（树莓派、RISC-V、MIPS…

当你需要在 $10 硬件、<10MB 内存的 Linux 设备上运行支持多 LLM 提供商的单二进制 AI 助手时使用。

适用场景

解决思路

1. 从 GitHub releases 页面下载预编译二进制（如 picoclaw-linux-arm64），chmod +x 后运行 ./picoclaw-linux-arm64 onboard 初始化。
2. 从源码构建：git clone 仓库后执行 make deps 安装依赖，make build 构建当前平台，make build-all 构建所有平台；针对树莓派 Zero 2 W 32 位用 make build-linux-arm，64 位用 make build-linux-arm64，或用 make build-pi-zero 同时构建两者；make install 安装到系统 PATH。
3. 用 Docker Compose 部署：首次运行 docker compose -f docker/docker-compose.yml --profile gateway up 生成 docker/data/config.json 后退出，编辑该文件，再以 -d 后台启动，用 logs -f picoclaw-gateway 查看日志，用 down 停止。
4. Docker Web 控制台模式：docker compose -f docker/docker-compose.yml --profile launcher up -d，然后打开 http://localhost:18800。
5. Docker 一次性 Agent 模式：docker compose -f docker/docker-compose.yml run --rm picoclaw-agent -m "What is 2+2?" 单次提问，或去掉 -m 进入交互会话。
6. 若需从宿主机访问 gateway，设置 PICOCLAW_GATEWAY_HOST=0.0.0.0 环境变量或在 docker/data/config.json 中设置该项。
7. 在 Android Termux 上：pkg install wget proot，下载 picoclaw-linux-arm64，chmod +x，然后用 termux-chroot ./picoclaw-linux-arm64 onboard 运行。
8. 运行 picoclaw onboard 生成 ~/.picoclaw/config.json 起始配置。
9. 编辑 ~/.picoclaw/config.json，在 agents.defaults 中设置 workspace、model_name、max_tokens、temperature、max_tool_iterations。
10. 在 model_list 中配置模型条目，字段包括 model_name（别名）、model（带提供商前缀的模型 ID，如 openai/gpt-4o、anthropic/claude-sonnet-4-5、volcengine/ark-code-latest）、api_key（用 $ENV_VAR 引用环境变量）、api_base（可选，覆盖基础 URL）、request_timeout（可选，秒）。
11. 支持的提供商前缀：openai/（OpenAI 及兼容 API）、anthropic/（Anthropic Claude）、volcengine/（火山引擎 Ark）。
12. 配置 Web 搜索工具：在 tools.web 下启用 tavily 或 brave 并填入 api_key；Tavily 在 tavily.com 获取（每月 1000 次免费），Brave 在 brave.com/search/api 获取（每月 2000 次免费）；除非需要回退行为，否则一次只启用一个搜索提供商。
13. 运行方式：直接运行 picoclaw 进入交互聊天，picoclaw -m "..." 发送单条消息后退出，picoclaw -model <name> 覆盖默认模型，picoclaw -config <path> 使用自定义配置文件。
14. 极简 $10 设备配置：下载 RISC-V 或 ARM 二进制，onboard 后写入轻量配置（如 gpt-4o-mini、max_tokens 2048、temperature 0.5、max_tool_iterations 10、request_timeout 120）。
15. 全栈开发助手配置：workspace 指向项目目录，使用 claude-sonnet，max_tokens 8192，temperature 0.3，max_tool_iterations 30，request_timeout 600，并启用 tavily 搜索。
16. Docker 环境变量注入：创建 docker/docker-compose.override.yml，在 services.picoclaw-gateway.environment 中列出 OPENAI_API_KEY、ANTHROPIC_API_KEY、TAVILY_API_KEY、PICOCLAW_GATEWAY_HOST，然后 export 这些变量并用 -f 叠加两个 compose 文件启动。
17. Go 交叉编译特定目标：MIPS（OpenWRT 路由器）用 GOOS=linux GOARCH=mips GOMIPS=softfloat go build -o build/picoclaw-linux-mips ./cmd/picoclaw；32 位 ARM 用 GOOS=linux GOARCH=arm GOARM=7；RISC-V 64 位用 GOOS=linux GOARCH=riscv64。
18. 二进制无法执行时：用 file 检查架构，用 uname -m 核对（aarch64 对应 arm64，x86_64 对应 amd64），并 chmod +x 确保可执行权限。
19. Termux 报 Permission denied 时安装 proot 并用 termux-chroot 运行。
20. API key 不被识别时：不要在配置中写明文 sk-...，改用 $OPENAI_API_KEY 形式引用环境变量，并用 echo $OPENAI_API_KEY 确认已导出。
21. 若近期版本内存占用升到 10–20MB 且设备内存极低，可 git checkout v0.1.1 后 make build 固定到较早版本。
22. 依赖变更后重新构建：cd picoclaw && make deps && make build。

适用边界 · 注意事项

• 需要图形界面或桌面级交互体验的场景（PicoClaw 为单二进制 CLI/网关形态）。
• 设备内存极度受限且无法接受 10–20MB 占用、又不愿固定旧版本时。
• 没有可用 LLM 提供商 API key 或无法联网调用外部模型时。