Hermes Agent 安卓 Termux 运行指南：官方安装面、依赖约束与定位

官方一键脚本本身就支持 Termux

README 的 Quick Install 一节把 Termux 与 Linux、macOS、WSL2 并列，共用同一条安装命令：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

也就是说在手机上装 Hermes Agent 不是折腾出来的偏方，而是官方维护的安装面之一，文档站还有专门的 Termux 指南（getting-started/termux）记录了经过测试的手动路径。

为什么 Termux 有自己的依赖约束文件

完整的 .[all] 依赖组目前会带进与 Android 不兼容的语音依赖，所以 Termux 安装的是裁剪过的 .[termux] 依赖组。官方仓库提供 constraints-termux.txt，把 ipython、jedi、pexpect、matplotlib-inline 这些包锁在 Termux 可用的版本区间内。手动安装路径是：

python -m pip install -e '.[termux]' -c constraints-termux.txt

遇到依赖编译失败，先对照官方 Termux 指南确认步骤，不要自己把约束文件里的版本往上抬——那些区间就是为了避开 Android 上装不动的版本才存在的。

手机上的 Gateway 只有前台一条路

Android 没有 systemd，`hermes gateway install` 的系统服务模式用不上。官方对 Termux 的推荐就是前台运行：

hermes gateway run

代价是 Termux 会话必须保持存活。Android 的后台杀进程策略比桌面系统激进得多，锁屏一段时间后进程可能被回收；把 Termux 加进电池优化白名单能缓解，但改变不了手机不适合当长期值守服务器这个事实。

手机的合理定位：第二入口，不是主机

更稳的组合是双层结构：Hermes 装在 VPS 或常开的电脑上长期值守，手机通过 Telegram 这类已接入的消息平台随时指挥它；Termux 本机安装则承担两件事——离线试验 CLI，以及在外面临时排查（`hermes status` 和 `hermes logs` 都能直接跑）。这样既有移动入口，又不依赖手机进程存活。

装完先跑这三条验收

hermes --version
hermes doctor
hermes -z "用一句话确认你能正常回复"

版本号正常返回、依赖检查通过、单次问答能出结果，再考虑配 gateway 或定时任务。三条里任何一条卡住，先解决它再往下走，顺序不要颠倒。

还没有真实场景？可以先领取 [Free Starter 模板包](/free-template-pack)，从低风险只读任务开始试跑。