PicoClaw：面向 <$10 硬件的超轻量级 Go AI 助手

介绍\n\n如果你一直在寻找一种可以放进口袋大小的板子甚至是一部旧 Android 手机的极小型高性能 AI 助手，PicoClaw 就是你的项目。完全用 Go 编写，PicoClaw 从零开始设计，既超高效又完全自主。它启动不到一秒，内存耗用不足 10 MB，可以在任何 <$10 的板子上运行，甚至可以改装成旧 Android 手机。\n\n--- \n\n## 什么让 PicoClaw 运转？\n\n| 特色 | 工作原理 | 重要性 |\n|------|--------|--------|\n| 超轻量级 | Go 运行时被压缩至必需部分，二进制文件 <10 MB。 | 适合微控制器和廉价 SBC。 |\n| 快速启动 | 零配置 Go init，静态链接，优化内存布局。 | 在 0.6 GHz 单核上 1 秒启动。 |\n| 硬件无关 | 原生支持 RISC‑V、ARM 与 x86。 | 可部署在 LicheeRV、NanoKVM、MaixCAM、Raspberry Pi 或任何 Linux SBC。 |\n| AI 自启 | 代理自身的 LLM 代码演化项目；约 95 % 代码是自动生成。 | 降低后续更新的人工工作。 |\n| 无代币需求 | PicoClaw 没有内置加密或代币经济。 | 避免诈骗；专注技术。 |\n| 开源 | GitHub 仓库，MIT 风格许可证，宽松社区。 | 任何人都可贡献、审查或分叉。 |\n| 安全沙箱 | 限制代理只能在其工作区内操作。 | 防止意外系统访问。 |\n\n--- \n\n## 快速开始（Linux 或 macOS）\n\nbash\n# 1️⃣ 克隆仓库\ngit clone https://github.com/sipeed/picoclaw.git\ncd picoclaw\n\n# 2️⃣ 安装依赖（需 Go）\nmake deps\n\n# 3️⃣ 构建二进制\nmake build\n\n# 4️⃣ 运行助手\n./cmd/picoclaw agent -m \"Hello, PicoClaw\"\n\n\n或者从 Releases 页面下载预编译的二进制文件。只需 chmod +x 后运行 picoclaw agent。\n\n--- \n\n## 在旧 Android 手机上部署\n\nPicoClaw 可以通过 Termux 将一部十年前的 Android 手机变成智能助手。\n\nbash\n# 从 F‑Droid 或 Play Store 安装 Termux\n# 下载 ARM64 二进制\nwget https://github.com/sipeed/picoclaw/releases/download/vX.Y.Z/picoclaw-linux-arm64\nchmod +x picoclaw-linux-arm64\n\n# 安装支持包\npkg install proot\n\n# 在 Termux 内运行\n./picoclaw-linux-arm64 onboard # 初始化工作区和配置\n./picoclaw-linux-arm64 agent -m \"What’s the weather?\"\n\n\nPicoClaw 同样适用于通过 Termux‑Chroot 或 pRoot 运行 Linux 的手机。相同命令即可；你现在拥有一个口袋大小的 AI。\n\n--- \n\n## Docker Compose 部署\n\n对于偏好容器化的开发者，Picoclaw 支持 Docker Compose：\n\nyaml\n# docker-compose.yml\nversion: \"3\"\nservices:\n picoclaw-gateway:\n image: ghcr.io/sipeed/picoclaw:latest\n profiles: [gateway]\n environment:\n - DISCORD_BOT_TOKEN=your-token\n volumes:\n - ./config/config.json:/app/config/config.json:ro\n - ./workspace:/app/workspace\n\n\n1. 用 API 密钥和频道凭证提交你的 config.json。\n2. 运行 docker compose --profile gateway up -d。\n3. 代理将监听你配置的 Discord、Telegram 或任意渠道。\n\n--- \n\n## 聊天应用集成\n\nPicoClaw 原生提供一个可插入标准消息平台的网关。使用相同的配置文件：\n\njson\n{\n \"channels\": {\n \"telegram\": {\n \"enabled\": true,\n \"token\": \"YOUR_TELEGRAM_TOKEN\",\n \"allow_from\": [\"YOUR_USER_ID\"]\n },\n \"discord\": {\n \"enabled\": true,\n \"token\": \"YOUR_DISCORD_TOKEN\",\n \"allow_from\": [\"YOUR_USER_ID\"]\n }\n }\n}\n\n\n运行 picoclaw gateway 将生成一个轻量 HTTP 服务器，转发消息到 AI 机器人，处理并返回回复。安全沙箱确保机器人只能访问其工作区内的文件。\n\n--- \n\n## 进阶功能\n\n### 定时任务（心跳）\n\n在工作区创建 HEARTBEAT.md：\n\n\n# Periodic Tasks\n- Report the current weather every hour\n- Check email for promotions\n\n\nPicoClaw 的心跳例程每 30 分钟（可配置）轮询此文件并异步执行任务，将结果直接发布到频道。\n\n### 子代理与生成\n\n长时间运行的操作（如网络搜索）可以使用 spawn 工具委托给子代理。子代理在自己的上下文中运行，并可通过 message 工具回传给用户，实现非阻塞流程。\n\n### 模型中心化配置\n\nPicoClaw 的 model_list 允许你插入任意 OpenAI 兼容或专有 LLM，而无需编写新代码。例如：\n\njson\n{\n \"model_list\": [\n { \"model_name\": \"gpt-4o-mini\", \"model\": \"openai/gpt-4o-mini\", \"api_key\": \"sk-…\" },\n { \"model_name\": \"llama3\", \"model\": \"ollama/llama3\" }\n ]\n}\n\n\n代理优先使用主模型，如失败则回退到下一个。\n\n--- \n\n## 安全与沙箱\n\n默认情况下，PicoClaw 强制仅使用工作区：\n\njson\n{\n \"agents\": { \"defaults\": { \"restrict_to_workspace\": true } }\n}\n\n\n所有文件系统和 exec 工具均被限制在 ~/.picoclaw/workspace。即使禁用沙箱，危险命令（如 rm -rf、shutdown 等）仍会被显式拦截。\n\n--- \n\n## 社区与贡献\n\n拥有 16 k+ 星标，PicoClaw 已成为轻量 AI 实验的社区宠儿。欢迎贡献，尤其是：\n- 新工具集成（如自定义数据库连接器）\n- 针对小众 SBC 的部署脚本改进\n- 安全审计与强化\n- 新语言的文档\n\n该项目通过 GitHub Discussions 和专属 Discord 频道管理。贡献也有助于支持路线图，其中包括进一步的内存优化、原生支持其他操作系统以及与流行 AI 工作流的更紧密集成。\n\n--- \n\n## 最后思考\n\nPicoClaw 证明，强大的对话 AI 已不再局限于高端 GPU 或昂贵云端服务器。通过结合极小 Go 二进制、沙箱化运行时和灵活配置系统，项目使任何廉价微控制器或旧手机成为完全功能的个人助手。无论你是想在 <$10 的板子上快速原型化微 AI、给家用服务器添加 AI 伙伴，还是探索自治代理，PicoClaw 都能让你快速、安全、免费地实现。\n\n立即查看 GitHub 仓库，今天就开始构建你自己的低成本 AI 助手吧。