需依次完成五步配置：一、企业微信后台创建自建应用并记录corpid/agentid/secret；二、开通im:msg:read、im:msg:send、user:contact:readonly权限；三、配置可信ip、开启接收消息、设置token与encodingaeskey；四、在hermes中执行gateway setup并填入对应凭证；五、发布应用版本并通过客户端测试消息。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已部署 Hermes Agent 并希望将其接入企业微信实现消息收发，但无法正常接收或响应用户消息，则很可能是由于自建应用未正确创建、权限未开通或回调配置缺失。以下是解决此问题的步骤：
一、在企业微信管理后台创建自建应用
该步骤用于注册 Hermes Agent 在企业微信中的身份，获取唯一应用凭证，是后续所有配置的前提。
1、使用管理员账号登录企业微信管理后台。
2、进入「应用管理」→「自建」→「创建应用」。
3、填写应用名称（例如 Hermes AI 助手），上传图标（可选），点击「创建应用」。
4、创建成功后，在应用详情页记录以下三项关键信息：CorpID、AgentId、Secret。
二、配置消息收发与用户信息读取权限
企业微信要求显式声明所需权限，仅启用应用本身不足以支持消息互通；必须授予 Hermes Agent 读取消息内容及用户基础信息的能力。
1、在应用详情页，点击左侧菜单「权限管理」。
2、点击「添加权限」，选择「API接口权限」。
3、勾选以下必需权限项：im:msg:read（读取消息）、im:msg:send（发送消息）、user:contact:readonly（读取用户基本信息）。
4、点击「保存并发布」，等待管理员审批通过（如需）。
三、设置可信IP与事件回调地址
企业微信为保障安全，强制要求将 Hermes Agent 所在服务器的公网IP加入可信列表，并配置HTTP回调URL以接收实时消息事件。
1、进入「应用管理」→「自建」→ 找到已创建的应用 → 点击「设置」→「接收消息」。
2、在「可信域名/IP」区域，点击「配置」，填入 Hermes Agent 服务运行机器的公网IPv4地址（非内网地址，如123.56.78.90）。
3、在「接收消息」设置中，开启「接收消息」开关。
微信聊天分析助手 v2.1.0 — 完全本地运行的隐私保护工具。 分析聊天记录，推断 MBTI 与大五人格，检测情感趋势，生成可视化报告。 支持 jieba 精准分词、否定识别、反讽检测、风险预警。 内置 RAG 检索增强预测和多智能体博弈模拟，完全本地化、零数据外传。 可选 MiroFish 群体智能引擎增强对话预测。
4、填写「Token」和「EncodingAESKey」（二者需与 Hermes 配置文件中一致），系统将自动生成并显示。
5、复制「企业微信服务器URL」（格式为 https://your-server-ip:3000/webhook/wecom），该地址将用于下一步 Hermes 配置。
四、在 Hermes 中完成企业微信网关配置
该步骤将企业微信的凭证与回调能力注入 Hermes Agent 运行时，使其能解析加密消息、验证签名并转发至AI核心处理链路。
1、在 Hermes Agent 所在服务器终端执行命令：hermes gateway setup。
2、在交互式向导中，选择平台：wecom。
3、依次输入上文记录的：CorpID、AgentId、Secret。
4、输入与企业微信后台一致的：Token 和 EncodingAESKey。
5、确认 User IDs 字段为空（表示全量成员可用）或填入测试成员的 UserID（可通过通讯录成员详情页查看「账号」字段获取）。
五、发布应用并验证消息通路
企业微信要求自建应用完成发布流程后，其消息能力才对组织内成员生效；未发布的应用即使配置完整也无法收发消息。
1、返回企业微信管理后台，进入「应用管理」→「自建」→ 应用详情页。
2、点击右上角「版本管理与发布」→「创建新版本」。
3、填写版本描述（例如“Hermes Agent v1.0 接入”），点击「提交审核」。
4、由企业微信超级管理员或应用管理员完成审批并「发布」该版本。
5、发布完成后，在企业微信客户端搜索应用名称，进入应用主页，点击「去使用」，发送测试消息（如“你好”）。
