Hermes Agent 安装后启动不了，先别急着反复重装。更稳的排查顺序是：确认命令是否存在、终端环境是否刷新、配置目录是否正常、模型密钥是否可用，以及权限有没有被拦住。很多启动失败并不是 Hermes Agent 本体坏了，而是当前终端没有读到正确的安装路径或环境变量。
第一步：确认命令是不是真的装上了
先在终端执行 which hermes 或 command -v hermes。如果没有任何输出，说明当前 shell 找不到 Hermes Agent 命令。常见原因是安装目录没有进 PATH，或者你装在另一个 Node/Python/包管理器环境里。
处理办法很直接：重新打开一个终端，再试一次；如果仍然找不到，就检查安装工具提示的 bin 目录，把它加入 ~/.bashrc、~/.zshrc 或你实际使用的 shell 配置里。改完后执行 source ~/.zshrc 这类命令刷新环境。
第二步：看报错属于哪一类
如果提示 permission denied，优先检查可执行权限和目录权限。不要一上来就全局 sudo，否则后面配置文件可能变成 root 所有，普通用户反而读不了。
如果提示找不到配置、密钥为空、模型不可用，就不是安装问题，而是首次配置没有完成。此时应该进入配置流程，检查 provider、model、API key 或本地模型 endpoint。
第三步：确认你在正确的项目目录里启动
Hermes Agent 这类代码代理会读取当前工作目录。你如果在家目录启动，它看到的是空环境；你如果在项目根目录启动，它才能读取项目文件和规则。建议先 cd 到要处理的项目根目录，再启动 Hermes Agent。
第四步：临时关闭复杂插件
第一次启动不要同时接 MCP、浏览器、远程网关和大量插件。先让基础聊天和读文件跑通，再逐个加功能。这样能快速判断是 Hermes Agent 本体问题，还是某个外部工具启动失败。
第五步：保留排查信息
如果还失败，整理这几项再继续排查：操作系统、安装命令、完整报错、which hermes 输出、当前 shell、是否使用 WSL2 或容器。不要只复制最后一行错误，因为真正原因通常在前几行。
最稳的顺序是：先让命令可执行，再让模型可访问，最后再接工具和自动化。这样排查速度最快，也不容易把简单环境问题搞成复杂故障。
