血与泪的教训一台腾讯云服务器跑两个 Hermes AI Agent各绑独立飞书机器人踩坑全记录一个下午的崩溃调试换来的配置模板现在你只需要 10 分钟前言为什么需要多个 Agent假设你已经在用 Hermes Agent 作为你的 AI 助手通过飞书 Bot 和它对话。但有一天你发现你希望有一个工作专用的 Agent只处理数据分析、代码任务另一个日常助手的 Agent用来查资料、写文案、闲聊或者你想让朋友/同事也能用但不想让他们看到你的完整系统权限最直接的想法跑两个 Hermes 实例各绑一个飞书机器人。听起来简单但我踩了一下午的坑。这篇文章就是帮你把这半天省下来的——跟着做10 分钟搞定。而且有一个好消息你只需要去飞书开放平台申请一个机器人把 App ID 和 Secret 拿来剩下的所有配置只要把这个页面上的内容复制给你的 Hermes Agent它就能帮你自动完成。一、架构概览本方案部署在腾讯云服务器公网 IP: 49.232.246.96上Ubuntu 系统。所有操作都在云服务器上完成。飞书 App A (主Agent) ──→ Gateway A (主进程) ──→ Profile ~/.hermes/ ↓ 飞书 App B (Agent-B) ──→ Gateway B (子进程) ──→ Profile ~/.hermes/profiles/agent-b/两个 Hermes 进程各自独立运行两个飞书应用各自绑定不同的 Bot Token两个 Profile 目录配置完全隔离只有主 Agent 能管理 Agent-B通过 terminal 工具反过来不行二、创建第二个 Agent 的 ProfileHermes 支持 Profile 机制创建第二个实例只需要复制一份配置文件。我这篇文章就是把这个过程完整走了一遍把我的实践经验直接给你用# 创建 profile 目录 mkdir -p ~/.hermes/profiles/agent-b # 复制主配置作为模板 cp ~/.hermes/config.yaml ~/.hermes/profiles/agent-b/ # 创建专属 .env cp ~/.hermes/.env ~/.hermes/profiles/agent-b/修改agent-b/config.yaml中的关键参数如模型、权限、超时等让它和主 Agent 有所区分。三、创建飞书 Bot1. 去 [飞书开放平台](https://open.feishu.cn) → 创建企业自建应用2. 获取App ID格式cli_xxxxxxxxxxxxxxxx和App Secret←这是你唯一需要手动操作的部分3. 开启机器人能力4. 配置事件订阅 → 选择WebSocket 长连接模式5. 添加权限im:message、im:chat、contact:user等跟主 Agent 一样即可6. 发布版本拿到 App ID 和 App Secret 之后把剩余的内容给 Hermes Agent 看它就能帮你把 systemd 配置、.env 文件、重启验证全部完成。你只需要把本文剩下的命令和配置文件给 Agent 执行就行。四、配置 systemd 服务为了让 Agent-B 能开机自启、崩溃自动恢复给它写一个 systemd 服务[Unit] DescriptionHermes Agent-B Gateway (独立实例) Afternetwork-online.target Wantsnetwork-online.target [Service] Typesimple Userubuntu WorkingDirectory/home/ubuntu/.hermes # 关键指定 Profile 目录 EnvironmentHERMES_HOME/home/ubuntu/.hermes/profiles/agent-b # Agent-B 的飞书凭证写在 .env 里也行但这里直接写更可靠 EnvironmentFEISHU_APP_IDcli_你的APP_ID EnvironmentFEISHU_APP_SECRET你的APP_SECRET EnvironmentFEISHU_DOMAINfeishu EnvironmentFEISHU_CONNECTION_MODEwebsocket EnvironmentFEISHU_ALLOW_ALL_USERStrue EnvironmentFEISHU_GROUP_POLICYopen ExecStart/home/ubuntu/.hermes/hermes-agent/venv/bin/python \ -m hermes_cli.main gateway run --replace --accept-hooks Restarton-failure RestartSec5 [Install] WantedBymulti-user.target然后执行sudo systemctl daemon-reload sudo systemctl enable hermes-agent-b sudo systemctl start hermes-agent-b sudo systemctl status hermes-agent-b # 确认正常运行⚠️ 五、血泪史第一大坑环境变量覆盖问题必看这是本文最有价值的部分——我在这上面浪费了一个下午。问题现象Agent-B 的 WebSocket 日志显示connected to wss://...飞书开放平台却显示连接失败反复重启、升级 SDK、改 Ping 间隔通通无效事故还原事情是这样的我一开始先用了一个飞书机器人 A 来配置 Agent-B跑了半天发现不行于是换成了机器人 B。然后我做了三件事1.改了 systemd 服务文件把FEISHU_APP_ID换成了机器人 B2.改了.env文件也把FEISHU_APP_ID换成了机器人 B3. 重启自信满满结果还是连不上。为什么因为我的.env文件里APP_ID 改成了 B但 APP_SECRET 还留着机器人 A 的 Secret根因深挖Hermes 的 Gateway 在启动时执行了这行代码# gateway/run.py第 11097 行 load_dotenv(_env_path, overrideTrue)注意最后的overrideTrue完整的加载链路是这样的systemd EnvironmentFEISHU_APP_ID机器人B ✅ 正确 systemd EnvironmentFEISHU_APP_SECRET机器人B的Secret ✅ 正确 ↓ Python 进程启动读取到 systemd 的值 ↓ load_dotenv(overrideTrue) 加载 .env 文件 ↓ .env 中的 FEISHU_APP_ID机器人B .env 中的 FEISHU_APP_SECRET机器人A的Secret ←— 残留覆盖了 systemd 的正确值 ↓ 进程用 机器人B 机器人A的Secret 去连飞书 → 认证失败overrideTrue意味着.env中的值无条件覆盖systemd 已经设好的值。你改 systemd 是没用的——只要.env里有残留最终用的是.env的。而且更坑的是我改完.env的 APP_ID 后自信地重启了根本没检查 APP_SECRET 也要同步改。结果飞书用错配的 APP_ID 旧 SECRET 连了半小时都说连接失败。排查方法如果你怀疑有这个问题直接检查进程内的实际环境变量# 找到 Agent-B 的 PID ps aux | grep hermes | grep gateway # 查看它实际使用的环境变量 sudo cat /proc/PID/environ | tr \0 \n | grep FEISHU注意/proc/PID/environ显示的是进程启动时的初始环境。Python 中os.getenv()返回的是load_dotenv(overrideTrue)覆盖后的值——这两个可能不一样正确配置方式方案 A推荐让.env和 systemd 保持完全一致逐项核对# 逐项对比 .env 和 systemd 中的 FEISHU 变量 echo .env grep ^FEISHU_ ~/.hermes/profiles/agent-b/.env echo systemd grep FEISHU_ /etc/systemd/system/hermes-agent-b.service检查清单变量.envsystemd一致FEISHU_APP_ID✅✅✅FEISHU_APP_SECRET❌ 旧Bot残留✅❌ 翻车FEISHU_ALLOW_ALL_USERSfalsetrue❌ 翻车FEISHU_ALLOWED_USERS主用户ID(未设)❌ 翻车FEISHU_CONNECTION_MODEwebsocketwebsocket✅FEISHU_DOMAINfeishufeishu✅我当初 APP_ID 和 SECRET 对了但 ALLOW_ALL_USERS 是false——结果 Agent-B 能连上飞书但拒绝响应任何人的消息因为用户授权检查没通过。方案 B更安全删除.env中的FEISHU_*变量只靠 systemd 的Environment传递。这样 dotenv 不会影响飞书配置。六、第二大坑Holographic Memory 镜像不完整Hermes 的 Holographic Memory 插件支持将内置 Memory 自动镜像到 SQLite 事实库fact_store。这样即使 Session 结束重要的信息也能在下次对话中召回。但有一个 Bug镜像代码只处理新添加add不处理更新replace。def on_memory_write(self, action, target, content): if action add and self._store and content: # ← 只处理 add self._store.add_fact(content, categorycategory)当 Memory 空间满了你用replace更新旧记录时fact_store不会同步更新。你会发现 Memory 里有这条信息但 fact_store 里查不到——相当于没有持久化。修复方法一行代码# 修改前 if action add and self._store and content: # 修改后 if action in (add, replace) and self._store and content:修改完重启 Hermes 即可。新创建的子 Agent 和主 Agent 共享同一份代码所以只要修一次两边都生效。七、验证多 Agent 是否正常重启后逐一验证# 1. 两个进程都在运行 ps aux | grep hermes_cli.*gateway | grep -v grep # 2. Agent-B 日志显示 WebSocket 已连接 sudo journalctl -u hermes-agent-b --no-pager | grep connected to wss # 3. 去飞书开放平台确认长连接状态已连接 # 4. 分别给两个 Bot 发消息都能正常回复八、总结环节关键点你需要做的去飞书开放平台申请一个机器人拿到 App ID 和 SecretAgent 帮你做的配置 systemd 服务、写 .env 文件、重启、验证——剩下的全自动部署环境腾讯云服务器Ubuntu公网 IP⚠️ 第一坑load_dotenv(overrideTrue)让.env覆盖 systemd——改 APP_ID 必须同步改 SECRET 和所有 FEISHU_*⚠️ 第二坑Holographic Memory 的 mirror 只处理add不处理replace安全隔离主 Agent 可以操作一切子 Agent 只在自己 Profile 范围内一台服务器上跑多个 Hermes Agent 并不复杂——真正的难点在于理解环境变量的加载顺序和完整替换。你不需要在飞书配置页面上折腾、不需要写复杂的 Python 代码、不需要手动处理进程管理。只需要去飞书开放平台申请一个机器人把 App ID 和 Secret 给到 Hermes Agent……剩下的Agent 能帮你搞定。希望这篇文章能帮你省下这半天
血与泪的教训：一台腾讯云服务器跑两个 Hermes AI Agent，各绑独立飞书机器人，踩坑全记录
血与泪的教训一台腾讯云服务器跑两个 Hermes AI Agent各绑独立飞书机器人踩坑全记录一个下午的崩溃调试换来的配置模板现在你只需要 10 分钟前言为什么需要多个 Agent假设你已经在用 Hermes Agent 作为你的 AI 助手通过飞书 Bot 和它对话。但有一天你发现你希望有一个工作专用的 Agent只处理数据分析、代码任务另一个日常助手的 Agent用来查资料、写文案、闲聊或者你想让朋友/同事也能用但不想让他们看到你的完整系统权限最直接的想法跑两个 Hermes 实例各绑一个飞书机器人。听起来简单但我踩了一下午的坑。这篇文章就是帮你把这半天省下来的——跟着做10 分钟搞定。而且有一个好消息你只需要去飞书开放平台申请一个机器人把 App ID 和 Secret 拿来剩下的所有配置只要把这个页面上的内容复制给你的 Hermes Agent它就能帮你自动完成。一、架构概览本方案部署在腾讯云服务器公网 IP: 49.232.246.96上Ubuntu 系统。所有操作都在云服务器上完成。飞书 App A (主Agent) ──→ Gateway A (主进程) ──→ Profile ~/.hermes/ ↓ 飞书 App B (Agent-B) ──→ Gateway B (子进程) ──→ Profile ~/.hermes/profiles/agent-b/两个 Hermes 进程各自独立运行两个飞书应用各自绑定不同的 Bot Token两个 Profile 目录配置完全隔离只有主 Agent 能管理 Agent-B通过 terminal 工具反过来不行二、创建第二个 Agent 的 ProfileHermes 支持 Profile 机制创建第二个实例只需要复制一份配置文件。我这篇文章就是把这个过程完整走了一遍把我的实践经验直接给你用# 创建 profile 目录 mkdir -p ~/.hermes/profiles/agent-b # 复制主配置作为模板 cp ~/.hermes/config.yaml ~/.hermes/profiles/agent-b/ # 创建专属 .env cp ~/.hermes/.env ~/.hermes/profiles/agent-b/修改agent-b/config.yaml中的关键参数如模型、权限、超时等让它和主 Agent 有所区分。三、创建飞书 Bot1. 去 [飞书开放平台](https://open.feishu.cn) → 创建企业自建应用2. 获取App ID格式cli_xxxxxxxxxxxxxxxx和App Secret←这是你唯一需要手动操作的部分3. 开启机器人能力4. 配置事件订阅 → 选择WebSocket 长连接模式5. 添加权限im:message、im:chat、contact:user等跟主 Agent 一样即可6. 发布版本拿到 App ID 和 App Secret 之后把剩余的内容给 Hermes Agent 看它就能帮你把 systemd 配置、.env 文件、重启验证全部完成。你只需要把本文剩下的命令和配置文件给 Agent 执行就行。四、配置 systemd 服务为了让 Agent-B 能开机自启、崩溃自动恢复给它写一个 systemd 服务[Unit] DescriptionHermes Agent-B Gateway (独立实例) Afternetwork-online.target Wantsnetwork-online.target [Service] Typesimple Userubuntu WorkingDirectory/home/ubuntu/.hermes # 关键指定 Profile 目录 EnvironmentHERMES_HOME/home/ubuntu/.hermes/profiles/agent-b # Agent-B 的飞书凭证写在 .env 里也行但这里直接写更可靠 EnvironmentFEISHU_APP_IDcli_你的APP_ID EnvironmentFEISHU_APP_SECRET你的APP_SECRET EnvironmentFEISHU_DOMAINfeishu EnvironmentFEISHU_CONNECTION_MODEwebsocket EnvironmentFEISHU_ALLOW_ALL_USERStrue EnvironmentFEISHU_GROUP_POLICYopen ExecStart/home/ubuntu/.hermes/hermes-agent/venv/bin/python \ -m hermes_cli.main gateway run --replace --accept-hooks Restarton-failure RestartSec5 [Install] WantedBymulti-user.target然后执行sudo systemctl daemon-reload sudo systemctl enable hermes-agent-b sudo systemctl start hermes-agent-b sudo systemctl status hermes-agent-b # 确认正常运行⚠️ 五、血泪史第一大坑环境变量覆盖问题必看这是本文最有价值的部分——我在这上面浪费了一个下午。问题现象Agent-B 的 WebSocket 日志显示connected to wss://...飞书开放平台却显示连接失败反复重启、升级 SDK、改 Ping 间隔通通无效事故还原事情是这样的我一开始先用了一个飞书机器人 A 来配置 Agent-B跑了半天发现不行于是换成了机器人 B。然后我做了三件事1.改了 systemd 服务文件把FEISHU_APP_ID换成了机器人 B2.改了.env文件也把FEISHU_APP_ID换成了机器人 B3. 重启自信满满结果还是连不上。为什么因为我的.env文件里APP_ID 改成了 B但 APP_SECRET 还留着机器人 A 的 Secret根因深挖Hermes 的 Gateway 在启动时执行了这行代码# gateway/run.py第 11097 行 load_dotenv(_env_path, overrideTrue)注意最后的overrideTrue完整的加载链路是这样的systemd EnvironmentFEISHU_APP_ID机器人B ✅ 正确 systemd EnvironmentFEISHU_APP_SECRET机器人B的Secret ✅ 正确 ↓ Python 进程启动读取到 systemd 的值 ↓ load_dotenv(overrideTrue) 加载 .env 文件 ↓ .env 中的 FEISHU_APP_ID机器人B .env 中的 FEISHU_APP_SECRET机器人A的Secret ←— 残留覆盖了 systemd 的正确值 ↓ 进程用 机器人B 机器人A的Secret 去连飞书 → 认证失败overrideTrue意味着.env中的值无条件覆盖systemd 已经设好的值。你改 systemd 是没用的——只要.env里有残留最终用的是.env的。而且更坑的是我改完.env的 APP_ID 后自信地重启了根本没检查 APP_SECRET 也要同步改。结果飞书用错配的 APP_ID 旧 SECRET 连了半小时都说连接失败。排查方法如果你怀疑有这个问题直接检查进程内的实际环境变量# 找到 Agent-B 的 PID ps aux | grep hermes | grep gateway # 查看它实际使用的环境变量 sudo cat /proc/PID/environ | tr \0 \n | grep FEISHU注意/proc/PID/environ显示的是进程启动时的初始环境。Python 中os.getenv()返回的是load_dotenv(overrideTrue)覆盖后的值——这两个可能不一样正确配置方式方案 A推荐让.env和 systemd 保持完全一致逐项核对# 逐项对比 .env 和 systemd 中的 FEISHU 变量 echo .env grep ^FEISHU_ ~/.hermes/profiles/agent-b/.env echo systemd grep FEISHU_ /etc/systemd/system/hermes-agent-b.service检查清单变量.envsystemd一致FEISHU_APP_ID✅✅✅FEISHU_APP_SECRET❌ 旧Bot残留✅❌ 翻车FEISHU_ALLOW_ALL_USERSfalsetrue❌ 翻车FEISHU_ALLOWED_USERS主用户ID(未设)❌ 翻车FEISHU_CONNECTION_MODEwebsocketwebsocket✅FEISHU_DOMAINfeishufeishu✅我当初 APP_ID 和 SECRET 对了但 ALLOW_ALL_USERS 是false——结果 Agent-B 能连上飞书但拒绝响应任何人的消息因为用户授权检查没通过。方案 B更安全删除.env中的FEISHU_*变量只靠 systemd 的Environment传递。这样 dotenv 不会影响飞书配置。六、第二大坑Holographic Memory 镜像不完整Hermes 的 Holographic Memory 插件支持将内置 Memory 自动镜像到 SQLite 事实库fact_store。这样即使 Session 结束重要的信息也能在下次对话中召回。但有一个 Bug镜像代码只处理新添加add不处理更新replace。def on_memory_write(self, action, target, content): if action add and self._store and content: # ← 只处理 add self._store.add_fact(content, categorycategory)当 Memory 空间满了你用replace更新旧记录时fact_store不会同步更新。你会发现 Memory 里有这条信息但 fact_store 里查不到——相当于没有持久化。修复方法一行代码# 修改前 if action add and self._store and content: # 修改后 if action in (add, replace) and self._store and content:修改完重启 Hermes 即可。新创建的子 Agent 和主 Agent 共享同一份代码所以只要修一次两边都生效。七、验证多 Agent 是否正常重启后逐一验证# 1. 两个进程都在运行 ps aux | grep hermes_cli.*gateway | grep -v grep # 2. Agent-B 日志显示 WebSocket 已连接 sudo journalctl -u hermes-agent-b --no-pager | grep connected to wss # 3. 去飞书开放平台确认长连接状态已连接 # 4. 分别给两个 Bot 发消息都能正常回复八、总结环节关键点你需要做的去飞书开放平台申请一个机器人拿到 App ID 和 SecretAgent 帮你做的配置 systemd 服务、写 .env 文件、重启、验证——剩下的全自动部署环境腾讯云服务器Ubuntu公网 IP⚠️ 第一坑load_dotenv(overrideTrue)让.env覆盖 systemd——改 APP_ID 必须同步改 SECRET 和所有 FEISHU_*⚠️ 第二坑Holographic Memory 的 mirror 只处理add不处理replace安全隔离主 Agent 可以操作一切子 Agent 只在自己 Profile 范围内一台服务器上跑多个 Hermes Agent 并不复杂——真正的难点在于理解环境变量的加载顺序和完整替换。你不需要在飞书配置页面上折腾、不需要写复杂的 Python 代码、不需要手动处理进程管理。只需要去飞书开放平台申请一个机器人把 App ID 和 Secret 给到 Hermes Agent……剩下的Agent 能帮你搞定。希望这篇文章能帮你省下这半天
