Hermes Agent常见问题与故障排除全攻略：模型支持到离线使用 ​

这两天在群里看到好多朋友问Hermes Agent的各种问题，整理一下，顺便把踩过的坑也分享一下。

Hermes到底是什么？ ​

Hermes Agent是这个项目和产品的正式名称。就这么简单。你在文档里看到Hermes，在GitHub仓库看到Hermes Agent，在安装命令里看到hermes，都是同一个东西。

支持哪些模型？ ​

已支持的提供商 ​

核心原则：Hermes Agent支持任何兼容OpenAI API的提供商。

设置方法 ​

# 方法一：命令行配置
hermes model

# 方法二：直接编辑配置文件
~/.hermes/.env

能在Windows上跑吗？ ​

能，而且中文社区专门做了镜像安装入口，走国内直连链路。

两条路径 ​

建议：长期用终端工具、浏览器自动化、消息网关，推荐WSL2。

安卓手机能跑吗？ ​

能。Hermes Agent有经过测试的Termux安装路径。

注意：Android上没法用完整的.[all]附加功能，因为voice附加功能依赖的某些库没发Android版本。得用.[termux]精简版。

数据会被送到哪里？ ​

API调用只会发送到你配置的LLM提供商，比如OpenRouter或者你的本地Ollama。

Hermes Agent不收集：

• 遥测数据
• 使用数据
• 分析信息

你的对话记录、记忆和技能全部本地存储在~/.hermes/目录里。

能离线用吗？ ​

能。运行hermes model，选择自定义端点，输入你服务器的URL就行。

本地Ollama配置示例 ​

注意事项 ​

如果你在Ollama里设置了自定义的num_ctx：

ollama run --num_ctx 16384

一定要在Hermes Agent里设置相同的上下文长度，不然会出现各种奇怪的问题。

费用怎么算？ ​

费用取决于你选择的模型提供商。

注意：Hermes Agent本身不收费，你只用付给模型提供商的费用。

常见故障排除 ​

1. 安装失败 ​

2. 模型连接失败 ​

3. 本地模型问题 ​

4. 功能异常 ​

快速自检清单 ​

遇到问题时按顺序检查：

1. ✅ 版本是否最新？（hermes update）
2. ✅ 模型配置是否正确？（hermes model）
3. ✅ 网络是否通畅？
4. ✅ 配置文件~/.hermes/.env是否存在？
5. ✅ 本地模型服务是否运行？

总结 ​

一句话：Hermes Agent本身不收钱、不收集数据、支持离线——用好它的关键是正确配置模型提供商。