Windows部署Hermes Agent并接入微信：模型配置、Gateway消息入口和Web控制台都跑通

前言

很多AI助手已经能写文案、查资料、改代码，但真正到了本地电脑操作这一层，体验往往还是断开的：AI给出步骤，人再自己切窗口、找文件、执行命令。只要任务需要碰到Windows里的文件、终端或软件，最后那一步通常还得自己完成。

Hermes Agent提供的是另一种路径。它不只负责理解指令，还可以接入本地运行环境和工具，把“告诉我怎么做”继续往前推到“由电脑实际执行”。

这篇先在Windows原生环境安装Hermes Agent，完成模型API配置和本地对话测试，再把Gateway接入微信。接入成功以后，微信就可以作为远程发送任务的入口，Hermes Agent则继续在Windows电脑上处理对应任务。

这样做以后，远程发指令和本地真正执行不再挤在同一个界面里：微信负责把任务送进来，Windows仍然保留完整的本地环境。

后面还会部署hermes-web-ui，把原本依赖终端和聊天消息查看的状态、配置和对话记录放进浏览器页面里，方便日常管理。

最后再通过cpolar让这个Web控制台可以从外部网络访问。整篇真正跑的是Windows部署Hermes Agent → 配置模型 → 接入微信 → 让Agent在本机执行任务 → 部署Web UI → 外部浏览器继续管理这条链，重点是把“聊天里的AI”继续接到真实Windows环境里。

1 什么是Hermes Agent？

Hermes Agent 是 Nous Research 开源的一个 AI Agent 框架。它不是单纯的聊天机器人，而是让大模型可以接入真实运行环境，通过消息、工具、终端和技能来处理任务的智能体系统。

简单来说，它有几个比较核心的特点：

• 支持通过 Gateway 接入外部消息平台，比如微信、飞书、企微等。
• 支持配置不同的 模型 API，让大模型负责理解指令和生成执行方案。
• 支持调用 工具、终端、文件、技能 等能力，不只是停留在文字回复。
• 可以运行在本地电脑、服务器或 NAS 这类设备上，适合做长期在线的 AI 助手。

在这篇文章里，可以先把它理解成：

Hermes Agent 负责接收外部消息，再把任务交给本地Windows环境去处理。

2 在Windows上安装Hermes Agent

2.1 安装hermes

现在 Hermes Agent 已经支持在 Windows 原生环境中安装，不再必须依赖 WSL。我们可以直接通过 PowerShell 执行官方安装脚本完成部署。

我们只需电脑按Win+X键，选择终端，打开powershell终端：

然后执行图片中的这条命令即可：

iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)

如下图：

2.2 配置hermes

等待安装完成,如果你的电脑安装过openclaw，会出现如下提示:

可以输入【Y】选择查看，这里我们以全新配置为例，所以输入【N】继续安装流程：

接着来到了快速开始的步骤，直接默认回车即可，回车后就会来到如下大模型配置部分：

这里以DeepSeek为例，输入【15】进行回车，然后可以看到需要输入DeepSeek的API key ：

访问deepseek的官网的apikeys页面，创建一个apikey即密钥(确保你的账号要有余额):

https://platform.deepseek.com/api_keys

复制下来（注意只会显示一次），然后填写到终端中，baseurl直接回车，然后选择一个模型，这里选择【4】，也就是【deepseek-v4-pro】的模型：

接着来到选择终端后端的配置项，默认本地即可，直接回车：

然后会来到是否配置消息平台，这里先暂时跳过，输入【2】回车，后面再配置：

出现如下提示，且可以看到退出了交互模式了，代表hermes已经初始化且配置完成了：

2.3 启动并对话测试

继续在当前窗口，直接输入如下命令，进行启动hermes：

hermes

如下图：

接着直接在终端输入一句对话，测试一下它是否会回应：

你好，你是谁，你当前运行在什么操作系统上，接入的大模型是什么？

如下图:

能够正常返回回答以后，说明基础配置已经完成。接着输入如下命令退出：

/exit

退出以后，就可以继续配置消息平台。

3 将hermes接入到微信

前面已经确认了hermes可以正常对话了，接下来输入如下命令，进行配置消息平台：

hermes gateway setup

如下图：

输入【12】然后进行回车，回车后会询问是否开始扫码登录，直接回车【Y】即可：

回车后，可能终端不会显示二维码，但是会给一个链接，跳转浏览器打开，然后进行扫码登录即可：

接着，登录后，按照hermes默认推荐的直接回车即可：

然后再进行【4】次回车，可以看到网关处于运行中了：

接着，等待片刻，在微信中搜索进入和【微信ClawBot】进行对话：

你好，你是谁？

微信端能够正常收到回复后，说明Hermes Agent已经完成消息平台接入。

4 安装hermes web ui控制台管理工具

hermes-web-ui 是一个面向 Hermes Agent 的可视化 Web 控制台。它的作用不是替代 Hermes Agent 本身，而是为 Hermes Agent 提供一个基于浏览器的交互和管理入口，让原本主要依赖终端、配置文件和后台日志完成的操作，变得更加直观。

简单来说，Hermes Agent 负责在后台运行和处理任务，hermes-web-ui 负责把这些能力通过 Web 页面展示出来。通过它，可以在浏览器中进行对话测试、配置查看、运行观察和日常调试。

这里再验证一个实际用法：不手动执行安装命令，而是直接把安装需求描述给Hermes Agent，让它在本机完成环境检查、安装和启动。

我们可以直接把下面这段提示词发送给 Hermes Agent：

请帮我在当前设备上安装 hermes-web-ui。先检查 Node.js 和 npm 是否可用，如果环境正常，就使用 npm 全局安装 hermes-web-ui。安装完成后启动 hermes-web-ui，并告诉我本地和局域网访问地址还有登录的密码是什么，并且告诉我如何修改密码。如果端口被占用，请先提示我，不要删除任何文件。

这里我直接在 Hermes Agent 的终端对话模式中发送这段提示词。如果你已经把 Hermes Agent 接入了飞书、微信、企微等消息平台，也可以直接在对应平台里发送：

安装完成后，浏览器会打开hermes-web-ui页面；如果没有自动打开，也可以手动输入访问地址。

让我们点击登录按钮进行登录一下：

登录以后，可以看到之前与Hermes Agent的对话记录，后续也可以继续进行模型切换、消息平台配置和运行查看：

到这里，Hermes Agent已经有了一个独立的可视化管理入口。

5 下载安装cpolar

前面我们已经把 hermes-web-ui 跑起来了，在浏览器里也能正常打开 Hermes Agent 的 Web 控制台。这样一来，平时查看对话、检查任务、调整配置都会方便很多，不用再只靠聊天软件里的回复结果来判断它有没有正常工作。

不过这里还有一个很现实的问题：这个 Web 控制台目前只能在本地网络里访问。 简单来说，在家里、办公室，或者和 Hermes Agent 处在同一个网络下时才可以正常打开；但如果出门在外，手机切到流量，或者人在公司，就没办法直接访问这个页面了。

所以接下来，我们就用 cpolar 内网穿透 给 hermes-web-ui 生成一个公网访问地址。这样即使 Hermes Agent 还跑在家里的电脑、NAS 或者内网设备上，我们也可以在外面通过浏览器打开它的 Web 控制台，随时查看和管理这个 AI 助手。

5.1 什么是cpolar?

• cpolar 是一款内网穿透工具，可以将你在局域网内运行的服务（如本地 Web 服务器、SSH、远程桌面等）通过一条安全加密的中间隧道映射至公网，让外部设备无需配置路由器即可访问。
• 广泛支持 Windows、macOS、Linux、树莓派、群晖 NAS 等平台，并提供一键安装脚本方便部署。

5.2 安装cpolar

打开cpolar官网的下载页面，点击立即下载 64-bit按钮,下载cpolar的安装包:

下来下来是一个压缩包,解压后执行目录种的应用程序,一路默认安装即可,安装完成后,打开cmd窗口输入如下命令确认安装:

cpolar version

出现如上版本即代表安装成功!

5.3 注册及登录cpolar web ui管理界面

访问cpolar官网，点击免费注册按钮，进行账号注册

进入到如下的注册页面进行账号注册：

注册完成后,在浏览器中输入如下地址访问 web ui管理界面:

http://127.0.0.1:9200

输入刚才注册好的cpolar账号登录即可进入后台页面:

6 穿透hermes web ui以实现公网访问

cpolar安装并登录完成以后，下一步就是把本地运行的Hermes Web UI服务通过cpolar映射出去，让浏览器从局域网之外也能访问这个控制台。

6.1 随机域名方式(免费方案)

随机域名方式适合预算有限的用户。使用此方式时，系统会每隔 24 小时 左右自动更换一次域名地址。对于长期访问的不太友好，但是该方案是免费的，如果您有一定的预算，可以查看后面大纲的固定域名方式，且访问更稳定。

点击左侧菜单栏的【隧道管理】，展开进入【隧道列表】页面，页面下默认会有 2 个隧道：

• remoteDesktop隧道，指向3389端口，tcp协议
• website隧道，指向8080端口，http协议（http协议默认会生成2个公网地址，一个是http，另一个https，免去配置ssl证书的繁琐步骤）

点击编辑【website】的隧道，随意设置一个隧道名称,协议选择【http】,本地地址填写Hermes Web UI 的访问端口【8648】，地区这里选择的【China Top】，最后点击更新：

接着，点击左侧菜单的【状态】菜单，接着点击【在线隧道列表】菜单按钮，可以看到有2个【hermes-web-ui】的隧道，一个为http协议,另一个为https协议:

接下来在浏览器中访问hermes-web-ui隧道生成的公网地址（http和https皆可），这里以https为例：

公网地址已经能够打开hermes-web-ui登录页面。

注意：Web 控制台映射到公网后，一定要修改默认密码，并设置强密码。建议不要使用简单密码，避免控制台被他人访问。

6.2 固定域名方式

前面的随机域名已经能够完成远程访问，但地址会发生变化。如果这个控制台需要长期保存到书签或固定设备中，继续配置固定二级子域名会更方便。

下面继续配置固定二级子域名。

首先，进入官网的预留页面:

https://dashboard.cpolar.com/reserved

选择【预留】菜单，即可看到【保留二级子域名】项，填写其中的【地区、名称、描述（可不填）】项，然后点击保留按钮，操作步骤图如下：

列表中显示了一条已保留的二级子域名记录：

• 地区：显示为China Top。
• 二级域名：显示为hermesui01。

注：二级域名是唯一的，每个账号都不相同，请以自己设置的二级域名保留的为主

接着，进入侧边菜单栏的【隧道管理】下的【隧道列表】，可以看到名为【hermes-web-ui】的隧道，点击【编辑】按钮进入编辑页面：

修改域名类型为【二级子域名】，然后填写前面配置好的子域名，点击更新按钮：

接着来到【状态】菜单下的【在线隧道列表】可以看到隧道名称为【hermes-web-ui】的公网地址已经变更为【二级子域名+固定域名主体及后缀】的形式了：

这里以https协议做访问测试:

固定地址能够正常打开以后，再登录测试一次：

成功登录后，说明固定二级子域名已经生效。后续无论在家里、公司还是外地，都可以通过这个固定地址访问 Hermes Web UI 控制台。

总结

这篇真正完成的是一条“消息入口连接本地电脑”的Hermes Agent使用链：先在Windows原生环境安装Hermes Agent，完成模型API配置和本地对话测试，再通过Gateway把它接入微信。

接入微信以后，任务入口和执行环境被拆成了两部分：人在微信里发送指令，Hermes Agent继续在Windows电脑上处理任务。后面让Agent自己安装hermes-web-ui，也进一步验证了它不只负责聊天，还可以在本机执行实际操作。

Web UI补上的是管理入口。对话记录、配置和运行情况不必只在终端或聊天窗口里查看，而是可以统一放到浏览器页面中继续管理。

最后通过cpolar把hermes-web-ui提供给外部网络访问以后，这套方案就形成了两个不同入口：微信负责随手发任务，Web UI负责查看和管理。Windows电脑仍然是实际执行环境，Hermes Agent则处在消息与本地操作之间，负责把远程指令继续落到真实任务上。