在安卓手机Termux上部署OpenClaw完整教程(旧手机变AI助手)
1.前言:为什么在手机上部署OpenClaw
众所周知,OpenClaw因为会修改本地文件,一般不建议部署在主力上。
但是抠门狗是不可能买云服务器的,单独买台设备更是不用想了,旧手机部署应该是成本最低的方案了。
废话不多说,直接开搞。
2.环境准备:Termux安装与配置
1.scientific上网工具,来看教程的默认都能搞定,不好多说,各显神通
2.Termux,为安卓手机提供了一个终端,可以模拟linux环境,下载地址 https://cloud.189.cn/web/share?code=amEn2aeiyaia(访问码:75kl)
3.一键部署:使用openclaw-android脚本
安装并打开 termux,挂好梯子,在 termux 执行命令
curl -O https://raw.githubusercontent.com/iyeoh88-svg/openclaw-android/main/install.sh

该命令下载了github上有一个叫openclaw-android项目的安装脚本,有兴趣的可以访问项目地址:https://github.com/iyeoh88-svg/openclaw-android
执行下面两个命令,修改安装脚本权限,然后执行它,脚本会自动搭建基础运行环境,并安装最新版的openclaw,
chmod +x install.sh./install.sh
安装过程需要等待

像下图这样就是安装成功了

4.配置OpenClaw:Onboard
执行命令:
proot-distro login debian --user openclaw

可以看到用户变更了,实际上是进入了一个沙箱环境的debian系统,后续每一次部署/重启openclaw都要确保处于这个环境,所以这个命令需要记下来,或者自己写个脚本
接下来是配置openclaw,执行命令
openclaw onboard
这个界面和其他平台一样的就不赘述了
可以参考这个教程:https://zhuanlan.zhihu.com/p/2005987429828534912
从第二步开始看,3.9开始就不要看了,可能会不一样聊天软件我接入的飞书,大家想接入什么可以自己找教程: https://zhuanlan.zhihu.com/p/2003941619594970116

配置完之后,执行命令:
openclaw gateway --verbose

注意:其他教程可能会提到这行命令
openclaw gateway restart
我们这个环境因为systemd的原因,用不了这个命令,懒狗可以和前面的"proot-distro login debian --user openclaw"一起做成脚本
我没做,因为我更懒,根本不重启
这些命令启动openclaw是亲测可用的
start-claw // 不会加载最新的配置文件
openclaw gateway --verbose // 会加载最新的配置文件

我们这里网关就启动成功了
5.调试:小众环境的刀尖跳舞
正常来说应该去访问后端管理台了,

日志里提供了本机ip和端口号,但是这些还不能够有权限访问,实际上全路径应该是 http://127.0.0.1:18789#token=xxxxxxxxxx
我部署的时候控制台会打印出全路径,复制粘贴就能访问了,新版本好像不打印token了,那么只能从配置文件里找了
此时openclaw网关在前台运行,命令行已经被阻塞了,要在termux里新开一个session
如果你的termux界面下边板有这三道杠这个按键,那么直接点击会弹出左边栏

如果你的termux界面下边板没有这个按键,甚至没有下边板,那就只能从左侧往右滑动(部分机型这个手势因为返回手势冲突无法换出左边栏,建议在系统设置中将手势操作改为导航键)

左边栏如下图,点击new session(也有可能是个加号图标)进入新的命令行界面,切换session也是通过这个面板

还是一样先进入proot,然后打开配置文件找token,命令如下
proot-distro login debian --user openclaw
nano ~/.openclaw/openclaw.json

配置文件里 gateway.auth.token 字段的值就是 token了,如果复制不出来就截图识图吧

浏览器访问

然后就进入后端管理台,可以进行实测了,我这里没配置模型,回复就是没模型

6.可能遇到的问题:痛并快乐着
如果安卓版本低,可能会出现基于webview的浏览器显示空白的情况(我用的安卓10老机器就出现了),如下图左
可以安装一个chromium内核的浏览器来解决,比如微软edge,下面是给懒狗们提供的kiwi浏览器下载链接,亲测可用,如下图右
https://cloud.189.cn/web/share?code=J3m2Mnz2QBbq(访问码:c0wo)

如果你配置了模型,在此网页回复内容如下:
Agent failed before reply: Model context window too small (4096 tokens). Minium is 16000.
Logs: openclaw logs --follow
~/.openclaw/openclaw.json (需要在openclaw的用户session的命令行里,即前方提到的proot-distro login debian --user openclaw)
把配置中 models.providers.models 里每个对象的contextWindow字段改大,不要低于他的提示值(这里是16000)

改完后重启openclaw
如果接入了聊天软件,对话回复如下:
OpenClaw: access not configured.
Your Feishu user id: ou_5e00xxxxxxxxxxxxxxxxxxxxe9
Pairing code: 4B8T6QP6
Ask the bot owner to approve with:
openclaw pairing approve feishu 4B8T6QP6
需要在openclaw的用户session的命令行里(即前方提到的proot-distro login debian --user openclaw)执行这段话的最后一行,复制粘贴回车
openclaw pairing approve feishu 4B8T6QP6
如果执行成功了,但是对话仍返回类似内容,且openclaw gateway日志显示有
"Config warnings: duplicate plugin id detected" 字样,还有个路径,比如 “/home/openclaw/.../extensions/feishu”
别怀疑,提示哪个路径就删掉哪个路径, rm -rf /home/openclaw/.../extensions/feishu
看不到全路径就去问AI,然后重启openclaw

浙公网安备 33010602011771号