Hermes多Agent部署实战指南:从安装到通讯,一篇搞定

你好，我是阳清，一个互联网资深架构师，专注 AI 编程、自动化工作流的出海实践，关注我一起学习交流！

说实话，玩 AI Agent 这一年，我见过太多"单兵作战"的选手——一个 Agent，一个模型，一个聊天窗口。能干活，但效率天花板就在那儿。

你想让它写代码、查资料、排版、发公众号？它一个人忙不过来，要么忘事，要么搞砸。

所以最近我在折腾 Hermes Agent 的多 Agent 部署。一个主控 Agent 负责指挥，几个子 Agent 各司其职——写代码的写代码，搜资料的搜资料，发消息的发消息。

搞明白这套东西之后，我才发现：Agent 不是越多越好，而是越分工越清晰越好。

这篇文章把踩过的坑、学到的经验、能复用的配置，全整理出来。看完你也能搭一套自己的多 Agent 团队。

一、Hermes 是什么？为什么要用它？

简单说，Hermes Agent 是 NousResearch 开源的一个 AI Agent 框架。

为什么不用 OpenClaw 直接搞？ 我也纠结过。但 Hermes 有几个优势：

原生支持多平台通讯：飞书、Telegram、Discord、Slack、WhatsApp、Signal，一套配置就能跑。
可以从 OpenClaw 迁移：你的老配置、老记忆、老技能，不用重来。
Gateway 设计：一个 Gateway 监听所有平台，子 Agent 通过 CLI 或者 Bridge 通讯，架构清晰。

一句话总结：OpenClaw 是单车，Hermes 是车队。单车够用，但跑长途还是车队靠谱。

二、安装：从 0 到 1

2.1 安装前确认

先检查环境：

# 检查 Python 版本python3 --version  # 应 >= 3.10# 检查 pippip3 --version# 检查 gitgit --version

坑点 1：Python 版本低于 3.10，会报各种依赖错误。别硬装，先升级。

2.2 克隆仓库

官方推荐用 git clone：

git clone https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agentcd ~/.hermes/hermes-agent

坑点 2：中国大陆网络，GitHub clone 经常超时。

解决方案：用 ZIP 下载：

cd /tmpcurl -fsSL https://github.com/NousResearch/hermes-agent/archive/refs/heads/main.zip -o hermes.zipunzip -q hermes.zipmv hermes-agent-main ~/.hermes/hermes-agentcd ~/.hermes/hermes-agent

2.3 安装依赖

# 安装 uv（用 pip，更安全）pip install uv# 创建虚拟环境uv venv venv --python 3.11source venv/bin/activate# 安装所有依赖uv pip install -e ".[all]"

坑点 3：直接用 pip install -e . 会漏掉一些可选依赖（比如飞书需要的 lark-oapi）。用 .[all] 一次性装全。

2.4 验证安装

hermes --version# 输出类似：Hermes Agent v0.7.0

看到版本号，说明第一步成功了。

三、配置：从 OpenClaw 迁移

3.1 自动迁移（推荐）

Hermes 自带迁移工具，能一键把 OpenClaw 的配置搬过来：

# 先预览，不实际执行hermes claw migrate --source ~/.openclaw --dry-run# 执行迁移（包含密钥）hermes claw migrate --source ~/.openclaw --migrate-secrets -y

迁移内容：

SOUL.md（人设）
MEMORY.md（记忆）
USER.md（用户信息）
Skills（技能）
模型配置（OpenRouter、百炼等）
飞书/Telegram 配置

一句话：你以前在 OpenClaw 上花了多少时间调的配置，Hermes 都能继承。不用从头填表格。

3.2 手动迁移（备选）

如果自动迁移失败（极少情况），手动来：

# 创建配置目录mkdir -p ~/.hermes/{memories,skills,cron,sessions,logs}# 编辑 .env（模型配置）cat >> ~/.hermes/.env << EOFOPENAI_API_KEY=sk-YOUR_API_KEYOPENAI_BASE_URL=https://coding.dashscope.aliyuncs.com/v1EOF# 飞书配置cat >> ~/.hermes/.env << EOFFEISHU_APP_ID=YOUR_APP_IDFEISHU_APP_SECRET=YOUR_APP_SECRETFEISHU_CONNECTION_MODE=websocketEOF

3.3 配置文件对比

OpenClaw	Hermes	说明
`openclaw.json`	`config.yaml` + `.env`	配置分离，密钥放 .env
`models.providers`	`model` + `OPENAI_API_KEY`	模型配置更简洁
`channels.feishu`	`FEISHU_*` 环境变量	网关配置用环境变量
`MEMORY.md`	`memories/` 目录	记忆系统支持分片

四、多 Agent 通讯：怎么让它们"说话"

这是 Hermes 的核心玩法。有三种通讯方式：

4.1 方式一：Gateway + CLI

主 Agent 通过 Gateway 接收用户消息，子 Agent 通过 CLI 执行任务：

# 启动 Gateway（主控）hermes gateway run &# 子 Agent 用 CLI 执行任务hermes chat -q "搜索 OpenClaw 最新文档"

适用场景：主 Agent 在飞书/Telegram 接用户消息，子 Agent 在后台干活，结果返回给主 Agent。

4.2 方式二：Hermes Bridge（OpenClaw 桥接）

如果你还想用 OpenClaw 做主控，Hermes 做子 Agent，可以用 hermes-bridge：

# 在 OpenClaw 中调用 Hermes~/.local/bin/hermes chat -q "Write a Python script to monitor CPU"

适用场景：OpenClaw 是你的主系统，Hermes 是"外援"，需要时调用。

4.3 方式三：Multi-Agent Group Chat（群聊协作）

这套更有意思——多个 Agent 在同一个群里"讨论"：

用户 @BossBot → Boss 分配任务 → 子 Agent 执行                              ↓                    【自动发到群里】                              ↓                    用户看到全过程

安装插件：

clawhub install multi-agent-group-chat

配置示例：

{"agents":{"entries":{"boss":{"workspace":"~/.openclaw/agents/boss"},"coder":{"workspace":"~/.openclaw/agents/coder"},"researcher":{"workspace":"~/.openclaw/agents/researcher"}}},"channels":{"telegram":{"accounts":{"boss":{"token":"BOT_TOKEN_1","agent":"boss"},"coder":{"token":"BOT_TOKEN_2","agent":"coder"},"researcher":{"token":"BOT_TOKEN_3","agent":"researcher"}}}}}

一句话：你 @BossBot 发一个任务，它分配给 coder 和 researcher，干完之后结果自动出现在群里。像看团队现场干活一样。

五、开机自启：别让 Gateway 挂了

Agent 24 小时在线，Gateway 不能断。配置自启动：

5.1 Linux (systemd)

# 创建服务sudotee /etc/systemd/system/hermes-gateway.service > /dev/null << 'EOF'[Unit]Description=Hermes Gateway ServiceAfter=network.target[Service]Type=simpleUser=rootWorkingDirectory=/root/.hermesExecStart=/usr/bin/python3 /usr/local/bin/hermes gateway runRestart=alwaysRestartSec=10[Install]WantedBy=multi-user.targetEOF# 启用sudo systemctl daemon-reloadsudo systemctl enable hermes-gateway.servicesudo systemctl start hermes-gateway.service

5.2 cron 双重保护

crontab -e# 每 5 分钟检查*/5 * * * * systemctl is-active hermes-gateway >/dev/null || systemctl start hermes-gateway# 每天凌晨 3 点预防性重启（防止内存泄漏）0 3 * * * systemctl restart hermes-gateway

六、避坑指南：我踩过的坑

坑 1：飞书连接失败

症状：No messaging platforms enabled

原因：.env 里没配置飞书凭证，或者写错了。

解决：

cat ~/.hermes/.env | grep FEISHU# 确认 FEISHU_APP_ID 和 FEISHU_APP_SECRET 有值

坑 2：401 认证错误

症状：Error code: 401 - Missing Authentication header

原因：模型 API Key 没配置到 config.yaml。

解决：

model:default:"qwen3.5-plus"base_url:"https://coding.dashscope.aliyuncs.com/v1"api_key:"sk-YOUR_API_KEY"# 这行必须有

坑 3：Gateway 启动失败

症状：Failed to connect to bus: No medium found

原因：systemd 在某些容器环境不工作。

解决：直接跑，不用 systemctl：

hermes gateway run &

坑 4：权限问题

症状：Permission denied

解决：

chmod 700 ~/.hermeschown -R $USER:$USER ~/.hermes

坑 5：子 Agent 之间不通讯

症状：Boss 分配任务，子 Agent 不回复。

原因：没配置 sessions_send 或者没用 Bridge。

解决：确认以下两点：

主 Agent 配置了 sessions_spawn 或 sessions_send
子 Agent 的 workspace 路径正确

七、经验总结：三条原则

折腾完这套多 Agent 系统，我总结出三条原则：

原则一：分工要清晰。一个 Agent 负责一个领域——写代码的不搜资料，搜资料的不排版。边界不清，就会打架。

原则二：通讯要简单。Gateway + Bridge 足够，不要搞复杂的消息队列。Agent 之间能说话就行，不需要什么分布式系统。

原则三：监控要到位。日志、健康检查、自动重启，这三样必须有。Agent 挂了你不知道，用户来问你才发现，尴尬。

八、验证清单

部署完成后，逐项检查：

hermes --version 有输出
hermes gateway status 显示 running
飞书能收到消息并回复
systemd/cron 自启动已配置
日志无 error 信息
子 Agent 能被主 Agent 调用

一句话收尾：Agent 的价值不在单个有多强，而在团队能跑多稳。搭好这套系统，你就有了一支 24 小时在线的 AI 团队。

祝：搭出自己的 AI 团队。

阳清的数字资产

阳清博客：https://blog.yangqing.one

卡路里：https://calorieai.yangqing.one

n8n模板：https://getn8ntemplates.com

电影站：https://123freemovies.site/en/

#阳清一人企业 #getn8ntemplates #AI编程 #n8n #openclaw #opencode #AgentCoding #opc