没有魔法不能安装HermesAgent？不存在！简单几步让你轻松驾驭Hermes无魔法部署

这是一份面向 Windows 用户的 Hermes Agent 无魔法部署实操指南，涵盖 Node.js、Codex、WSL、Ubuntu、Hermes 本体安装以及 Weixin 网关接入。

今天给大家分享一个不需要“魔法”也能部署 Hermes Agent 的方法。按照这篇教程走，只需要几步，就可以把 Hermes 在本地跑起来。

这篇教程完全按照实际操作顺序来写，你可以直接对照截图一步一步完成。

一、先准备基础环境

基础准备：开始安装前，请先下载本文提供的 HermesAgent 离线包： 点击下载离线包

后续步骤需要使用这个离线包，请提前保存到本地。

在正式安装 Hermes 之前，建议先把基础环境准备好，尤其是：

Node.js

npm

Codex

可用的 Base URL 和 API Key

二、安装 Node.js

第一步：先搜索并打开 Node.js 官网

先在浏览器里搜索 node js，打开 Node.js 官方首页。这里建议直接进入官网，不要随便下载第三方站点提供的安装包。

第二步：点击获取 Node.js

进入官网后，点击下载入口，准备获取 Windows 版本安装包。

第三步：下载 Windows 安装包

选择适合 Windows 的安装包下载，建议优先使用官网提供的稳定版本。

第四步：运行 Node.js 安装包

下载完成后，双击安装包，按提示完成安装。这里不用做复杂配置，按默认流程安装即可。

第五步：在 PowerShell 中验证 Node 和 npm

安装完成后，打开 PowerShell，执行：

node -v
npm -v

如果都能正确输出版本号，说明 Node.js 和 npm 已经安装完成，后面的 Hermes 相关脚本才能继续运行。

三、先安装 Codex，方便后续排错

这一步非常重要。

先安装 Codex，并不是因为安装 Hermes 必须依赖它，而是为了在你后续安装过程中一旦遇到报错、依赖问题或者命令执行失败，可以直接把报错内容发给 Codex，让它帮你快速定位并修复。

本次视频里的安装流程整体比较顺利，所以实际上没有用到 Codex 介入修复，但我仍然建议你先装好，这样真正遇到问题时会省很多时间。

第六步：先准备 Codex 离线安装文件

进入 hermes-offline 目录后，可以看到提前准备好的 Codex 安装文件，包括安装脚本、配置脚本和离线包。

第七步：运行 Codex 安装脚本

双击运行 install-codex-windows-x64.cmd，等待脚本运行结束并自动关闭。

第八步：验证 Codex 是否安装成功

安装完成后，可以打开终端验证 Codex 是否已经可用。只要能正常进入 Codex 或显示帮助信息，就说明安装成功。

第九步：运行 Codex 初始化配置

接着双击运行 run-codex-setup.cmd，完成 Codex 的初始化配置。

第十步：在 SuperAIAPI 创建令牌，复制 Base URL 和 API Key

这一步要先把后面 Hermes 配置要用到的接口信息准备好。

在 https://superaiapi.com/创建新的令牌，并复制：

Base URLhttps://superaiapi.com/v1

API Key

这两个信息后面配置 Hermes 时都会直接用到。

第十一步：在 hermes-offline 目录里运行 Codex 验证配置

成功后先最小化备用。这样后面如果 Hermes 安装过程中出现任何报错，就可以直接让 Codex 帮你分析和修复。

四、安装 WSL 与 Ubuntu

Hermes 这套无魔法部署流程里，还需要先准备 Ubuntu 运行环境。

第十二步：先运行 WSL 安装程序

开始安装 wsl-ubuntu 运行环境，先运行 wsl2.7.1.0.x64。

这一步相当于先把后面要用到的 WSL 运行组件准备好。

第十三步：运行第一条命令，然后重启电脑

在 PowerShell 中运行下面这条命令：

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

这条命令的作用，是启用 Windows 的 VirtualMachinePlatform 功能，为后续安装 WSL / Ubuntu 做准备。

命令执行完成后，按教程重启电脑。

第十四步：运行第二条命令，安装 Ubuntu 并创建账户和密码

重启完成后，继续执行：

wsl --install -d ubuntu

这条命令会自动安装 Ubuntu 子系统，并在最后要求你创建默认 Linux 用户名和密码。

截图里就已经进入了创建默认账户的界面。

五、正式安装 Hermes Agent

第十五步：双击运行 install-hermes-agent 脚本

开始正式安装 Hermes Agent。这个脚本会把 Hermes 相关环境和依赖整理到当前部署流程里。

第十六步：等待脚本运行完成，按任意键退出

这一步主要是等待安装脚本跑完。脚本执行结束后，按任意键退出即可。

第十七步：在开始菜单里打开 Ubuntu

安装完成后，从开始菜单打开 Ubuntu，后面的 Hermes 配置会在 Ubuntu 环境中完成。

六、配置 Hermes 模型入口

第十八步：运行 hermes 开始配置

进入 Ubuntu 之后，先运行：

hermes

截图里可以看到，Hermes 提示当前还没有配置 provider 或 API key，并询问是否立刻进入 setup。

这说明 Hermes 已经成功安装，只是还没完成模型入口配置。

第十九步：选择 custom endpoint

在模型提供方选择界面中，选择 custom endpoint。

这一步的意思是，不直接用内置供应商，而是手动接入你自己的 OpenAI 兼容接口。

第二十步：输入之前准备好的 Base URL 和 API Key

把前面在 superaiapi 中准备好的配置填进去。

截图里已经能看到 Hermes 正在提示输入：

Base URLhttps://superaiapi.com/v1

API Key

这一步填对了，后面模型列表才能正常加载出来。