Android 上跑 Hermes Agent：Termux 完整安装攻略

Hermes Agent 平时跑在服务器上（我写过 Docker 部署和升级方案），但有些场景你会希望它「跟着人走」——出差时、通勤时、信号差时，手机就是最顺手的终端。

把 Hermes Agent 装进 Android 手机，Termux 是唯一正解：它不是一个模拟器，而是在安卓原生环境里跑真实的 Linux 用户态，能装 Python、编译原生库、跑完整 agent。本文是 2026 年 5 月实测流程（Termux v0.118.3 稳定版），照着走一遍就能跑起来。

适用：安卓 8.0+ 手机 ｜ 实测版本：Termux v0.118.3 ｜ 更新：2026-08-29

一、准备工作：装 Termux

1. 下载安装包

Termux 在 Play 商店的版本早就停止维护了，务必从 GitHub Releases 下载：

# 下载地址（选 v0.118.3 稳定版）
https://github.com/termux/termux-app/releases/tag/v0.118.3

• 芯片是 64 位（近几年的手机基本都是）选 arm64-v8a
• 不确定自己芯片型号？直接选 universal，通吃

2. 初始化

装好后打开 Termux，先做三件事：

# 更新软件源和已装包
pkg update -y && pkg upgrade -y

# 换国内镜像（大陆网络必做，否则下载慢到怀疑人生）
termux-change-repo    # 选 Mirrors in Chinese Mainland

# 授权存储访问（后面传文件、读数据要用）
termux-setup-storage

termux-change-repo 是交互式界面，方向键选择 Mirrors in Chinese Mainland 回车即可。这三步做完，Termux 才算能用。

二、系统依赖：一次装齐

Hermes Agent 依赖 Python 编译环境，还需要一些原生库。一条命令全装：

pkg install -y git python clang rust make pkg-config libffi openssl nodejs ripgrep ffmpeg

💡 手机上编译比服务器慢，第一次 pkg upgrade 和装依赖耐心等几分钟，属正常现象。

三、安装 Hermes Agent（三种方式）

方式一：官方一键安装（推荐，先试这个）

# 官方源
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# GitHub 源（官方源连不上的时候）
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 国内镜像
curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

方式二：中文社区指南

如果你更习惯照着图文一步步来，社区文档有专门的 Termux 章节：

https://hermesagent.org.cn/docs/getting-started/termux

方式三：手动安装（遇到 psutil 兼容问题用这个）

一键安装最常见的坑是 platform android is not supported——这是 psutil 在安卓上识别不了系统导致的。手动安装时手动修补一下就好：

git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git ~/hermes-agent
cd ~/hermes-agent

# 建虚拟环境
python -m venv venv && source venv/bin/activate

# 关键：把安卓 SDK 版本导出给编译环境
export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"

# 手动修补 psutil：编辑 _common.py 让 LINUX 分支认 android
# （找到 _common.py 里判断平台的地方，把 android 归入 LINUX）
pip install -e ".[termux]" -c constraints-termux.txt

四、配置飞书网关

Hermes Agent 装好后，和服务器版一样走「飞书网关」接入——手机号登录飞书，机器人就是你的入口：

# 初始化网关，空格选中「飞书」→ 回车 → 浏览器授权登录
hermes setup gateway

# 启动网关
hermes gateway

授权完成后，飞书里给机器人发消息就能指挥它干活了。

五、防杀后台：tmux 保活

安卓的省电策略会杀后台进程，这是手机跑 agent 最大的敌人。解决思路是两层：

第一层：tmux 挂会话

pkg install tmux

tmux new -s gateway    # 新建会话
hermes gateway          # 在会话里启动
# Ctrl+B 然后 D  →  脱离会话（进程继续跑）
# tmux attach -t gateway  →  重新进入会话看输出

第二层：手机系统设置

• 关闭电池优化：设置 → 应用 → Termux → 电池 → 不限制
• 开启自启动：允许 Termux 后台自启
• 锁住最近任务：最近任务列表里把 Termux 下拉锁定

两层都做，agent 才能稳定在线。想省电就反着来——用完 tmux attach 进去 Ctrl+C 停掉即可。

六、SSH 远程连接

手机屏幕操作终端终归局促，强烈建议把手机当「无头服务器」用，电脑 SSH 连过去操作：

# —— Termux 侧（一次性配置）——
pkg install openssh -y
sshd                     # 启动 SSH 服务
passwd                   # 设置登录密码

# —— 电脑侧（每次连接）——
ssh -p 8022 用户名@手机IP

要点：

• 端口是 8022（Termux 非 root，用不了 22）
• 手机 IP 在 Termux 里 ifconfig 或系统 WiFi 详情里看
• 手机和电脑要在同一局域网；跨网络访问需要内网穿透或端口转发，进阶玩法这里不展开

配合 tmux，SSH 断线了会话还在，重连 tmux attach 继续看，体验和服务器一模一样。

七、常见问题速查

总结

手机跑 Hermes Agent 的完整链路就三步：Termux 装环境 → 三种方式装 agent（遇到 psutil 坑走手动）→ 飞书网关 + tmux 保活。装好之后，它就是一个随身携带、随时待命的 AI 助手。

比服务器版多出来的几件事：国内镜像换源、psutil 修补、防杀后台——本质都是「安卓环境适配」，解决了就很稳。

想深入折腾 Hermes Agent，站内这几篇可以接着看：

• Hermes Agent 的 Docker 部署和升级方案
• Hermes Agent 升级后飞书机器人无响应解决办法
• VSCode + Claude Code 接入 DeepSeek V4 完整教程