Hermes Agent 安装教程 应该从哪里开始？
建议先打开「打开教程地图」，按本页的步骤完成最小验证，再阅读相关排错和视频内容。
Topic guide
安装 专题怎么读
先读基础页，再进入问题排查和可复制模板，最后用免费资源包跑一次低风险场景。
- 01从教程地图确认学习阶段
- 02读相关问题排查和实战文章
- 03领取 Starter 包做一次可复现验证
这个专题适合谁
Hermes Agent 安装教程 适合正在安装、换系统、上 VPS 或排查命令环境的人。这个阶段最重要的是缩小问题范围，先让 CLI 在当前终端稳定工作。
读完后的验收标准
能在当前终端稳定启动 Hermes Agent，短问答和 setup 验收都有明确结果。
先检查这三件事
01确认当前 shell、系统环境和安装路径一致
02先跑 hermes setup、config check 或 doctor 这类验收命令
03把失败日志复制出来，再判断是依赖、PATH、Provider 还是权限问题
常见误区
在 WSL2、PowerShell、macOS 终端之间混用路径
没看日志就反复重装
CLI 还没跑通就直接接 Gateway 或定时任务
常见问题
安装 相关问题怎么判断是否已经解决？
能在当前终端稳定启动 Hermes Agent，短问答和 setup 验收都有明确结果。
读完 Hermes Agent 安装教程 后下一步做什么？
如果还没有真实场景，先下载免费 Starter 包，选择日报、Issue 分类或内容选题这类只读模板跑一次。
读完专题，建议做一次验证
只看教程不够。下载 Starter 包，选一个日报、Issue 分类或内容选题模板跑一次，确认输入、输出和日志都可复现。
{ install }
安装部署·2026-06-13·8 分钟阅读
Hermes Agent Docker 部署：用官方 compose 文件跑通 Gateway 与仪表盘
用官方 Dockerfile 和 docker-compose.yml 部署 Hermes Agent：HERMES_UID 用户映射、~/.hermes 数据持久化、仪表盘 SSH 隧道访问与 s6-overlay 进程监管。
{ install }
安装部署·2026-06-13·7 分钟阅读
Hermes Agent 安卓 Termux 运行指南：官方安装面、依赖约束与定位
在安卓 Termux 上安装运行 Hermes Agent：官方一键脚本支持、.[termux] 裁剪依赖组与 constraints 锁版、gateway run 前台模式，以及手机作为第二入口的合理定位。
{ install }
安装部署·2026-06-13·8 分钟阅读
Hermes Agent install.sh 下载失败、卡住、超时怎么办
国内跑官方一键脚本时 install.sh 卡在下载、连 raw.githubusercontent.com 超时、依赖拉取一直转圈,按网络层、脚本层、依赖镜像三段分别定位并稳妥恢复。
{ install }
安装部署·更新 2026-05-31·10 分钟阅读
Hermes Agent 中文安装教程：macOS、Linux 与 WSL2
从零开始，覆盖三大主流环境的依赖安装、Python 版本选择与第一次启动的常见坑。
// guide
故障排查·更新 2026-05-19·9 分钟阅读
Hermes Agent 安装失败怎么排查：command not found、PATH、Python 和 API Key
安装 Hermes Agent 后打不开、命令找不到、setup 卡住或 Provider 配置失败时，按终端、PATH、依赖、API Key 和系统路线逐项恢复。
{ install }
安装部署·更新 2026-05-19·10 分钟阅读
Hermes Agent Windows、Linux、macOS 安装补充：怎么选最稳路线
面向中文用户补充 Windows WSL2、Windows PowerShell Early Beta、Linux、macOS 的安装路线、命令和验收清单。