Hermes Agent的多智能体多Agent配置中文教程，老马好像没见过比较详细，比较小白的，除了AI生成的垃圾水文之外。

其实技术性质的教程文章是最难写的，因为大家的系统环境，所配置的大模型，跟Hermes沟通时所提供的上下文，都不一样。

这就很容易导致，老马跑得通的流程，到你手上，处处有卡点。尤其像Hermes本来就没有多智能体多Agent的官方配置说明。

中文详细教程就更不用说了，老马也是花了一天时间去不断地配置，测试，修复，最终才算是把整个流程配置完成的。

鉴于每个人的情况不一样，教程也不能过于死板复杂。因此接下来老马所提到的细节点，希望大家多多留意。

有可能你们在实际配置过程中遇到的问题，老马没遇到过。还是那句话，跟你Hermes接入的大模型智商水平，你所提供的上下文有关系。

废话不多说，下面直接开干，事先声明，玩Hermes一点可不比OpenClaw小龙虾来得省心，有时候别听人瞎吹，真折腾起来还是挺折腾的。

配置前的准备工作

老规矩，提前说明一下老马的Hermes情况，部署在Windows 11系统，装了WSL虚拟机，但没在虚拟机里面装Linux系统。

Hermes配置的大模型一开始是智谱的GLM-5.1，后面因为被提供商限制速率，报经典的429错误，换成了阿里云百炼的Coding plan，使用qwen3.5 plus模型，将就着用，反正快到期了，也续费不了。

换模型过程中还出了个意外，这个后面会提到。其次接入大模型这块，老马个人建议是尽量用目前国产那几个主流模型，比如Kimi k2.5，Minimax m2.5、qwen3.5 plus、GLM-5之类的。

如果你能上Minimax 2.7，GLM-5.1等更新的模型，那更好，国外的就不要考虑了，使用配置也麻烦，还得担心账号会不会被封，用中转站也是一个道理，人家中转站自己的号池被封了，你一样用不了。

另外一个需要准备的是把Hermes更新到最新版本，目前是v0.10.0。一般你在终端或者Powershell命令行窗口，输入hermes update命令就可以更新了。实在更新失败的，可以试试使用魔法，但别问老马怎么搞到魔法。

然后就是多智能体多Agent的配置形式，大概分为两种。老马认为这两种已经足够绝大多数人使用，再复杂的没必要。

一种是单Bot多Agent，单Bot就是一个机器人，这个机器人推荐是用飞书的，什么QQ、微信Clawbot就不推荐了，因为不支持群聊。

单Bot多Agent的话，一个机器人接入到主Agent，背后跟着N个子Agent，N可以是随便的数字，你想有几个子Agent就设置几个。

第二种是多Bot多Agent，你只要理解了单Bot多Agent，这个很好参透。比如主Agent接入一个机器人，子Agent1接入一个机器人，子Agent2接入一个机器人，子Agent3接入一个机器人，一一对应互相独立。

因此需要你提前去飞书开放平台，把机器人创建好，你要用到几个机器人就创建几个。创建的教程老马之前写过很多次了，可以回看参考老文章的后半部分内容：这一次你一定能装上OpenClaw小龙虾

基本上这些准备工作搞定了，就没啥大问题。下面介绍一下Hermes的多智能体多Agent创建的底层逻辑。

首先Hermes跟OpenClaw不大一样的地方就是，它没有真正意义上的多Agent配置方式。我们需要采用Profile去搭建一个配置容器。

容器有什么模型、工具、技能等配置，容器里面再去运行一个Agent的实例，可以理解成又运行了独立的Hermes Agent。

不理解也没关系，老马先举个例子，假设你现在电脑上的Hermes已经对接了一个飞书机器人，正常来说你就得开启一个Hermes的网关。

但如果你要配置多智能体多Agent了，除了单Bot多Agent的形式，不需要额外配置机器人。多Bot多Agent的话，你就得再接入其它子Agent的机器人。

除此之外，每个Agent都需要独立开启一个专属的网关，这点无论是单Bot还是多Bot都一样。你有3个子Agent，加上主Agent，你总共得开4个网关。

而且网关所在的命令行窗口是不能关掉的，除非你用命令让其在后台运行。否则关掉了之后，你的所有Agent都会失联。

这里还得额外说明一点，老马经常说的Hermes终端是什么意思。免得有些小伙伴不理解。Hermes终端指的是你打开了一个命令行窗口，比如Windows系统打开Powershell，在里面输入命令：hermes。

按键盘回车后运行所看到的界面，称之为Hermes终端。这是可以直接进行聊天的，只不过是在命令行窗口里面而已，同样用自然语言跟Hermes交流，发送命令之类的：

跟你在接入的QQ机器人、飞书机器人、微信机器人聊天是一个道理的。只不过终端是在电脑上，其它机器人都在社交软件上。

啰嗦了这么多，该交代的背景信息，准备工作都差不多了，下面直接进入实操。

单Bot多Agent配置

老马建议大家，把下面这段命令都发送给你的Hermes，让它学习一下Hermes官方的文档，自己了解自己，这样等下配置多Agent时，它有底。

换句话说有上下文了，有知识库了，所以你让它学习完之后，可以存储为长期记忆，命令如下：

仔细阅读理解hermes的官方文档：https://hermes-agent.nousresearch.com/docs，了解一下hermes的多agent创建机制

以上命令可以通过Hermes终端，或者对接的机器人发送过去，它会自己自动去学习的。学习完毕了，下面开始配置多Agent。

假设这里老马要配置3个子Agent，分别是Agent1：文案高手，Agent2：编程高手，Agent3：数据分析高手。

加上原来就有的主Agent，叫Hermes小助手。总共就是4个Agent，全部接入一个机器人。机器人是跟主Agent进行对接的，其它3个子Agent不对接。

主Agent负责到时候做总指挥，总传话人，传递你发送的指令，安排下面3个子Agent小弟去干它们各自擅长活儿。再把最终的结果，回复给你。

因此，接下来我们先创建第一个子Agent1：文案高手。方式很简单，通过终端发送提示词给Hermes，让它帮我们去创建，而不是我们手动输入一些Hermes的命令去创建：

使用hermes的Profile方式创建第一个子agent，agent1：文案高手，默认使用主模型。然后引导我设置该子agent的agents.md，soul.md文件。

以上提示词不是一成不变的，你在创建第二个子Agent的时候，就得改一下里面的数字跟文字，别一股脑儿都按这条命令去跑，到时候Agent都创建混乱了。

非常简单，基本上只要你Hermes接入的大模型不是太蠢，第一个子Agent的基本设置就好了：

同时，Hermes也有可能会引导你继续创建子Agent必需的Agents.md、Soul.md这两个文件：

最终等这两个文件创建完毕，子Agent创建就算全部完成了：

接着，使用上面的提示词，把里面的Agent1数字改成2和3，文案高手改成编程、数据分析高手，按这套流程挨个去创建完成：

刚才老马创建好的3个子Agent，它们的工作区域，技能，工具，主配置文件config.yaml，.env环境变量配置文件等都是独立的agent目录。

以Windows系统为例，这3个子Agent的目录路径为：C:\Users\你的用户名\AppData\Local\hermes\profiles：

如果你是装在Linux系统上的，可以找找目录路径：~/.hermes/profiles或者
~/.local/share/hermes/profiles。

装在Mac系统上的，可以找找目录路径：~/.hermes/profiles或~/Library/Application Support/hermes/profiles。

到这里，Hermes的单Bot多Agent我们就算是配置完成了。接下来老马打开了飞书，找到了主Agent之前就对接好，名字叫Hermes小助手的机器人，让它查询一下目前有多少个子Agent：

查询出来的结果是对的。那下面就可以跟主Agent讲，你安排那个子Agent，叫文案高手的，去写一个朋友圈文案：

这时突然间遇到了个报错，什么API key被截断了。什么鬼，看得懂么各位。还记得刚才老马讲的，每个Agent都有自己单独的agent目录，对不对。

这个报错就说明，子Agent1，文案高手的agent目录里面，那个主配置文件config.yaml，里面填写的模型配置信息中，API Key没有填写完整正确，被截断了。

所以我们要怎么修复这个问题呢？思路这么走，先找到子Agent1所在的agent1目录。以Windows为例，目录路径为：C:\Users\你的用户名\AppData\Local\hermes\profiles\agent1，对不对。

在agent1目录里面，再去找到config.yaml这个主配置文件，使用记事本或者Notepad这样的软件打开进行编辑，果然看到被截断简写了：

修复的方法就是把完整的API Key，重新填写上去，然后下面的文件内容再仔细看看，还有没有需要填写完整的API Key，确认无误，保存该文件即可。

所以有些时候，你把创建配置文件这种事情，交给大模型自己去干，它照样有可能出错，乱写乱创建。这跟Hermes聪不聪明，能不能干有关系么？

Hermes的脑子，大脑就是你接入的大模型。大模型智商不行，你Hermes能聪明能干到哪里去，只会处处给你挖点坑，等你去填。

因此不要动不动就说Hermes比OpenClaw聪明，这得取决于很多前提条件的，没有说一句话就对比完的。好了，把config.yaml修复完了，就等于大脑重新连接上线了。

子Agent1文案高手，可以正常使用脑子了，写个简单的朋友圈文案，顺理成章的事情：

其它两个子Agent老马就不一一测试展示给大家看了，效果都一样。但是还那个但是，既然第一个子Agent的config.yaml配置文件里面API Key是写错了，不用想，其它两个都得去修复一遍。

老马当然是一并都修复好了，这样子单Bot多Agent就全部配置完成，可以正常使用，接下来继续讲多Bot多Agent的配置。

多Bot多Agent配置

开始之前，先问聪明的小伙伴们一个问题。老马前面配置单Bot多Agent的时候，是不是只有主Agent接入了一个叫Hermes小助手的飞书机器人。

剩下3个子Agent都是没有接入飞书机器人的，对不对？那我们要配置多Bot的话，把这3个子Agent也挨个接入飞书机器人，不就搞定了么。

是的，就是这个逻辑，思路是一样的。因此你提前去飞书的开放平台，把另外的子Agent机器人都先创建好。像老马就已经先准备好了：

有了子Agent的飞书机器人，下面老马就换一个提示词，继续让Hermes帮忙，一个个地给3个子Agent分别接入：

接下我需要给每个子agent单独接入飞书机器人，现在是给子agent1：文案高手接入，请引导我操作

记住了，每配置一个机器人，上面提示词里面的数字跟文字都要修改成对应的，别全部都用一样的提示词，这样会搞乱的：

提示词发送过去，Hermes会引导我们操作每一步的。比如接下来它就要求我们把老马的子Agent1文案高手，对应飞书机器人的APP ID跟APP Secret发送过去：

Hermes收到APP ID跟APP Secret后就开始配置了：

配置完成，它还会提示我们，接下来需要新开启一个Powershell窗口，运行命令：

hermes -p agent1 gateway

这里的意思是，老马的子Agent1文案高手已经接入飞书机器人了，接下来需要启动一个独立的网关，启动后如图：

不出意外的，又报错了，没办法，有时候就是这样折腾。复制以上报错信息，发给hermes终端，让它自己去修复看看：

Hermes判断出来的原因是网关没识别到飞书机器人的配置，然后针对该问题进行修复，最终修复完成：

修复完成之后，我们重新运行刚才上面的网关启动命令：

hermes -p agent1 gateway

在Powershell窗口中，能正常看到一行很长的飞书链接，这就说明子Agent1文案高手的网关顺利成功启动：

下一步，老马就打开了飞书的客户端，找到文案高手机器人，发送一条信息过去。有时候，飞书机器人会回复一段验证码，你就把验证码信息都复制一下，重新发给Hermes终端去匹配一下：

上面那段英文就是验证码信息，其实复制后面一句：hermes pairing approve feishu SHQ58WR7 这样的内容，发送给Hermes终端也行的。

但有时候，它又不需要你匹配验证码信息，飞书机器人就可以正常回复你，就这么玄学：

不要问老马什么原因，老马也不知道。老马折腾了两次配置，第一次不需要，第二次就需要匹配验证码信息。

不管了，接下来继续输入前面的提示词，给子Agent2编程高手接入单独的飞书机器人。有了第一次的经验，后面都很快了：

然后Hermes继续让开启一个新的Powershell窗口，输入以下命令启动子Agent2编程高手的独立网关：

hermes -p agent2 gateway

子Agent2编程高手的独立网关启动成功后如图：

继续去飞书客户端，找到编程高手机器人，发送一条信息看看：

同样完美接入成功。自此两个子Agent都各自接入了独立的机器人，也同时开启运行着独立网关的Powershell窗口了。

那老马的子Agent3数据分析高手就不给大家重复演示了，步骤跟思路都是一样的，你照葫芦画瓢就行了。

这就完了么？没完，你太小瞧小伙伴们的需求了，虽然说多个Agent是接入了各自的飞书机器人了，但这只是一对一挨个私聊啊。

咱既然接入了飞书，那高低得整个飞书群聊，把机器人们都拉进去，@谁了，谁去干活，这才有范儿嘛。

有范是有范，但也足够你折腾，咱们接下往下走着瞧。

创建使用飞书群聊

飞书的群组创建是比较简单，但事先说明一点，如果你的飞书账号不是企业认证后的，那你创建的机器人，是不能被拉进外部群聊的。

只能是你自己内部的群聊里面使用，别搞错了。说为什么这个群添加不了我的飞书机器人啥的，你得先看看那是不是你的内部群：

以上一张图说明了飞书群组的创建，创建好之后，记得在右上角的三个点继续打开设置，往下滑动，找到群聊的会话ID，复制一下：

复制好群聊的会话ID，填写到下面这段提示词的最后，发送给Hermes终端：

我现在已经把主agent，三个子agent，都拉进了飞书的群组，群会话ID是：替换成你自己的，我希望@它们就能回应我

记住了，上面提示词中内容要改成你自己的，别老马写的三个子Agent，你也跟着这么发。而你实际是配置了四个，这就搞笑了。

发送过去后，Hermes会自己去分析当前的情况，该修改配置就修改配置：

你以为这就成了么？并没有，老马4个Agent的网关都是开启的，4个飞书机器人的权限在飞书开发平台都是设置对的，但就是在群里，@它们没反应，不会回复：

就这样，Hermes一直叫我去查查网关开没开啊，飞书机器人该配置的权限，事件订阅长连接啥的弄没弄啊，老马都弄了。

到最后 ，Hermes还在吭哧吭哧地找问题到底是出在哪里，没道理的啊，有点怀疑Agent的人生了：

然后，精彩的一幕来了，由于Hermes在频繁调用大模型，访问文件寻找原因。这时突然提示429错误，模型API断了，被服务商限制速率了，大脑断网了。

而且，等了十几分钟，大脑还是没恢复，完犊子了。这紧要关头出这种事情，老马想砸了服务商服务器的心都有了。别问是哪家服务商，问就是七牛云。

没办法，再这么等下去，也不知道速率限制啥时候恢复。索性修改配置文件，重新换回阿里云的Coding plan先用着。

结果屋漏偏逢连夜雨连夜雨，配置文件也被老马修改坏了，保存的时候编码错误，最后导致Hermes终端都启动不起来。

阿西吧，一点都不要慌，先恢复配置文件。接着让Hermes继续寻找原因，为什么飞书群聊里面，@里面的机器人不回复：

费尽九牛二虎之力，Hermes吃奶的力气都用光了，原因找到了。简单的说，目前Hermes内置的飞书插件，它不支持群聊，只支持私聊。

有句“恭喜发财”不知道当讲不当讲，那些天天在吹Hermes牛逼到上火星的博主们，你们是一点都不自用，光站着吹啊。

很明显，这个Hermes自身的问题，跟之前老马发现的网关Bug一样。可以去Hermes的官方github仓库提交问题，然后坐等官方修复。

你要说是Bug，其实也不算，就是草台班子觉得你用私聊这个功能不就够了么，还整什么群聊。算是你的需求，Hermes跟不上节奏。

所以，老马只能自己动手，丰衣足食。让Hermes自己修复自己，又是一顿折腾代码，最后文件修改成功，从私聊改成了支持群聊。

这个文件是feishu.py，你可以下载后替换掉原来的文件。前提是你的Hermes是V0.10.0版本的，别搞错了。

以Windows系统为例，替换的目录路径是：C:\Users\你的用户名\AppData\Local\hermes\hermes-agent\gateway\platforms

直接复制feishu.py，再以上目录粘贴覆盖即可。Mac跟Linux系统的目录路径就不重复说了，上文都提到很多次了，只要你能找到hermes主文件夹，顺着往里面继续找，就可以找到。

最后的结果，当然是轻松秒杀，每个Agent机器人被@了之后都能正常回复：

这时又有非常聪明的小伙伴会说了，我不替换行不行？行的，不替换，你的机器人在飞书群里，收不到你@它们的信息，不会回复。

当然，老马还是提醒一下，替换之前，你可以把原来的feishu.py文件，备份一下，免得再发生什么灵异事件，也好到时恢复回来。

feishu.py文件的网盘下载地址，记得解压zip压缩包后使用：

夸克网盘：https://pan.quark.cn/s/5c64e21500c7


UC网盘：https://drive.uc.cn/s/ae444634ef814?public=1


迅雷云盘：https://pan.xunlei.com/s/VOq_tuZATdv14O3bjFynB1ANA1?pwd=i97i# 

这时又又有非常聪明的小伙伴会问了，我不想在群里@机器人，它们才回复。我希望它们一收到我发的消息，就全部回复。

那你自己跟Hermes一起，继续折腾修改feishu.py文件吧。老马累了，你又不是林志玲，高圆圆，波多野结衣，犯不着啥要求都得满足你。

你都这么大人了，得自己学会自己动手，别老张嘴伸手管人要。成熟点，都是一百多斤的小孩了，不能再卖萌撒娇啥的，影响发育。

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