Hermes Agent多平台接入需配置消息网关，方法包括：一、交互式命令行（hermes gateway setup）；二、手动编辑config/gateway.yaml；三、Docker环境变量注入；四、Nginx反向代理实现多租户隔离。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已部署Hermes Agent核心服务，但尚未在飞书、企业微信、钉钉等平台中启用AI助手，则问题可能出在消息网关未正确配置。以下是实现多平台接入的多种网关配置方法：
一、通过交互式命令行配置网关
该方法利用hermes内置的setup向导，自动完成平台凭证录入与基础路由设置，适用于首次快速接入单个平台。
1、在已部署Hermes Agent的服务器终端中执行：hermes gateway setup。
2、在向导提示中选择目标平台，例如输入feishu、wechatwork或dingtalk。
3、依次输入该平台提供的App ID、App Secret及可选的User IDs（留空表示开放给所有用户）。
4、确认Domain字段为对应平台默认值（如feishu、wechatwork），Connection mode选择websocket以获得低延迟响应。
5、完成配置后，系统将自动生成gateway配置文件并重启相关服务进程。
二、手动编辑YAML配置文件接入
该方式适用于批量接入多个平台或需精细控制回调路径、超时策略与消息过滤规则的场景，配置文件位于config/gateway.yaml。
1、使用文本编辑器打开config/gateway.yaml。
2、在adapters:节点下新增对应平台区块，例如添加钉钉适配器：
3、填入app_key、app_secret、encrypt_key和verification_token四项必填凭证。
4、为每个平台指定独立的webhook_path（如/webhook/dingtalk），确保反向代理能正确分发请求。
5、保存文件后执行hermes gateway reload使配置生效。
三、使用Docker环境变量动态注入
该方法专为容器化部署设计，避免修改镜像内文件，支持运行时切换平台配置，适合CI/CD流水线集成。
1、启动容器时通过-e参数传入平台凭证，例如：-e GATEWAY_ADAPTER=dingtalk -e DINGTALK_APP_KEY=xxx。
2、确保环境变量命名与Hermes源码中gateway/adapters/dingtalk.py定义的加载键完全一致。
3、在docker-compose.yml中为gateway服务块添加对应environment字段，并映射宿主机端口至容器8000端口。
4、验证容器日志是否输出[INFO] Loaded DingTalk adapter with webhook_path=/webhook/dingtalk。
5、检查容器网络是否允许外部平台服务器访问该端口，必要时配置云防火墙规则。
四、基于Nginx反向代理实现多租户隔离
该方案用于同一套Hermes实例服务多个组织，通过子域名或路径前缀区分不同客户的消息流，保障会话数据物理隔离。
1、在Nginx配置中为每个客户创建独立server块，例如feishu.customer-a.example.com。
2、在location /段中添加proxy_set_header X-Platform feishu与X-Tenant customer-a头信息。
3、将请求转发至Hermes Gateway统一入口（如http://localhost:8000/gateway/proxy）。
4、修改gateway/run.py中请求解析逻辑，在get_platform_from_request()函数内读取上述header值。
5、根据X-Tenant值动态加载对应SQLite数据库文件（如hermes_state_customer_a.db）。
