Hermes Agent 安装部署教程 应该先看哪一篇？
建议先点击「打开安装部署专题」，它是本分类的主线入口。主线看完后，再按阅读顺序补相关文章。
Search intent
这个分类解决什么搜索需求
已经决定尝试 Hermes Agent，需要安装命令、环境检查和部署路线。
适合准备在 macOS、Linux、Windows WSL2 或 VPS 上安装、试跑和长期运行的用户。
Focus
重点内容
系统环境选择
setup 和 doctor 验收
VPS 长期运行
日志、进程和低权限用户
建议阅读顺序
- 01先选择自己的系统路线
- 02本地跑通短问答和 Starter 模板
- 03需要长期运行时再进入 VPS、日志和守护进程
读完后怎么验收
能稳定运行 hermes setup
知道 Provider、Memory、Skills、Gateway 哪一步失败
能保留日志并复现一次工作流
读前先判断
01先选清楚 macOS、Linux、WSL2 还是 VPS 路线
02先本地 CLI 跑通，再考虑长期运行
03每次报错只改一个变量并保存日志
常见误区
命令没跑通就接消息平台
混用 WSL2、PowerShell 和 macOS 路径
VPS 上直接用高权限账号长期跑 Agent
常见问题
这个分类读完后怎么判断有效？
能稳定运行 hermes setup；知道 Provider、Memory、Skills、Gateway 哪一步失败；能保留日志并复现一次工作流
如果 安装部署 相关教程看完仍然卡住怎么办？
先把问题缩小到一个可复现样例，记录当前系统、命令、模型、输入、错误日志和预期输出，再回到排错清单逐层定位。
{ install }
安装部署·更新 2026-10-07·10 分钟阅读
Hermes Agent 安装路线怎么选：原生 Windows、WSL2、macOS 与 Linux
面向中文用户整理原生 Windows、WSL2、Linux、macOS（Apple Silicon）的安装路线、命令和验收清单，已对照 Hermes Agent v0.21.5 核对。
{ install }
安装部署·更新 2026-10-07·11 分钟阅读
如何把 Hermes Agent 部署到 VPS 上长期运行
讲清 Hermes Agent VPS 选择、进程守护、日志、环境变量、定时任务和低权限用户的基础部署思路。
{ install }
安装部署·更新 2026-10-07·8 分钟阅读
Hermes Agent Docker 部署：用官方 compose 文件跑通 Gateway 与仪表盘
用官方 Dockerfile 和 docker-compose.yml 部署 Hermes Agent：HERMES_UID 用户映射、~/.hermes 数据持久化、仪表盘 SSH 隧道访问与 s6-overlay 进程监管。
{ install }
安装部署·2026-10-07·6 分钟阅读
Hermes Desktop 桌面版：安装、切换中文界面和国内网络注意点
Hermes Agent 官方桌面应用怎么装、怎么切成简体中文界面，国内网络下 Electron 下载和更新检查要注意什么，以及什么时候用桌面版、什么时候用命令行。对照 v0.21.5 官方文档整理。
{ install }
安装部署·更新 2026-10-07·7 分钟阅读
Hermes Agent 安卓 Termux 运行指南：官方安装面、依赖约束与定位
在安卓 Termux 上安装运行 Hermes Agent：官方一键脚本支持、.[termux] 裁剪依赖组与 constraints 锁版、gateway run 前台模式，以及手机作为第二入口的合理定位。
{ install }
安装部署·更新 2026-10-07·8 分钟阅读
Hermes Agent install.sh 下载失败、卡住、超时怎么办
国内跑官方一键脚本时 install.sh 卡在下载、clone GitHub 超时、依赖拉取一直转圈,先弄清脚本背后有哪几段下载,再按段定位、配代理或镜像稳妥恢复。已对照 v0.21.5 核对。