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 分类或内容选题模板跑一次，确认输入、输出和日志都可复现。
// guide
故障排查·更新 2026-10-07·9 分钟阅读
Hermes Agent 安装失败怎么排查：command not found、PATH、Python 和 API Key
安装 Hermes Agent 后打不开、命令找不到、setup 卡住或 Provider 配置失败时，按终端、PATH、依赖、API Key 和系统路线逐项恢复。
{ 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·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 核对。