文章总结： 该文档是一篇针对Windows用户的HermesAgent本地部署教程，详细介绍了通过WSL2安装Ubuntu系统、配置网络为Mirrored模式以避免代理问题、使用一键脚本安装HermesAgent及其依赖、配置大模型API密钥以及设置微信网关的完整步骤。教程包含具体的命令行操作和避坑提示，旨在帮助用户一次性成功部署并启动服务。 综合评分： 72 文章分类： 安全工具,安全运营,其他
Windows本地部署Hermes Agent，小白也能一次成功的超详细教程!
原创
释然 释然
释然IT杂谈
2026年4月21日 08:19 上海
在小说阅读器读本章
去阅读
最近被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 命令，这可能导致权限混乱。始终以普通用户身份运行
-
EOF –
另外我给大家整理了一些技术资料有需要直接下载即可
链接：https://pan.quark.cn/s/7063628fb0be
需要什么资料也可在评论区留言
或者添加小编咨询
免责声明：
本文所载程序、技术方法仅面向合法合规的安全研究与教学场景，旨在提升网络安全防护能力，具有明确的技术研究属性。
任何单位或个人未经授权，将本文内容用于攻击、破坏等非法用途的，由此引发的全部法律责任、民事赔偿及连带责任，均由行为人独立承担，本站不承担任何连带责任。
本站内容均为技术交流与知识分享目的发布，若存在版权侵权或其他异议，请通过邮件联系处理，具体联系方式可点击页面上方的联系我。
本文转载自：释然IT杂谈 释然 释然《Windows本地部署Hermes Agent，小白也能一次成功的超详细教程!》
版权声明
本站仅做备份收录，仅供研究与教学参考之用。
读者将信息用于其他用途的，全部法律及连带责任由读者自行承担，本站不承担任何责任。
评论