Hermes Agent支持多账号网关管理，需在config.yaml中配置accounts列表，或通过hermes gateway add命令添加，也可用环境变量隔离实例，配置后需验证日志中account前缀是否准确。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您需要在 Hermes Agent 中同时管理多个通讯平台账号（如企业微信、钉钉、飞书等），但网关服务仅识别单一账号配置，则可能是由于网关配置未启用多账号支持或配置文件未正确划分账号实例。以下是实现 Hermes Agent 网关服务多账号管理的具体操作路径：
一、确认网关服务支持多账号模式
Hermes Agent 自 2026 年 4 月起默认启用 multi-account gateway 模式，其核心依赖于 ~/.hermes/config.yaml 中的 accounts 字段嵌套结构，而非旧版单一 account 配置。若 config.yaml 中仍为顶层 account: {} 形式，则需升级配置格式以启用多账号能力。
1、打开终端，进入 Hermes Agent 配置目录：
cd ~/.hermes
2、检查当前 config.yaml 是否含 accounts 列表结构：
cat config.yaml | grep -A 5 "accounts:"
3、若输出为空或显示 account:，说明尚未启用多账号模式，需执行格式迁移。
二、手动配置多账号网关入口
该方法适用于所有部署方式（计算巢、无影云电脑、轻量服务器），通过直接编辑 config.yaml 定义多个独立账号实例，每个实例绑定唯一 platform、token 和 session_id，确保消息路由隔离。
1、使用文本编辑器打开主配置文件：
nano config.yaml
2、定位到 gateways: 区块，在其下添加 accounts: 列表，示例如下：
gateways:
accounts:
- platform: wecom
name: marketing-team
corpid: "wwxxxxxxxxxxxxxx"
corpsecret: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
agentid: 10001
- platform: dingtalk
name: dev-ops
appkey: "dingoakxxxxxxxxxxxxxx"
appsecret: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
3、保存并退出编辑器（nano 中按 Ctrl+O 回车，Ctrl+X 退出）。
4、重启 Hermes Agent 服务使配置生效：
hermes service restart
三、使用 hermes cli 批量注册账号
该方法通过命令行交互式注入账号凭证，自动校验 token 有效性并写入 accounts 列表，避免手动 YAML 语法错误，适合批量初始化场景。
1、执行多账号注册命令：
hermes gateway add
2、按提示依次选择平台类型（输入 1 选 wecom，2 选 dingtalk，3 选 feishu 等）。
3、输入该账号专属名称（如 finance-group），不可与已有账号 name 重复。
4、粘贴对应平台的认证凭证（corpid+corpsecret 或 appkey+appsecret 等），CLI 将实时调用平台接口验证连通性。
5、验证成功后，自动追加至 config.yaml 的 accounts 列表并生成唯一 session_id。
四、基于环境变量分离多账号配置
当同一台服务器需运行多个 Hermes Agent 实例（如不同部门隔离部署），可利用 .env 文件配合实例级启动参数，实现物理隔离的多账号网关服务，避免配置文件交叉污染。
1、为每个账号创建独立环境变量文件：
touch ~/.hermes/env-marketing.env
touch ~/.hermes/env-support.env
2、在 env-marketing.env 中写入：
HERMES_GATEWAY_PLATFORM=wecom
HERMES_GATEWAY_NAME=marketing-team
HERMES_WECOM_CORPID=wwxxxxxxxxxxxxxx
HERMES_WECOM_CORPSECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
3、启动时指定对应环境文件：
hermes --env-file ~/.hermes/env-marketing.env service start
4、重复步骤 2–3 配置另一账号，使用不同 --env-file 路径启动独立进程。
五、验证多账号路由准确性
配置完成后必须验证各账号消息是否被正确分发至对应 gateway 实例，防止因 session_id 冲突或 platform 识别失败导致消息错投。
1、向企业微信 marketing-team 账号发送测试消息“/status”。
2、检查 Hermes Agent 日志中是否出现含 [account: marketing-team] received message 的条目。
3、同步向钉钉 dev-ops 账号发送相同指令，确认日志中对应条目显示 [account: dev-ops] 前缀且无交叉标识。
4、若任一账号日志中出现 “fallback to default account” 提示，说明该账号未被 gateway 正确加载，需返回步骤二核查 YAML 缩进或字段名拼写。
