Windows 安装部署 Hermes Agent 喂饭级教程前言Hermes Agent 作为当前最火的自进化 AI 智能体凭借自动学习技能、持久记忆、越用越聪明的特性火爆整个开源社区。虽然 Hermes Agent 官方原生支持 Linux 和 macOS但通过 Windows Subsystem for Linux (WSL2)我们完全可以在 Windows 上获得丝滑、原生般的体验Windows 用户安装Hermes不支持原生 Windows必须通过 WSL2 运行。为什么必须用 WSL2根据官方文档和社区实践Hermes Agent 是一个基于 Python 的复杂系统重度依赖 Linux 环境下的工具链如 uv、特定的系统库、systemd 进程管理等。直接在 Windows 原生命令行CMD/PowerShell或 Git Bash 中安装几乎肯定会失败。WSL2 在 Windows 内核上运行一个完整的 Linux 内核为你提供了一个与 Ubuntu 等发行版几乎无异的开发环境是目前在 Windows 上运行 Hermes Agent 唯一可靠且官方推荐的方式。本文将带你开启 WSL2 → 安装 Ubuntu → 一键部署 Hermes → 配置大模型全程避坑、亲测可跑通使用。一、重要说明必看Hermes Agent官方不支持原生 Windows仅支持 Linux/macOSWindows 唯一稳定安装方案WSL2 Ubuntu 22.04一键脚本自动安装Python/Node.js/uv/依赖全搞定支持飞书、微信、QQ、钉钉、Telegram 等多平台接入支持国内模型DeepSeek、MiniMax、Kimi、通义千问、智谱 GLM二、环境准备Windows 10 1903 以上 / Windows 11已开启虚拟化BIOS 开启或笔记本默认开启管理员权限有网络三、第一步安装并配置 WSL21. 启用 WSL 与虚拟机平台以管理员身份打开 PowerShell执行# 启用 适用于 Linux 的 Windows 子系统 可选功能dism.exe/online/enable-feature/featurename:Microsoft-Windows-Subsystem-Linux/all/norestart# 启用 虚拟机平台 可选功能dism.exe/online/enable-feature/featurename:VirtualMachinePlatform/all/norestart✅执行完必须重启电脑这一步很关键不重启的话后面的 WSL 2 设置或 Ubuntu 转换可能会出现各种奇怪问题。2. 设置 WSL2 为默认版本重启后打开 PowerShell# 将 WSL2 设置为默认版本wsl--set-default-version 2这条命令的作用是让后续新安装的 Linux 分发版默认使用 WSL 2。3. 安装 Ubuntu可以直接在微软商店搜索Ubuntu 22.04 LTS安装也可以使用命令来安装微应用商店安装打开 Microsoft Store (微软应用商店)。搜索 “Ubuntu”。选择 “Ubuntu 22.04 LTS” (或最新 LTS 版本)点击 “获取” 进行安装。初始化 Ubuntu安装完成后在开始菜单中启动 “Ubuntu”。首次启动会要求你创建一个 Linux 用户名和密码这与你的 Windows 账户无关请牢记。初始化完成后你就拥有了一个功能完备的 Linux 终端 避坑提示如果国内网络不好可能会遇到网络问题导致安装缓慢或失败。可以使用下面的命令行来安装尝试在 PowerShell 中使用wsl --install -d Ubuntu-22.04 --web-download并配合系统代理如果有的话。此外安装后建议立即更换国内源如清华源以加速后续操作。命令行安装以管理员身份打开 PowerShell执行# 安装最新版本wsl--install#指定版本安装wsl--install-d Ubuntu-22.04--web-download执行完后通常需要重启电脑。重启后再打开终端第一次进入 WSL 时系统会让你完成 Ubuntu 用户名和密码初始化。这个密码是你在 Linux 环境里的本地密码务必记住后面执行 sudo 时会用到。✅ 为什么选 22.04 LTS该版本是 Hermes Agent 官方测试矩阵中的标准环境兼容性最佳社区问题最少。4. 验证 WSL2 版本wsl-l-v看到 VERSION 为 2 即成功。3. 启动 Ubuntu在 Windows 左下角开始菜单中找到 Ubuntu。为了减少权限相关的问题我这里选择以管理员身份运行。进入 Ubuntu 后就可以开始安装 Hermes 了。四、Ubuntu 内一键安装 Hermes打开 Ubuntu 终端执行1. 更新系统可选但是推荐执行sudoaptupdatesudoaptupgrade-y这一步主要是避免系统包太旧后面装东西时出一些奇奇怪怪的问题。这能确保你拥有最新的安全补丁和库文件避免潜在的依赖冲突。2. 官方一键安装核心命令curl-fsSLhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh|bashInstall ripgrepforfasterfilesearch ffmpegforTTS voice messages?[Y/n]y 这里会有个提示安装可选的工具ripgrep和ffmpeng输入y, 这里我一并安装了安装ripgrep以加快文件搜索速度安装ffmpeg以处理TTS语音消息 脚本跑完之后会进入配置阶段配置大模型QQ/微信等这里可以直接配置也可以选择自定义先跳过。 最后提示要不要启动 Launch hermes chat now?[Y/n]: n 这里我没有直接启动 提示加载环境变量 Reload your shell to usehermescommand:source~/.bashrc如果网络不佳脚本安装不顺利可以执行这个使用国内源安装curl-fsSLhttps://res1.hermesagent.org.cn/install.sh|bash-x这个命令做的事情比较多。安装 uv超快的 Python 包安装器和虚拟环境管理器安装 Python 3.11克隆 Hermes Agent 仓库到 ~/hermes-agent创建并激活虚拟环境安装所有依赖包括 ripgrep, ffmpeng, fd-find 等高效工具将 hermes 命令添加到你的 PATH3. 重载环境变量source~/.bashrc4. 验证安装hermes--versionHermes Agent v0.13.0 (2026.5.7)出现版本号即安装成功五、配置大模型提供商 API关键执行配置命令向导hermes setup在交互式界面中选择你的模型提供商如 OpenAI, Anthropic, OpenRouter, 或国内的大模型如 MiniMax、阿里云百炼、智谱 GLM。输入对应的 API Key。选择一个默认模型(这里我使用的是国内的MiniMax价格比较便宜速度也快)支持主流厂商选一个即可OpenRouterDeepSeekMiniMaxKimi / Moonshot智谱 ZAi / GLM通义千问OpenAI配置内容API Key模型名称如MiniMax-M2.7BASE_URL六、接入飞书机器人可选后续文章详细讲解敬请持续关注先大概介绍下飞书接入。1. 飞书开放平台创建应用开启机器人权限im:message:send_as_botim:message:readcontact:user:readonly2. 获取 AppID AppSecret3. 执行网关配置hermes gateway setup选择feishu输入 AppID、AppSecret连接模式选websocket无需公网IP4. 审批配对用户hermes pairing approve feishu 你的飞书ID七、启动与使用Hermes1. 启动 Hermes 对话hermes输入想要问的问题直接可以对话了2. 启动网关飞书/QQ/微信hermes gateway run3. 打开 Web 控制面板hermes dashboard访问http://127.0.0.1:9119八、Windows 部署可能遇到的 9 个坑❌ 不能在 PowerShell 直接装必须进 Ubuntu❌ 不能用 root 安装必须普通用户❌ 网络失败换国内源或加速❌ 命令不存在执行source ~/.bashrc❌ 飞书收不到消息检查长连接、权限、审批❌ 模型调用失败检查 API Key、模型名称、Endpoint❌ WSL 安装失败开启虚拟化、更新 Windows❌ 安装卡住CtrlC 重试换国内安装脚本❌ 卸载不干净使用hermes uninstall九、从 OpenClaw 一键迁移hermes claw migrate自动迁移配置、记忆、技能十、一键卸载 Hermeshermes uninstall选择 2 完全卸载十一、总结Windows 部署 Hermes Agent 唯一正确路线WSL2 → Ubuntu 22.04 → 一键脚本 → 模型配置 → 网关接入就能拥有一个会自我进化、7×24 小时在线的 AI 智能体可写代码、读文档、做自动化、接 IM 机器人。参考链接https://cloud.tencent.com/developer/article/2655093https://blog.csdn.net/weixin_41903114/article/details/160346490https://blog.csdn.net/landonzeng/article/details/160230691