昨天发的Hermes Agent模型配置教程，又收到了小伙伴的留言了。说这模型配置还不简单么，hermes model一行命令一分钟搞定的事情。

老马承认，你说的都对，但得分情况。在你没有遇到报错的时候，什么操作都是对的。一遇到报错，你就得抓瞎。

首先，Hermes官方是不建议用原生的Windows系统去安装部署Hermes的，即便你装了WSL虚拟机，还是会遇到很多兼容性问题。

因为WSL虚拟机里面，你没有再去安装Liunx系统，比如乌班图系统的时候，Hermes的主要程序是安装在Windows上的。

只有像终端沙箱等少数的Linux工具，会去调用WSL内核和迷你容器。如果在WSL里面再装Linux系统，那么Hermes整体就是装在Linux系统上。

这又可能会导致一些Windows系统的小白用户，搞不懂Linux系统里面遇到的问题，虽然可以实现原生Windows系统跟WSL内的Linux系统之间进行命令和文件交互。

但多一层系统，多一层障碍，直接装对普通用户而言是最简单的。只不过由于兼容性的问题，会时常碰到Windows GBK编码问题。

所以老马写的教程文章都是基于广大Windows普通用户的，为什么说是广大，因为真的比使用Mac系统跟Linux系统的用户多。

AI产品又天然地是基于Mac或者Linux系统环境开发的，Windows用户一直感觉是个弃儿，明明小白用户量是挺大的。

AI产品发布的时候，基本上都是先发Mac和Linux系统，Windows系统往后排一排，主要原因之一是Windows系统环境复杂，兼容性问题太多。

因此，废了这么多话描述一下背景，主要是太多杠精一上来就跟懂王附身一样，觉得自己什么问题都知道，都能搞定。

说句实在话，老马接触电脑到现在二十多年。现在有朋友在微信上问一个电脑系统的问题，老马都无法直接判断原因，得一点点排查。

就跟老中医一样，望闻问切，寻找病因，必要时把报错日志丢给AI辅助分析，结合自己的判断，再让朋友挨个去尝试。

这是基本操作，不是一句话就能断人生死，你这电脑没救了，再买一台新的吧。所以，有些时候，你遇到有些人，你只能无语，只能给他回一句：对，你说的都对。

回到主题，老马还是会继续基于Windows系统，继续折腾各种AI Agent框架，像之前的OpenClaw，到今天的Hermes Agent。

迟早有一天，官方还是会支持原生的，犯不着总盯着问题最少的Mac跟Linux系统，拓展市场份额的事情，谁都会愿意去做。

包括最近Hermes都开始支持微信的ClawBot了，不是官方的插件，而是第三方用户逆向给Hermes接入的，这块后面老马也会单独介绍怎么接入。

今天是给大家介绍如何在Hermes上接入飞书机器人，飞书使用起来还是比较方便，企业微信反倒接入的人比较少，后面看大家反馈的情况，再决定要不要出教程。

本文教程开始之前，还是先声明，这是基于Windows部署安装的Hermes Agent的接入教程，Mac跟Linux系统也是通用的，但只需要看前面部分内容。

前面部分内容接入成功后，可以在飞书机器人上正常聊天了，Mac跟Linux系统就算配置完成。而Windows系统会有很多兼容性的问题，后面部分内容是老马修复问题的过程展示。

又啰嗦了，下面直接开始，还有补充一点，Hermes中文文档老马一直在维护更新，有问题可以自行查阅：
https://www.majiabin.com/hermes

Hermes Agent接入飞书机器人

在开始接入之前，你得先去飞书的开放平台：https://open.feishu.cn 创建好一个飞书机器人，把该添加的机器人应用能力添加上。

该开启的事件与回调长连接，权限都开启。创建飞书机器人的教程在之前OpenClaw的文章中写过多次了，不了解的可以回看：这一次你一定能装上OpenClaw小龙虾 后半部分的飞书机器人创建内容。

下面老马就直接默认你已经创建好了飞书机器人，有了APP ID 跟App Secret，版本也已经发布了，等于全部准备完毕，就等着对接Hermes。

第一步，在Powershell中输入”hermes”运行终端，因为等下需要输入对接命令，命令是英文的，可能导致Hermes后续给你回复也是英文的。

因此在一开始，我们先给Hermes发送这样一句话：请接下来都用中文回复我，不要使用英文。避免后续一堆英文回复，小伙伴们看不懂。

第二步，输入以下命令回车，Hermes会一步步引导你去设置飞书机器人的WebSocket模式：

FEISHU_CONNECTION_MODE=websocket

这里你就选择1，然后继续往下走，再选择2，因为你上面已经创建好了飞书机器人，已经有了APP ID 跟App Secret：

把APP ID 跟App Secret直接发送过去，Hermes就会帮你进行配置了：

很快，飞书机器人的基本配置就搞定了：

第三步，我们接着输入以下命令。这里老马忘了提前发送提示词，要求它继续用中文回复，所以下面的截图都是英文的，很抱歉，大家凑合着看。

hermes gateway setup

把以上命令发送给Hermes，它是网关的交互式设置，同样会一步步检查引导你继续操作配置的：

一路等待，有需要你选择确认的，你就确认，直到最后提示重启网关，一般会自动退出Hermes的终端输入状态：

接着你在Powershell中再次输入“hermes”启动终端，然后需要回到飞书的客户端，给你要对接的机器人随便发一条信息：

把上面机器人回复的验证信息，全部复制，回到hermes的终端，发送过去，让Hermes进行配对即可：

配对完成后，一般情况下，Mac系统跟Linux系统就可以正常使用飞书机器人，跟Hermes进行对话了：

上面机器人回复了一段英文，意思是说飞书未设置主频道。主频道是Hermes发送定时任务结果和跨平台消息的地方。输入/sethome将此聊天设为你的主频道，或忽略以跳过。

你可以直接给飞书机器人回复/sethome，设置为主频道：

到这里，你的飞书机器人就算成功接入Hermes了。Mac跟Linux系统用户有时候就是这么舒爽，命令一路输到底，都不会报错。

那么Windows用户看过来了，假设你已经完成了第三步，也就是把机器人人回复的配对信息，发送给Hermes进行成功配对了。

但是你给飞书机器人发送消息的时候，老是提示下面的错误：

简单地说，这还是Windows系统的兼容性问题。我们直接把这段报错复制一下，发送给Hermes，让它自己想办法去修复：

Hermes好像是找到原因了，进行了修复。修复完成，我们可以新开一个Powershell的窗口，输入以下命令启动Hermes网关：

hermes gateway run

不行，结果还是报错：

继续把上面报错的内容复制一下，再通过终端窗口发给Hermes去修复，如果此时你的Hermes终端已经退出了，你就再启动一下，发送报错内容过去：

现在Hermes信誓旦旦地说，再去启动网关就不会报错了。先暂时信它个鬼，继续新开一个powershell窗口，输入刚才的网关启动命令：

hermes gateway run

哟西，出现websocket连接上的信息了，这说明成功了，回到飞书客户客户端，给接入的机器人随便发条消息，看看有没有回复：

正常收到回复，这样子我们Windows系统也算是把Hermes成功对接上机器人，能正常通过飞书机器人跟Hermes进行聊天了。

最后补充一点，刚才输入网关启动命令的Powershell窗口，你是不能关闭掉的，关掉了，网关就掉了，飞书机器人就连接不上Hermes了。

如果你觉得这个Poweshell的窗口很碍事，想关闭掉它，让网关在后台运行，那你可以直接在终端窗口问Hermes：

Hermes直接给你推荐了最简单的解决方案，你选择后回车确定就行了：

这样子跟着操作，就能解决掉，你不喜欢开着多个Powershell窗口的个性化需求。

好了，以上就是今天的分享，欢迎关注、点赞、转发一键三连。有任何问题和需求，请在评论区留言，回见！