一、前期准备

1. 电脑开启CPU虚拟化（任务管理器-性能-CPU查看已启用）
2. D盘新建文件夹：D:\\\\WSL
3. 关闭电脑360/管家，避免拦截权限

---

第一步：管理员PowerShell开启WSL2功能

这是windows安装WSL官方文档

Install WSL

1. 右键开始菜单 → Windows终端(管理员) / PowerShell管理员
2. 依次执行两行命令

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

1. 立刻重启电脑（不重启必报错）

第二步：安装WSL2内核+设定默认WSL2

1. 浏览器搜索下载：wsl_update_x64.msi 微软官方内核包，双击安装（安装文件关联有问题的，在powershell里运行这个

msiexec /i "D:\\WSL\\wsl_update_x64.msi"

再PowerShell执行

wsl --set-default-version 2

第三步：手动把 Ubuntu 22.04 安装到 D 盘

在管理员 PowerShell 中依次执行：

# 1. 创建 Ubuntu 存放目录（全在D盘）
mkdir D:\\\\WSL\\\\Ubuntu

# 2. 导入系统到D盘（注意文件名和你下载的一致）
wsl --import Ubuntu D:\\\\WSL\\\\Ubuntu D:\\\\WSL\\\\ubuntu-22.04-root.tar.gz

如果提示文件不是 .tar.gz 而是 .tar.xz，请把文件名改成对应的一致。

1. 检查是否成功：

wsl -l -v

看到 Ubuntu 显示 版本 2 就成功了！

第四步：进入 WSL 并创建普通用户

# 进入Ubuntu
wsl -d Ubuntu-22.04

进入后执行以下命令（一次性复制粘贴）：

NEW_USER=royce（记得换成你的用户名）
useradd -m -s /bin/bash $NEW_USER
passwd $NEW_USER
usermod -aG sudo $NEW_USER
tee /etc/wsl.conf > /dev/null << EOF
[user]
default=$NEW_USER
EOF
exit（这是退出

退出后重新进入：

wsl -d Ubuntu-22.04

---

第五步：WSL 内部国内加速

# 换阿里云源-一行一行粘贴-WSL粘贴ctrl+v不行 鼠标右键粘贴就行
sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
sudo sed -i 's|archive.ubuntu.com|mirrors.aliyun.com|g' /etc/apt/sources.list
sudo sed -i 's|security.ubuntu.com|mirrors.aliyun.com|g' /etc/apt/sources.list

sudo apt update && sudo apt upgrade -y

---

# 安装Git
sudo apt install -y git
git config --global user.name "你的名字"
git config --global user.email "你的邮箱@qq.com"

安装可选方法1

用ghproxy镜像代理执行官方安装脚本

curl -fsSL <https://mirror.ghproxy.com/https://raw.githubusercontent.com/NousResearch/HermesAgent/main/install.sh> | bash

等待自动安装：uv、Python、Node、Playwright全套依赖 Playwright下载浏览器慢是正常现象，千万别终止！

作者用的此方法2（安装比较快 需要魔法记得开TUN模式

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

安装完后出现界面

第六步：安装完后生效配置

source ~/.bashrc

第七步：找到你需要配置API的官方文档查看如何接入

选择模型厂商

1. 粘贴你的API Key
2. 填写代理接口BaseURL
3. 接入成功后出现图标

那么日常如何进入

Powershell执行

hermes
# 或
~/.local/bin/hermes

第八步：如果你想省 Token 优化

进入对话后输入：

/config delegation.orchestrator_enabled false
/config agent.max_turns 30

踩了很多坑总结出来的，希望能帮到大家吧