Windows本地部署Hermes Agent，小白也能一次成功的超详细教程!
最近被Hermes Agent种草了，翻了一圈教程——好家伙，全是Linux/macOS的，Windows用户仿佛不存在。行吧，自己动手。
折腾了两天，踩了三个坑，终于跑通了。这篇教程把我踩过的坑都写进去了，照着做基本能一次成功。
一、安装WSL2(关键步骤）
Windows跑Linux环境需要WSL2，别嫌麻烦，这是必经之路。
1.安装 WSL
以 管理员身份 打开 PowerShell，并执行以下命令：
wsl --install
执行完毕后，重启你的电脑
2.选择Ubuntu发行版
重启后进入 PowerShell ，看能装那些发行版：
wsl.exe --list --online
我选的 Ubuntu-20.04：
wsl.exe --install Ubuntu-20.04
注意：系统可能会自动给你装22.04 LTS，不影响后续使用。
wsl.exe --list --verbose
我这里有两个，我需要切换一下 Ubuntu 22.04，命令如下：
wsl --set-default Ubuntu-20.04
3.安装 Linux 发行版（推荐 Ubuntu）
1).打开 Microsoft Store (微软应用商店)
2).搜索 “Ubuntu”
3).选择 “Ubuntu 20.04 LTS” (或最新 LTS 版本)，点击 “获取” 进行安装
4.初始化 Ubuntu
开始菜单启动Ubuntu，第一次会让你创建用户名密码——一定要记住，和你的Windows账户无关。
⚠️ 踩坑预警：网络设置（必看！）
安装完会弹出一个"适用于Linux的Windows子系统"设置窗口。
千万别选默认的NAT模式！
NAT模式下网络独立，你电脑挂了代理WSL2也用不了，后面下载东西会卡死。
必须选Mirrored模式——这样WSL2会直接用你Windows的网络配置。
另外两个选项也打开：
关闭防火墙
启用localhost转发
自动代理开启
改完重启电脑。
二、在 WSL2 里安装 Hermes Agent
现在操作环境切换到了 WSL2 的 Ubuntu 终端
1.一键安装脚本
在 Ubuntu 终端中粘进去跑就行(Linux / macOS同理)：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
这个脚本会自动搞定：
-
-
安装 uv (超快的 Python 包管理器)
-
-
-
安装 Python 3.11+
-
-
-
克隆 仓库
-
-
-
创建虚拟环境
-
-
-
安装所有依赖
-
2.生效配置
装完后重载一下：
# 对于 Bash 用户
source ~/.bashrc
# 对于 Zsh 用户（如果你已切换）
source ~/.zshrc
验证一下：
hermes --version
能显示版本号就成功了：
3.配置大模型
运行设置向导：
hermes setup
选Quick setup（够用了）
选模型提供商
如 OpenAI, Anthropic, OpenRouter, 或国内便宜好用的大模型
输入对应的 API Key
选择一个默认模型（如 gpt-4o, claude-3-5） 我选择一个便宜的minimax-m2.5
获取 API Key 的简单方法（以 OpenRouter 为例）：
-
-
注册账号去https://openrouter.ai
-
-
-
充值一点钱（几美元就够用很久）
-
-
-
在 dashboard 里复制你的 API Key（一串很长的字符）
-
4.配置聊天软件（以 wx为例）
来到这个页面我们选择 Set up messaging now
-
-
Set up messaging now（推荐）— 现在就绑定平台，装完即可使用
-
-
-
Skip — 跳过，之后用 hermes setup gateway 命令再配置
-
我们选择wx
提示是否通过二维码完成配置。
点击链接，并用微信扫码，即可进入微信ClawBot页面
选择推荐的第一项即可。接下来也都选择默认选项。
这样就完成微信的配置了。 然后，我们执行如下命令安装网关。
hermes gateway install
最后，启动hermes服务。
hermes gateway start
使用
hermes gateway status
命令查看一下运行状态。 看到绿色的running，说明启动成功 去微信里跟它说句话。
避坑提示：
-
-
网络问题：如果 curl 命令卡住或失败，很可能是网络问题。请确保你的 WSL2 能正常访问 GitHub。必要时可配置 Git 代理
-
-
-
权限问题：不要在 WSL2 中使用 sudo 来运行 hermes 命令，这可能导致权限混乱。始终以普通用户身份运行
-
