搭 PicoClaw 的两个姿势:APK 点一下就行,Termux 折腾半小时——但后者更香
29.1k Stars,4 天破 5000,17 天冲 2 万。
Sipeed 的 PicoClaw 从 2 月 9 日发版到现在,三个月走完了大多数开源项目三年的路。它不是 OpenClaw 的分支,不是 NanoBot 的移植,是纯 Go 从零写的——而且是 AI Agent 自己写自己,95% 核心代码由 Agent 生成,人做微调。
这样的项目,不亲手跑一遍可惜了。
但问题来了:跑在哪?
如果你关注过 PicoClaw,你大概知道它最出圈的点是"10 美元硬件 + 10MB 内存"。但对于我们这些手上没 LicheeRV-Nano 开发板、又不想花 599 美元买 Mac mini 的人来说,最现实的两条路是:
装 APK,还是在 Termux 里折腾?
因为前期还不清楚这个到底怎么样,就先试试app,后期再在termux中跑,折腾了大概半个小时,我更喜欢后者。
PicoClaw 到底是个什么东西
在对比体验之前,先搞清楚你装的是什么。
PicoClaw 是一个超轻量级 AI Agent 框架。不只是一个聊天机器人,而是一个能接 LLM、能写代码、能做任务自动化、能调用工具、能记住上下文、能接多渠道(Telegram、微信、Discord、Matrix……)的 Agent 引擎。
它的核心数据很炸:
一个 10MB 的二进制文件,跑在 0.6GHz 单核上都能 1 秒启动。这就是 Go 编译成原生二进制的好处——没有 Node.js 的运行时开销,没有 Python 的解释器成本。
但这不只是"小"的问题。它小到你可以把它塞进任何角落:9.9 美元的路由器级开发板、树莓派 Zero、甚至你抽屉里吃灰的旧安卓手机。
所以问题是:手机装 APK 和 Termux 跑,到底差在哪?
姿势一:APK 安装 —— 简单,但有局限
Sipeed 在 3 月 31 日发布了 Android APK,直接在 picoclaw.io 下载安装。
体验流程:
去 picoclaw.io 下载 APK 点安装,开权限 打开 App,看到 Flutter UI 界面 在设置里填 API Key 开始对话
整个过程大概 3 分钟。不需要了解什么是 config.json,不需要碰命令行,不需要装任何依赖。
APK 版本自带 Flutter UI,界面很干净,有主页面、Web 页面、日志页面和设置页面。开箱即用,四个字。
优势很直接:
零门槛:家里人都会用 UI 完整:设置、对话、日志都在图形界面里完成 省心:不需要操心 Termux 的 proot 兼容性问题 后台运行:Android 系统服务级别管理
但局限也很清楚:
限制在 App 内运行:你没法同时跑 picoclaw 和其他 Android App 做深度联动 文件访问受限:Android 的沙盒机制决定了它碰不到你手机上的所有文件 工具链受限:你不能在它旁边跑 git、grep、或自定义脚本 定制化能力弱:config.json 的深层配置项在 UI 里不一定全暴露 只能在 Android 上用
姿势二:Termux 部署 —— 折腾,但这是真·Agent
Termux 是一个 Android 上的 Linux 终端模拟器。没有图形界面,没有 App 图标,就是一个终端。但正因为如此,它的能力边界和 APK 不在一个量级。
在 Termux 里跑 PicoClaw,大致流程如下:
1. 安装 Termux
下载地址(选一个):
GitHub Releases(推荐):https://github.com/termux/termux-app/releases F-Droid:搜索 Termux Google Play:搜索 Termux(注意:Play 版可能更新较慢)
⚠️ 建议从 GitHub Releases 下载最新版,一些旧版 Termux 存在包管理问题。
2. 下载 PicoClaw 二进制
打开 Termux,依次执行:
# 更新包管理器pkg update && pkg upgrade -y# 安装 wget 和 prootpkg install wget proot -y# 下载 PicoClaw arm64 版本wget https://github.com/sipeed/picoclaw/releases/latest/download/picoclaw_Linux_arm64.tar.gz# 解压tar xzf picoclaw_Linux_arm64.tar.gz3. 初始化配置
PicoClaw 依赖标准 Linux 文件系统布局,Termux 默认不是。所以需要 proot 做 chroot(也可以自己下载然后编译,不需要proot):
# 进入 proot 环境初始化termux-chroot ./picoclaw onboard这一步会自动创建 ~/.picoclaw/config.json 和 workspace 目录。
4. 配置 API Key 和模型
编辑配置文件:
# 查看生成的默认配置cat ~/.picoclaw/config.json# 用 nano 或 vi 编辑nano ~/.picoclaw/config.json参考配置格式:
{"agents":{"defaults":{"model_name":"gpt-4o"}},"model_list":[{"model_name":"gpt-4o","model":"openai/gpt-4o"}]}⚠️ 安全说明:从 v0.2.4 开始,API Key 等敏感信息自动迁移到 .security.yml 文件。如果直接填在 config.json,系统会在首次启动后自动迁移并清除明文密钥。
5. 开始使用
# 一次性问答termux-chroot ./picoclaw agent -m "你好,介绍一下你自己"# 交互模式termux-chroot ./picoclaw agent# 启动 Gateway(需要配置 Channel)termux-chroot ./picoclaw gateway6.(可选)Web UI Launcher
如果你想用浏览器界面而不是纯命令行:
# 下载 launcher 版本# 从 picoclaw.io 下载或从源码构建# 启动 launchertermux-chroot ./picoclaw-launcher# 在浏览器打开 http://localhost:18800这样你就能在 Termux 里跑 PicoClaw 后端,用手机浏览器当 UI。
如果不用浏览器,就直接对接QQ,更方便!具体对接看官方文档。
核心对比:APK vs Termux
我的建议:先 APK 尝鲜,再 Termux 吃透
这不是二选一的问题。APK 和 Termux 可以装在同一台手机上。
如果你只是想看看 PicoClaw 是什么、跟它聊聊天、试几个功能 → 直接装 APK,3 分钟搞定,不行就卸。
如果你真的想把 PicoClaw 用起来——让它写代码、做自动化、接 MCP、连 GitHub/Gmail/微信 → 走 Termux 路线。配置的过程本身就是理解 Agent 工作原理的过程。
如果你两个都装 → APK 当日常聊天界面,Termux 跑深度工作。互联互通不冲突。
而对于已经在我上一篇里看过 OpenHuman 的朋友,我多说一句:PicoClaw 和 OpenHuman 走的是完全相反的路。OpenHuman 是"把能力做大,一把揽过来";PicoClaw 是"做小,轻到可以放任何地方"。你不需要在它们之间选——这两个东西解决了完全不同的问题。
送你一条实在的建议:别因为 Termux 看起来麻烦就放弃。 半小时的折腾,换回来的是一个可以写代码、做自动化、调用 MCP 的、一直在你口袋里的 AI Agent。这交易不亏。
点点关注:你的关注就是我继续分享的动力。谢谢!
有什么搞不定的,评论区回复,一一解答!
项目地址:https://github.com/sipeed/picoclaw
picoclaw下载 APK:https://picoclaw.io/download/
termux下载:https://github.com/termux/termux-app/releases
夜雨聆风