安卓端 Hermes Agent 安装与 OpenRouter 配置完整教程

安卓端（Termux）安装 Hermes Agent 并接入 OpenRouter 大模型的详细教程。本教程基于最新社区实践，涵盖从零开始

📌 第一部分：Termux 基础环境设置（直接复制）

步骤 1：安装 Termux（必须）

从 F-Droid 安装：https://f-droid.org/packages/com.termux/

（切勿用 Google Play 旧版）

步骤 2：启动 Termux 并授权

termux-setup-storage

（允许存储权限弹窗）

步骤 3：更新并安装依赖（国内用户建议先配镜像）

pkg update -y

pkg upgrade -y

pkg install git python nodejs rust clang make -y

（可选）国内用户配置加速镜像：

# Git 加速

git config –global url.”https://mirror.ghproxy.com/https://github.com”.insteadOf “https://github.com”

# pip 加速

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

pip config set install.trusted-host mirrors.aliyun.com

# npm 加速

npm config set registry https://mirrors.cloud.tencent.com/npm/ –global

📌 第二部分：一键安装 Hermes Agent（直接复制）

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

等待安装完成，看到 Installation complete! 后继续。

📌 第三部分：配置 OpenRouter 模型（核心步骤）

1. 获取 OpenRouter API Key

手动操作：访问 https://openrouter.ai/ → 注册/登录 → 左侧 API Keys → Create → 复制生成的 Key（仅显示一次，务必保存）。

2. 在 Hermes 中配置（直接复制命令）

hermes model

按提示操作：

选择 openrouter 或 OpenRouter。

粘贴你的 API Key。

选择模型时，一直按向下键翻到列表最底部，选择 Enter custom model name。

输入一个免费模型名（例如：minimax/minimax-m2.5:free 或 google/gemma-2-9b-it:free）。

确认保存。

3. 验证是否成功（直接复制）

hermes chat -q “你好，请介绍一下你自己”如果 AI 正常回复，即配置成功。

📌 第四部分：常见问题快速排查（直接复制）

问题：command not found: hermes

source ~/.bashrc

或重启 Termux。

问题：配置后仍不回复

重新运行 hermes model，核对 API Key 和模型名（必须带 :free）。

用浏览器访问 openrouter.ai，测试网络是否通畅。

问题：Empty response from model

检查模型名是否正确（在 OpenRouter 官网模型列表确认）。

如果是自定义端点（如 Ollama），检查 URL 是否为 http://127.0.0.1:11434/api/generate。

📌 第五部分：本地模型备选方案（Ollama）

# 1. 安装 Ollama

curl -fsSL https://ollama.com/install/termux | sh

# 2. 启动服务并下载轻量模型（如 Gemma 2B）

ollama serve &

ollama pull gemma:2b

# 3. 在 Hermes 中配置本地模型

hermes model

# 选择：More Providers… → Custom endpoint → 输入 URL: http://127.0.0.1:11434/api/generate

# 模型名输入：gemma:2b

📌 第六部分：重要注意事项（必读）

API Key 安全：~/.hermes/.env 文件包含你的 Key，切勿泄露或上传到 GitHub。

免费额度：OpenRouter 免费模型有每日调用限制（约 50-100 次），超出需付费。

手机性能：本地模型（如 Ollama）会占用大量 CPU/内存，老旧机型可能卡顿发热。

隐私提示：使用云端 API 时，对话内容会经过第三方服务器。

系统要求：安卓 8.0+，Termux 必须从 F-Droid 安装。

好#Hermes安装教程大全# 来自阶跃AI分享https://www.stepfun.com/share/236736915933716480?share-id=236736915933716480&shareto_way=link

，

尽情的

使用它

吧