安装与快速开始：以官方流程为准

安装只是第一道检查点

官方文档推荐在 Linux、macOS、WSL2 与 Android / Termux 上使用同一条安装命令。这条统一安装路径很有价值，因为它先压缩了决策分叉，但它并没有替你解决平台选择本身。

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

平台指导

• 原生 Windows 不是官方支持路径；官方建议通过 WSL2 安装
• Termux 已被官方文档覆盖，并由安装器直接支持

最小预检清单

• 先选一个你愿意继续用来做后续配置的 shell 环境
• 确保 Git 已经可用
• 第一轮只选一条 provider 路径，不要同时研究所有方案
• 先决定你的目标是 terminal、remote messaging，还是从旧环境迁移

更重要的后续动作

source ~/.bashrc
hermes
hermes setup
hermes gateway setup
hermes gateway

要避免的误区是把“安装脚本跑完”当成成功。真正的成功点，是你能用一条 provider 路径把 hermes setup 跑通，并在终端里得到稳定回应。

第一次安装最容易踩的坑

• 把“安装完成”误当成“Hermes 已经配置完成”
• CLI 还没跑通，就先接 Telegram、MCP 和多个 provider
• 在 Windows 上纠结原生安装，而不是直接走 WSL2

什么才算第一次真正跑通

1. hermes 能正常启动
2. hermes setup 用一条你看得懂的 provider 路径完成
3. 你能发起一个小的真实任务并拿到稳定响应
4. 到这一步之后，再去接 gateway、迁移或 MCP

更好的默认节奏

先把终端里的一个干净主流程跑通。之后只选一条分支继续：远程访问、迁移、provider 对比，或者工具接入。这样最容易让第一次 session 保持有效，而不是膨胀。

操作者视角的结论

好的安装指引，不是让用户背住安装命令，而是帮用户减少决策噪音。如果你和 Hermes 的第一小时，最后得到的是一条干净的 terminal 路径和一个明确下一步，那安装流程就是成功的。