---

一、部署前必看（小白必懂）

• Hermes 不支持原生 Windows，必须用 WSL2（Linux 子系统）
• 全程 不需要你提前装 Python/Node/Git，脚本一键装全
• 硬件要求：4核CPU、8G内存（最低）；用本地模型建议 16G+
• 路径不要有中文/空格（重要）
• 所有命令复制粘贴即可，不要手敲错

---

二、第一步：安装 WSL2（一键开启 Linux 环境）

1. 以管理员打开 PowerShell

• 按 Win 键 → 搜 PowerShell → 右键 以管理员身份运行

2. 一键安装 WSL2 + Ubuntu（一行命令）

wsl --install -d Ubuntu

• 自动：开启虚拟化 → 下载 Ubuntu → 安装 Linux 内核
• 必须重启电脑（安装完会提示重启）

3. 重启后初始化 Ubuntu

• 开机自动弹出 Ubuntu 终端
• 输入 用户名（英文小写，如 hermes）→ 回车
• 输入 密码（输入不显示，正常输）→ 再输一遍确认
• ✅ 记住这个密码（后面 sudo 要用）

---

三、第二步：Ubuntu 内一键部署 Hermes（国内镜像，不卡）

1. 先换国内源（加速，必做！）

复制粘贴运行：

sudo sed -i 's/archive.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list
sudo apt update && sudo apt upgrade -y

• 提示输入密码：输你刚才设的 Ubuntu 密码

2. 一键安装 Hermes Agent（国内镜像，小白专用）

curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

脚本自动做：

• 安装 Python 3.11+、Node.js 18+、Git、ripgrep、ffmpeg
• 克隆 Hermes 源码
• 配置虚拟环境
• 注册 hermes 命令

等待 3～8 分钟，出现 Hermes installed successfully 即成功。

3. 刷新环境（必做）

source ~/.bashrc

4. 验证安装

hermes version
hermes doctor

• 显示版本号、所有检查项 ✅ → 成功

---

四、第三步：一键初始化配置（hermes setup）

hermes setup

全程回车+选是，只需要填 1 个信息：API Key

配置流程（小白无脑选）

1. Quick setup (快速配置) → 回车
2. Select model provider（选模型）

   • 小白推荐：阿里云千问

   • 

   • 不推荐：OpenAI（国内难用）

3. Enter API Key
   • 去模型平台（如阿里云百炼、智谱）复制 API Key
   • 粘贴进来（不要有空格/换行）→ 回车
4. Set model name → 直接回车（默认即可）
5. Enable MCP (记忆/工具) → y → 回车
6. Setup complete → 完成

---

五、第四步：启动 & 测试 Hermes

1. 启动

hermes

出现：

Hermes Agent vx.x.x
Welcome! How can I assist you today?

✅ 成功！

2. 测试对话

你好，你是谁？
写一个Python冒泡排序

能正常回答 → 部署完成。

---

六、小白必看：所有注意点 & 避坑（90% 问题都在这）

1. 安装卡住/失败

• 网络问题：必须用国内镜像脚本（上面给的那条），不要用 GitHub 原版
• 权限：全程 PowerShell 管理员、Ubuntu 内用 sudo
• WSL 太慢：重启 WSL

  wsl --shutdown
  

  再重新打开 Ubuntu

2. hermes 命令不存在

• 没运行 source ~/.bashrc → 运行一遍
• 关闭重开 Ubuntu 终端

3. API Key 报错（Invalid key / 401 / 429）

• Key 复制错/多空格/换行 → 重新去平台复制，纯文本粘贴
• 账户没余额/没开通模型 → 去控制台充值/开通
• 速率限制 429 → 换模型或等一会儿

4. 如何改配置（换 Key/模型）

hermes setup

或直接编辑配置文件：

nano ~/.hermes/config.toml

• 修改 api_key → Ctrl+O 保存 → Ctrl+X 退出

5. 关机后如何再次启动 Hermes

• 打开 Ubuntu

hermes

6. 完全卸载（重装用）

rm -rf ~/.hermes ~/hermes-agent

然后重新跑一键安装脚本。

---

七、小白最简总结（3 行核心命令）

# 1. PowerShell管理员
wsl --install -d Ubuntu

# 2. Ubuntu内（重启后）
curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash
source ~/.bashrc

# 3. 初始化+启动
hermes setup
hermes

---

文档下载：https://pan.quark.cn/s/6640b1fa667e