乐于分享
好东西不私藏

手机里的 AI Agent :PicoClaw

手机里的 AI Agent :PicoClaw

搭 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 引擎。

它的核心数据很炸:

指标
PicoClaw
OpenClaw
NanoBot
语言
Go
TypeScript
Python
内存
<10MB
>1GB
>100MB
启动(0.8GHz)
<1s
>500s
>30s
最低硬件成本
$10
$599 Mac mini
~$50 开发板

一个 10MB 的二进制文件,跑在 0.6GHz 单核上都能 1 秒启动。这就是 Go 编译成原生二进制的好处——没有 Node.js 的运行时开销,没有 Python 的解释器成本。

但这不只是"小"的问题。它小到你可以把它塞进任何角落:9.9 美元的路由器级开发板、树莓派 Zero、甚至你抽屉里吃灰的旧安卓手机。

所以问题是:手机装 APK 和 Termux 跑,到底差在哪?

姿势一:APK 安装 —— 简单,但有局限

Sipeed 在 3 月 31 日发布了 Android APK,直接在 picoclaw.io 下载安装。

体验流程:

  1. 去 picoclaw.io 下载 APK
  2. 点安装,开权限
  3. 打开 App,看到 Flutter UI 界面
  4. 在设置里填 API Key
  5. 开始对话

整个过程大概 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.gz

3. 初始化配置

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 gateway

6.(可选)Web UI Launcher

如果你想用浏览器界面而不是纯命令行:

# 下载 launcher 版本# 从 picoclaw.io 下载或从源码构建# 启动 launchertermux-chroot ./picoclaw-launcher# 在浏览器打开 http://localhost:18800

这样你就能在 Termux 里跑 PicoClaw 后端,用手机浏览器当 UI。

如果不用浏览器,就直接对接QQ,更方便!具体对接看官方文档。

核心对比:APK vs Termux

维度
APK 安装
Termux 部署
上手时间
3 分钟
15-30 分钟
界面
Flutter UI
终端 / 浏览器 WebUI
系统访问
Android 沙盒
proot 虚拟化 Linux
工具链
git, grep, vim, wget 全可用
后台运行
系统级
依赖 termux-wake-lock
多任务
App 内
可跑多个进程
MCP 扩展
有限
可装 MCP Server
端口监听
受限制
全端口可配
更新方式
重新下载 APK
wget 新版本解压覆盖
适合人群
想直接用的人
想折腾+掌控的人

我的建议:先 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