一、Hermes Agent 安装全景理解（先搞清楚再动手）
在开始安装前，你必须理解一个核心事实：
👉 Hermes 不是一个普通软件，而是一个"类操作系统级 AI Agent runtime"
它的运行依赖一整套环境：
- Python（Agent核心）
- Node.js（浏览器自动化 / messaging bridge）
- ffmpeg（语音）
- ripgrep（搜索）
- uv（Python包管理器）
- Git（代码获取）
但关键点是：
👉 官方安装脚本会自动帮你安装所有依赖
也就是说：
❌ 不需要你提前装 Python / Node
✅ 只需要 Git + Linux环境
为什么 Windows 不能直接装？
官方明确说明：
Windows 不支持原生运行，需要 WSL2
原因很简单：
- Hermes 依赖 Unix shell（bash/zsh）
- 依赖 Linux 工具链（软链接、路径结构）
- CLI设计完全基于类 Unix 系统
👉 所以：
- Windows = 必须走 WSL
- macOS = 原生支持
二、Windows 安装 Hermes（WSL 完整方案）
2.1 整体流程（架构级理解）
Windows → WSL2 → Ubuntu → Hermes
也就是：
Windows（宿主）
↓
WSL2（虚拟Linux内核）
↓
Ubuntu发行版
↓
Hermes Agent
2.2 第一步：安装 WSL2
方法一（推荐，一行命令）
打开 PowerShell（管理员）：
wsl --install
它会自动：
- 安装 WSL2
- 下载 Ubuntu
- 设置 Linux 内核
验证安装
wsl -l -v
你应该看到：
Ubuntu Running Version 2
2.3 第二步：初始化 Ubuntu
第一次打开 Ubuntu 会让你：
- 设置用户名
- 设置密码
👉 记住密码（sudo用）
2.4 第三步：安装 Git（唯一必须依赖）
sudo apt update
sudo apt install git -y
验证：
git --version
2.5 第四步：安装 Hermes（核心步骤）
直接运行官方一键脚本：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
这个脚本会做很多事情：
✔ 安装 uv
✔ 安装 Python 3.11
✔ 安装 Node.js
✔ 安装 ffmpeg
✔ clone Hermes
✔ 创建虚拟环境
✔ 注册 hermes 命令
👉 官方明确说明这一点
2.6 第五步：初始化环境
source ~/.bashrc
2.7 第六步：配置 API Key
运行：
hermes setup
或者手动：
nano ~/.hermes/.env
填入：
OPENROUTER_API_KEY=你的key
2.8 第七步：启动 Hermes
hermes
你会进入一个 CLI Agent：
> Hello! What can I help you with?
2.9 Windows 常见坑（非常重要）
❌ 问题1：curl 不存在
sudo apt install curl -y
❌ 问题2：WSL 太慢
解决：
wsl --shutdown
然后重启
❌ 问题3：权限问题
chmod +x install.sh
❌ 问题4：网络问题（中国用户）
建议：
- 使用代理
- 或提前 clone GitHub
2.10 高阶玩法（WSL进阶）
你可以：
- 把 Hermes 跑在后台（screen/tmux）
- 用 Telegram 控制 Agent
- 远程 VPS + 本地 WSL混合
三、macOS 安装 Hermes（原生方案）
macOS 比 Windows 简单很多，因为：
👉 它本质就是 Unix 系统
3.1 环境准备
安装 Git（一般已自带）
git --version
如果没有：
xcode-select --install
3.2 一键安装 Hermes
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
👉 与 Linux 完全一致
3.3 初始化 shell
source ~/.zshrc
（mac 默认 zsh）
3.4 配置 API
hermes setup
3.5 启动
hermes
3.6 mac 常见坑
❌ 问题1：权限问题（macOS 安全机制）
chmod +x install.sh
❌ 问题2：brew冲突
Hermes自带环境，不建议用 brew 安装 Python
❌ 问题3：M芯片兼容
官方支持（uv会自动处理）
四、手动安装（适合开发者）
如果你不信任脚本，可以手动安装：
核心步骤：
git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv venv --python 3.11
export VIRTUAL_ENV="$(pwd)/venv"
uv pip install -e ".[all]"
npm install
👉 官方完整步骤
五、安装完成后你能做什么？
Hermes不是聊天工具，而是：
👉 自进化AI Agent系统
核心能力：
- 自动执行任务
- 长期记忆
- 技能生成
- 多平台控制（Telegram/Discord等）
- 多Agent协作
👉 官方定义：
一个会持续变强的自主Agent
六、安装后推荐配置（非常关键）
6.1 推荐模型
hermes model
建议：
- OpenRouter（最方便）
- OpenAI（稳定）
- Claude（强推理）
6.2 推荐目录结构
~/.hermes/
├── config.yaml
├── .env
├── skills/
├── memories/
6.3 推荐玩法
- 自动写代码
- 自动做SEO
- 自动爬虫
- 自动运营账号
- 自动任务调度（cron）
七、Windows vs Mac 总结对比
| 项目 | Windows（WSL） | macOS |
|---|---|---|
| 安装难度 | ⭐⭐⭐⭐ | ⭐⭐ |
| 兼容性 | 间接 | 原生 |
| 稳定性 | 中 | 高 |
| 推荐程度 | ✔ 可用 | ✔✔ 强烈推荐 |
八、最终结论（非常关键）
如果你只是想"用" Hermes：
👉 用 mac
如果你是 Windows 用户：
👉 必须走 WSL（别折腾原生）