Hermes Agent是当前AI圈最火爆的开源自进化智能体框架，它能像真人助手一样记住你的偏好、自动沉淀技能，并可通过飞书、企业微信等平台随时调用。本文将手把手教你完成Hermes Agent的完整安装部署，详细讲解如何接入飞书机器人，并提供个人微信与企业微信的接入方案。无论你用Linux、Mac还是Windows，都能找到最适合自己的部署路径。

说实话，现在AI Agent项目多得眼花缭乱，但Hermes Agent是真的让我眼前一亮。它跟普通聊天机器人最大的不同，就是会“自我进化”——每次帮你处理完任务，它会自动把经验沉淀成技能，下次再遇到类似问题就不用从头教它了。用官方的说法就是“越用越懂你，越用越聪明”。

这套学习闭环很有意思：当你让它完成一个复杂任务（比如写一个爬虫脚本），它会自动总结成结构化的技能文件存在本地。下次再调用时，如果发现了更优的方法，它还会自动用patch工具精准地修改这个技能，不断进化。这就好比你带了个实习生，教一遍之后他自己就能举一反三，甚至还能自己琢磨出更好的方法。

另一个让我觉得实用的点是持久化记忆。以前用AI助手最烦的就是每次都得重新交代背景——项目结构讲一遍，偏好讲一遍，上次踩过的坑还得再讲一遍。Hermes能跨会话记住这些信息，几周后它还记得你的工作目录和常用设置，不用你重复说明。

截至目前，Hermes Agent在GitHub上已经狂揽超过52,800颗星，支持接入飞书、企业微信、Telegram、Discord等15+种消息平台，还能调用200多种大模型。项目虽然2026年2月才开源，但热度蹿升速度确实惊人。

在开始动手之前，咱们先把准备工作做好。

操作系统支持情况：

Hermes官方优先推荐Linux环境，但也支持macOS、Windows WSL2以及Android Termux。特别注意：原生Windows目前不支持，Windows用户必须安装WSL2才能运行。

硬件配置建议：

• 最低配置：1核1GB内存（配合外部大模型API使用）
• 推荐配置：2核4GB以上内存，建议选择4GB以获得流畅体验
• 如果要在本地跑大模型，需要16GB以上内存或显存

前置依赖：

实际上你几乎什么都不用装——官方的一键安装脚本会自动搞定Python 3.11、Node.js v22、ripgrep、ffmpeg等所有依赖，你只需要确保系统里装了git就行。以Ubuntu为例，一句命令搞定：

sudo apt update && sudo apt install git -y 

安装方式有好几种，我按推荐程度排个序，你可以根据自己的情况选。

方式一：一键脚本安装（最推荐，新手首选）

这是官方推荐的方式，一句命令完成全部安装，适合绝大多数人。在Linux、macOS或WSL2终端中执行：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash 

安装脚本会自动完成：检测/安装Python、Node.js、ripgrep、ffmpeg，创建独立的Python虚拟环境，克隆代码仓库，安装所有依赖包，最后把hermes命令添加到系统路径。整个过程大概3-5分钟，喝杯咖啡就搞定了。

安装完成后，重新加载shell环境并验证：

source ~/.bashrc hermes doctor 

如果看到类似下面这样的输出，说明安装成功：

✓ Python 3.11.9 ✓ Node.js v22.4.0 ✓ uv 0.4.1 ✓ ripgrep 14.1.0 ✓ ffmpeg 6.1.1 ✓ ~/.hermes 目录结构 ⚠ 未检测到 API Key，请运行 hermes setup 

方式二：云端一键部署（适合不想折腾环境的朋友）

如果你不想在自己电脑上装一堆东西，或者希望Agent能7×24小时在线，可以考虑直接部署到云服务器。目前腾讯云和阿里云都支持一键部署。

腾讯云Lighthouse：直接选购轻量应用服务器时选择Hermes Agent镜像，推荐2核4GB配置。服务器创建完成后，通过Web终端进入环境，执行hermes setup配置模型即可。

阿里云计算巢：访问HermesAgent社区版服务，按页面提示填写参数，系统会自动完成资源编排、环境初始化及核心组件安装。部署完成后（通常3-5分钟），远程连接ECS执行hermes即可开始交互。

云端部署的好处很明显：与本地电脑隔离更安全，7×24小时在线，随时随地通过聊天软件与Agent交互，不受限于本地电脑。

方式三：Windows WSL2部署（Windows用户必读）

Windows用户一定要走这条路，别图省事去试原生脚本，兼容性问题会让你怀疑人生。步骤如下：

第1步：以管理员身份打开PowerShell，运行：

wsl –install 

安装完成后重启电脑，WSL2会自动安装Ubuntu发行版。

第2步：打开Ubuntu应用，设置用户名和密码，然后执行官方一键安装脚本（同上）。

第3步：安装完成后重新加载并验证。

安装完成后，Hermes还是个空壳，需要给它接入一个大模型才能干活。执行以下命令进入配置向导：

hermes setup 

向导会依次引导你完成模型选择和工具配置。支持的模型提供商非常丰富，包括OpenAI、Anthropic Claude、阿里云DashScope、智谱GLM、Kimi、DeepSeek、MiniMax，以及本地运行的Ollama模型等。

如果你用的是云端部署，可以直接选择通过OpenRouter接入，它是一个聚合了200+模型的平台，对国内用户比较友好。选择好提供商后，填入对应的API Key，向导会验证连接是否正常。

另外值得一提的是，如果你之前用过OpenClaw，Hermes内置了迁移命令，可以一键导入设置、记忆、技能和API密钥，过渡成本非常低。

一直用终端聊天终究不太方便。把Hermes接入飞书后，你就可以在群里或者私聊窗口随时召唤你的AI助手了。

整个配置分为飞书侧的准备工作，以及Hermes侧的网关配置。我把步骤拆得细一点，照着做就行。

5.1 飞书开放平台侧配置

第一步：访问飞书开放平台，登录后进入开发者后台，点击“创建企业自建应用”，输入应用名称和描述。

第二步：在应用详情页点击“添加应用能力”，选择“机器人”。

第三步：配置权限。进入“权限管理”，需要添加以下核心权限：

• im:message — 获取与发送消息的核心权限
• im:resource — 获取消息中的资源文件

如果希望机器人在群聊中稳定工作，建议补充im:chat:readonly（读取群聊信息）以及admin:app.info:readonly（获取Bot身份信息）。

第四步：进入“凭证与基础信息”，记录下App ID和App Secret，这两个凭证后面Hermes配置时会用到。

第五步：配置事件订阅。进入“事件与回调”，订阅方式选择“长连接”（WebSocket模式），添加事件im.message.receive_v1（接收消息事件）。WebSocket模式的好处是——你的服务端主动连接飞书服务器，不需要公网可访问的回调地址，特别适合本地开发和没有公网IP的环境。

第六步：发布应用。进入“版本管理与发布”，创建版本并提交发布。发布后飞书内才能搜索到该机器人。

5.2 Hermes Agent侧配置

第一步：回到终端，启动Gateway配置向导：

hermes gateway setup 

在渠道列表中选择“飞书（Feishu）”。

第二步：按提示依次填写配置项：

• App ID：刚才在飞书开放平台获取的
• App Secret：同样从飞书开放平台获取
• Domain：国内版填feishu
• Connection mode：默认选择websocket（免公网部署）

第三步：配置访问控制。在鉴权选项中选择“不限制对话人”，这样群里所有人都可以与机器人交互。

第四步：保存配置。确认无误后选择Done保存，配置会写入/.hermes/.env文件中。

第五步（Windows环境需要）：如果缺少飞书SDK依赖，执行以下命令安装：

pip install lark-oapi==2.19.0 

第六步：启动Gateway：

hermes gateway start 

启动成功后，飞书内应该能搜索到你创建的机器人。首次对话时，终端会提示运行配对命令进行授权确认，按提示操作即可。

5.3 常见排障小贴士

如果飞书机器人不回消息，可以按以下顺序排查：

1. 检查Gateway是否真的在运行：hermes gateway status
2. 查看配置是否正确：确认/.hermes/.env中的App ID和App Secret无误，FEISHU_CONNECTION_MODE=websocket已设置
3. 开启DEBUG日志：设置环境变量DEBUG=true后再启动Gateway，查看具体错误码
4. 确认应用已发布：飞书应用需要发布后才能被搜索和使用

微信接入比飞书稍微复杂一些，但也不是什么难事。目前有两种场景：企业微信和个人微信，我分开说。

6.1 企业微信接入

企业微信的接入流程和飞书类似，但需要走企业微信管理后台。

第1步：登录企业微信管理后台，进入“管理工具”→“智能机器人”。

第2步：点击“创建机器人”，用一句话描述使用场景后点击创建，选择API模式创建，然后拿到Bot ID和Secret。

第3步：在终端执行hermes gateway setup，选择WeCom（企业微信），填写App ID、App Secret和User IDs。

UserIDs获取方式：进入企业微信通讯录，点击某个成员的头像/名字，成员详情页显示的“账号”字段即为该成员的UserID。

第4步：回到企业微信管理后台，配置可见范围和可使用权限，保存后即可在企微内搜索到机器人。

6.2 个人微信接入

个人微信接入目前有几种方案可选，社区活跃度较高的是hermes-wechat项目。

核心方案：hermes-wechat适配器方案。架构是四组件管道：微信App ↔ iLink Bot API ↔ weixin.py适配层 ↔ Hermes Gateway。

安装步骤：

git clone https://github.com/RongleCat/hermes-wechat cd hermes-wechat uv add aiohttp cryptography qrcode pillow 

配置步骤：将weixin.py复制到Hermes的platforms目录，然后执行patch.py注册微信平台。配置config.yaml时，需要填入iLink Bot API Token和App ID。

关于Bot：Bot插件目前已合入Hermes Agent官方，你也可以到开放平台创建获取appid进行绑定，作为微信接入的备选方案。

需要提醒的是，个人微信接入相比企业微信稳定性和官方支持程度略有差异，建议优先考虑企业微信场景。

接入完成后，你就可以愉快地使用Hermes了。以下是一些常用命令：

终端直接对话：

hermes 

然后就可以像和真人聊天一样输入你的需求。

常用对话内命令：

• /new — 开始新话题
• /model provider:model — 切换模型，例如/model openrouter:google/gemini-2.5-pro
• /personality name — 加载角色预设，比如/personality code切换到编码助手模式

终端运行的管理命令：

• hermes tools — 查看和启用/禁用工具模块（文件操作、Shell执行、浏览器控制等）
• hermes schedule — 用自然语言设置定时任务，例如“每天早上8点，汇总我的邮件并发送到飞书”
• hermes status — 查看当前运行状态

作为一个踩过不少坑的人，我把常见问题整理出来，希望能帮你少走弯路。

坑1：Windows用户强行用原生脚本。官方明确声明“Native Windows is not supported”，不要试图绕过WSL2。用原生PowerShell脚本虽然能装上，但微信接入等高级功能大概率会出问题。

坑2：API Key配置错误。如果你用的是阿里云DashScope，注意提供商名称和密钥命名规则。最容易误判的是401错误——有时候不是Key本身有问题，而是请求跑错了提供商。

坑3：飞书WebSocket连接失败。检查~/.hermes/.env中是否设置了FEISHU_CONNECTION_MODE=websocket，同时确认网络能正常访问飞书公网API。

坑4：依赖缺失导致功能异常。安装后先运行hermes doctor做一次全面检查，它会列出所有依赖的安装状态和配置完整性。

Q1：Hermes Agent是免费的吗？

是的，Hermes Agent是MIT协议的开源项目，可以免费使用。你只需要自己承担大模型API的费用。如果你选择云端部署，还需要支付云服务器的费用。

Q2：Windows用户一定要装WSL2吗？

官方推荐使用WSL2，这也是经过社区验证最稳定的方案。虽然社区有提供Windows原生PowerShell脚本，但存在兼容性问题，部分功能（如微信接入）不稳定。

Q3：接入飞书需要公网IP吗？

不需要。飞书接入支持WebSocket模式，你的服务端主动连接飞书服务器，不需要公网可访问的回调地址，特别适合本地开发和没有公网IP的场景。

Q4：Hermes支持哪些大模型？

支持的模型非常丰富，包括OpenAI、Anthropic Claude、阿里云DashScope、智谱GLM、Kimi、DeepSeek、MiniMax、本地Ollama等，也可以通过OpenRouter聚合接入200+模型。

Q5：部署完成后飞书机器人不回消息怎么办？

按以下顺序排查：先运行hermes gateway status确认Gateway是否真的在运行；检查/.hermes/.env中的配置是否正确；开启DEBUG日志查看具体错误信息；确认飞书应用已发布并生效。

Q6：个人微信和企业微信接入有什么区别？

企业微信接入是官方支持的方案，流程标准、稳定性好；个人微信接入目前依赖社区适配方案，需要额外安装hermes-wechat等适配器。建议优先考虑企业微信场景。

Q7：本地电脑关机后还能用吗？

如果部署在本地电脑上，关机后Agent就离线了。要实现7×24小时在线，建议将Hermes部署在云服务器上，比如腾讯云Lighthouse或阿里云ECS。

Q8：怎么查看Hermes学到的技能？

所有自动生成的技能保存在/.hermes/skills/文件夹里，你可以直接查看。如果某个技能不想要了，直接删除对应文件即可。

Q9：可以接入多个消息平台吗？

可以。Hermes的网关支持同时配置多个消息通道，你可以把同一个Agent同时接入飞书、企业微信、Telegram等多个平台，在不同地方都能调用它。

Q10：部署过程出错怎么办？

如果遇到问题，可以先去GitHub的Hermes Agent项目Issues里搜索类似问题，或者运行hermes doctor做一次完整检查。另外，查看DEBUG日志也是定位问题最有效的手段。