本地环境先干净
官方前置条件只有 Git（Linux 另需 curl 和 xz-utils），Python 和 Node.js 由安装脚本自动装；再准备一个模型 Provider 的 Key，或用 Nous Portal 浏览器登录。
返回教程地图
Hermes Agent 安装部署：先跑通，再长期运行
从本地安装、模型 Provider、hermes setup 验收到 VPS 长期运行，按中文用户上手顺序整理 Hermes Agent 部署路线。系统安装命令见安装教程。
专题地图
这一页先解决什么
Provider 先只接一个
第一阶段优先用 OpenRouter 或稳定的兼容端点跑通，不要同时排查多个模型来源。
setup 输出逐项验收
setup 只负责写配置；装完要用 hermes doctor、hermes status、一次短问答和 gateway status 逐项验收。
长期运行再上 VPS
本地流程稳定后，再迁移到低权限用户、进程守护、日志轮转和环境变量清晰的服务器。
阅读路径
按这个顺序读，少走弯路
专题页不堆链接，只保留最能帮助你完成当前阶段的站内内容。
进入专题前先确认
- 确认当前系统路线：macOS（Apple Silicon）、Linux、原生 Windows、WSL2 或 VPS，不要混用命令。
- 准备一个可用模型 Provider 和 API Key，先保证 CLI 能完成短问答。
- 安装阶段只做只读验证，不接正式群、不写生产系统。
常见误区
- 命令找不到就反复重装，而不是先检查 PATH 和当前 shell。
- Provider、Gateway、VPS 同时排查，导致不知道是哪一层失败。
- 本地没跑通就直接上 VPS，排错范围变大。
读完后的验收标准
- hermes setup 和 doctor 的关键项有明确结果。
- 短问答、一个 Starter 模板和失败日志都能复现。
- 知道下一步该看模型、Gateway、Skills 还是长期部署。
答疑
常见问题
Hermes Agent 新手应该先装本地还是直接上服务器？+
建议先在本地终端跑通一次干净对话和 setup 验收，再迁到 VPS。这样排错范围更小，也更容易确认模型、Memory 和 Skills 是否正常。
安装部署最常见的问题是什么？+
常见问题包括 API Key 没写进 ~/.hermes/.env、模型名不匹配、装完没重新加载 shell 导致 PATH 找不到 hermes、国内网络拉不到 GitHub，以及 Gateway 还没接通就开始排查消息平台。