Hermes 也能接入微信生态圈，实现远程操作，附保姆级手把手指南|hermes|生态圈|私聊

很多人用 Hermes，最明显的感受是：它能干活，但有点麻烦。

你坐在电脑前，打开终端，输入命令，让它查资料、整理文件、跑任务，这套流程当然没问题。可现实里，很多任务并不是发生在终端里。

你在路上收到一个文件，想让它先看一眼。
你在企业微信群里看到一段讨论，想让它顺手整理成待办。
你晚上突然想到一个问题，希望 Agent 明天早上给你一份摘要。
这时候，如果还要回到电脑前再操作，体验就断了。

Hermes 的消息网关里，已经提供了几种微信生态相关接入方式：个人微信、企业微信机器人、企业微信自建应用回调。它们名字看起来接近，但用途差别很大。

这篇就用大白话讲清楚：
个人微信适合做随身私聊入口；企业微信机器人适合团队群聊和私聊里的实时助手；企业微信自建应用回调适合更正式的企业部署、后台任务和多应用管理。

先把三条路线分清楚

第一条，是个人微信接入。

它适合个人用户，把 Hermes 接到微信私聊里。你在手机微信里发一句话，Hermes 在电脑或服务器上处理，再把结果回到微信里。

它不是把你的普通个人微信号完全变成机器人，也不建议把重点放在“普通微信群机器人”上。它连接的是腾讯 iLink 机器人身份，更可靠的使用方式是私聊。群消息能不能稳定送到 Hermes，要看底层接口是否真的把群事件送过来。很多时候，群里没有事件进入，就不是 Hermes 配错了。

所以个人微信这条路线，最适合的定位是：把 Hermes 变成微信私聊里的随身 Agent 入口。

第二条，是企业微信机器人。

这条更适合团队使用。它通过企业微信的机器人网关接入 Hermes，可以支持企业微信私聊和群聊。团队成员可以在企业微信里问问题、发截图、发文件，让 Hermes 在背后处理，再把结果发回群里或私聊里。

如果你只是想在团队里先跑通一个“企业微信里的 Hermes 助手”，优先看这条。

第三条，是企业微信自建应用回调。

这条路线更偏正式企业应用。你在企业微信后台创建一个自建应用，企业微信把用户发给应用的消息推送到 Hermes 的回调地址，Hermes 处理完以后，再主动把结果发回企业微信。

它的优点是更企业化，适合多部门、多应用、多企业部署；缺点是配置门槛更高，需要公网可访问地址，体验也更像“提交任务，稍后收到结果”，不太像实时聊天机器人。

个人微信：适合做随手可用的私聊助手

如果你想让 Hermes 出现在手机微信里，个人微信接入是最直观的一条路。

它最大的好处是，不需要你先折腾公网回调地址。很多人一听“接微信”，马上想到服务器、域名、回调、内网穿透，头就大了。个人微信这条路线使用的是长轮询方式，Hermes 主动去拉取消息，不需要你把本机暴露到公网。

先安装依赖：

pip install aiohttp cryptographypip install hermes-agent[messaging]

然后运行配置向导：

hermes gateway setup

选择个人微信相关选项。终端会显示二维码，或者给出二维码链接。用手机微信扫码确认后，Hermes 会保存账号凭据。

接着在 .env 里至少配置：

WEIXIN_ACCOUNT_ID=your-account-id

建议一开始就把私聊入口收紧，不要开放给所有人：

WEIXIN_DM_POLICY=allowlistWEIXIN_ALLOWED_USERS=user_id_1,user_id_2WEIXIN_HOME_CHANNEL=chat_id

最后启动消息网关：

hermes gateway

这时你就可以在微信私聊里给 Hermes 发任务。

它适合做什么？

比如你在外面看到一段资料，直接转给 Hermes，让它整理成摘要。你把一段语音发给它，让它提炼重点。你把一个文件丢给它，让它先做初步阅读。个人微信适配器支持图片、视频、文件、语音等媒体，Hermes 收到后会下载、解密、缓存，再交给 Agent 处理。

这里有一个很重要的提醒：不要把个人微信接入写成“微信群机器人终于可用了”。

更稳妥的说法是：Hermes 可以接入个人微信私聊，适合做随身入口；至于普通微信群，要看底层事件是否能稳定进入，不能把它当成主要卖点。

企业微信机器人：团队使用优先选它

如果你要把 Hermes 放到团队工作场景里，企业微信机器人通常是更合适的第一步。

它不需要公网回调地址，配置起来比自建应用回调简单。你可以把它理解成：给企业微信里加一个 Hermes 机器人，团队成员在私聊或群聊里和它交互。

推荐从配置向导开始：

hermes gateway setup

选择企业微信机器人。按提示用企业微信手机端扫码，或者手动填写机器人编号和密钥。

如果手动配置，.env 大概是这样：

WECOM_BOT_ID=your-bot-idWECOM_SECRET=your-secretWECOM_ALLOWED_USERS=user_id_1,user_id_2WECOM_HOME_CHANNEL=chat_id

启动：

hermes gateway

这里一定要注意，WECOM_SECRET 要当成密钥处理。不要截图发群，不要写进公开仓库，不要放进文章示例里的真实配置。

企业微信机器人这条路线，最适合几类场景。

比如团队内部问答。新人不知道项目规范、上线流程、常用命令，可以直接在企业微信里问 Hermes。

比如项目群总结。群里讨论完一堆需求，@ 一下 Hermes，让它整理成待办、风险点和下一步安排。

比如文件和截图处理。企业微信群里经常发报错截图、表格、文档。把这些交给 Hermes，比复制到终端里自然很多。

不过，企业微信场景一定要认真做访问控制。个人用错了，最多自己回滚；团队群里开太大，问题就麻烦了。

建议一开始就用白名单：

WECOM_DM_POLICY=allowlistWECOM_ALLOWED_USERS=user_id_1,user_id_2WECOM_GROUP_POLICY=allowlist

如果只想让某个群里的指定成员能唤起 Hermes，也可以在配置里按群设置允许的发送者。这个细节很实用，因为很多企业微信群里人很多，不是每个人都应该能让 Agent 调工具、读文件、跑任务。

企业微信机器人更像“团队实时助手”。如果你希望 Hermes 在企业微信群里比较自然地参与协作，先跑通这条路线。

企业微信自建应用回调：适合正式企业部署

企业微信自建应用回调，比企业微信机器人更正式，也更复杂。

它的工作方式是：你在企业微信后台创建自建应用，用户给这个应用发消息；企业微信把加密消息推送到 Hermes 的公网回调地址；Hermes 接收、解密、处理，最后再通过企业微信接口把结果发回用户。

这条路线需要几个前提：

你有企业微信企业账号。
你有管理员权限。
你有公网可访问的服务器地址，或者临时调试用内网穿透。
你能拿到企业编号、应用密钥、应用编号、回调令牌、消息加解密密钥。

回调地址通常类似：

http://YOUR_PUBLIC_IP:8645/wecom/callback

.env 示例：

WECOM_CALLBACK_CORP_ID=your-corp-idWECOM_CALLBACK_CORP_SECRET=your-corp-secretWECOM_CALLBACK_AGENT_ID=1000002WECOM_CALLBACK_TOKEN=your-callback-tokenWECOM_CALLBACK_ENCODING_AES_KEY=your-43-char-aes-keyWECOM_CALLBACK_HOST=0.0.0.0WECOM_CALLBACK_PORT=8645WECOM_CALLBACK_ALLOWED_USERS=user1,user2

启动还是：