常见问题
Last updated on
把 Hermes 教程里最容易反复出现的误区、疑问和排查方向集中放在一起。
这页适合什么时候看？
不是一开始就必须看。
更适合在你已经照着主线做过一遍，但过程中出现了“好像哪里不对、又不太确定问题出在哪”的时候再回来看。
1. 我明明已经安装了，为什么还是启动不了 Hermes？
先不要把“安装脚本跑过了”和“命令已经可用”混为一谈。
通常按这个顺序判断：
- 先看你是不是在官方支持的平台里安装的
- 再看当前 shell 有没有重新加载
- 再看
hermes命令现在是否真的存在 - 最后再看 provider 和 model 配置
如果你是 Windows 用户，第一优先就先确认自己是不是已经在 WSL2 环境里。
2. Windows 上为什么老出问题？
因为 Hermes 官方当前并不主打原生 Windows 安装路径，而是建议通过 WSL2 使用。
所以很多“装不上”“命令不通”“行为怪异”的情况，本质上不是 Hermes 特别难，而是你装在了不推荐的运行环境里。
3. 为什么我 provider 配了，还是不能正常聊天？
优先检查这几类问题：
- API Key 或登录状态是否真的有效
- 你当前实际生效的是哪个 provider
- 你选的模型是不是上下文太小
- 模型名是不是写错，或者你当前账号根本没有这个模型权限
Hermes 对主模型上下文有要求，官方文档建议至少 64K。
4. 为什么模型能选到，但体验还是很怪？
最常见原因之一，是模型虽然能调用，但并不适合 Agent 场景。
比如：
- 上下文太小
- 工具调用体验不稳定
- 你同时叠了太多高级能力，第一次就把问题复杂化了
所以第一次接入时，先选一个上下文足够、你自己已经熟悉的模型，通常更稳。
5. 为什么我改了 .env 或 config.yaml，却感觉没生效？
优先回头看配置优先级：
- CLI flags
config.yaml.env- 默认值
很多时候不是你没改对，而是被更高优先级的设置盖掉了。
6. hermes 命令还是找不到，先该怎么办？
先按这个顺序检查：
- 重新打开一个终端，或者重新执行
source ~/.bashrc - 确认当前 shell 已经加载到新的命令环境
- 再重新运行
hermes、hermes doctor这类命令
如果做到这里还是不通，就先不要继续折腾 provider 和高级功能，优先回到安装阶段排查。
7. 第一次使用时，最容易做错的事是什么？
通常就是下面这几类：
- 一开始就想把消息平台、技能、MCP、Cron 全接上
- 一次配置很多 provider，最后自己分不清谁在生效
- 还没确认主线能用，就开始做高风险自动化
第一次最稳的走法，永远是：
- 先装好
- 先配一个 provider
- 先完成一次正常对话
8. 如果我已经跑通主线，接下来该看什么？
通常有 3 条路：
- 想继续理清 provider、model 和后端：看 Provider 与模型
- 想回到主线路径：看 Hermes 准备工作
- 想继续比较不同工具路线：回看 产品地图
如果你现在已经能正常启动 Hermes 并完成第一次对话，其实主线路径已经跑通了
后面不是推翻重来，而是在已经能用的基础上，逐步补 provider、模型、工具和平台化能力。