适配当前 Win10 22H2 + WSL2 Ubuntu22.04 环境，国内加速一键脚本优先，分「一键脚本安装（新手）」「源码手动部署（开发）」两套方案。

前置环境校验（必须完成）

1. WSL2 已启用，使用wms进入Ubuntu 正常登录（用户名不要用 admin，如 admin_、dev）
2. WSL 内安装基础依赖 git

bash

运行

sudo apt update && sudo apt install git -y

1. 启用 systemd（Hermes 网关 / 后台服务必需）

bash

运行

sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

关闭 WSL 重启生效：

powershell

# PowerShell执行
wsl --shutdown
# 重新进入Ubuntu
wsl -d Ubuntu-22.04

方案一：国内镜像一键脚本（推荐，5 分钟自动部署）

1. 执行国内加速安装脚本（规避 GitHub raw 超时）

bash

运行

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

脚本自动完成：

• 安装 uv 包管理器、Python3.11、Node22
• 拉取 Hermes 完整源码 + 子模块
• 自动创建独立虚拟环境、配置全局hermes命令

2. 重载环境变量，让 hermes 命令生效

bash

运行

source ~/.bashrc
# 验证版本，输出版本号即安装成功
hermes --version