本地环境先干净
先确认终端、Git、Node.js、Python、环境变量和 API Key 都能被当前 shell 正常读取。
返回教程地图
Hermes Agent 安装部署：先跑通，再长期运行
从本地安装、模型 Provider、hermes setup 验收到 VPS 长期运行，按中文用户上手顺序整理 Hermes Agent 部署路线。
专题地图
这一页先解决什么
Provider 先只接一个
第一阶段优先用 OpenRouter 或稳定的兼容端点跑通，不要同时排查多个模型来源。
setup 输出逐项验收
Provider、Memory、Skills、Gateway 四个信号都要有对应的命令、日志和低风险验证任务。
长期运行再上 VPS
本地流程稳定后，再迁移到低权限用户、进程守护、日志轮转和环境变量清晰的服务器。
阅读路径
按这个顺序读，少走弯路
专题页不堆链接，只保留最能帮助你完成当前阶段的站内内容。
01
Hermes Agent 中文入门指南
先判断 Hermes Agent 是否适合你的个人或团队工作流。
打开内容02
系统安装命令补充
作为本专题的命令补充，按系统查看 WSL2、PowerShell、macOS、Linux 和 VPS 操作细节。
打开内容03
Windows / Linux / macOS 安装补充
按系统选择 WSL2、PowerShell beta、macOS 或 Linux 的最稳路线。
打开内容04
setup 输出验收清单
把 Provider、Memory、Skills、Gateway 拆成可检查项。
打开内容05
VPS 长期运行指南
整理服务器部署、日志、重启和成本边界。
打开内容进入专题前先确认
- 确认当前系统路线：macOS、Linux、WSL2、PowerShell Early Beta 或 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 没有被当前 shell 读取、模型名不匹配、Python 或 Node.js 版本混乱、PATH 配置错误，以及 Gateway 还没接通就开始排查消息平台。