🤖HermesBlog
EN
Hermes 消息平台接入 · 第32篇2026/8/9· Easy Understand Hermes Agent

企业微信接入

Hermes 消息平台接入第32篇：企业微信。公司内部用 AI 助手。

这篇教程教你如何把 Hermes Agent 智能体接入企业微信，让它能在你的企业微信群里聊天、发文件、回消息。

准备工作

在开始之前，你需要三样东西：

  1. 一个企业微信组织账号（就是公司用的那个企业微信）
  2. 管理员权限（用来创建应用）
  3. 电脑上装好 Python（Hermes 的运行环境）

别担心，整个过程不需要你懂编程，跟着步骤走就行。

第 1 步：创建 AI 机器人

想象一下，你要在公司里开一个“机器人同事”，第一步就是给它办“入职手续”。

推荐方式：扫码一键创建

打开终端（命令行窗口），输入：

hermes gateway setup

选择 WeCom，屏幕上会出现一个二维码。用企业微信手机版扫码，Hermes 会自动帮你完成所有设置，就像扫码登录网页版微信一样简单。

手动方式（扫码不可用时）

  1. 登录企业微信管理后台
  2. 进入 应用管理 → 创建应用 → AI 机器人
  3. 填写机器人名字和介绍
  4. 在凭证页面找到 Bot ID 和 Secret（相当于机器人的“工号和密码”）
  5. 回到终端，运行 hermes gateway setup，选择 WeCom，手动输入刚才复制的信息

⚠️ 重要：Secret 就是机器人的“银行卡密码”，千万别泄露！ 任何人拿到它都能冒充你的机器人。

第 2 步：配置 Hermes

方式 A：交互式配置（推荐）

再次运行：

hermes gateway setup

跟着向导走，它会问你三个问题：

  • 机器人凭证（扫码或手动输入）
  • 谁能跟机器人聊天（所有人 / 白名单 / 仅自己）
  • 通知发到哪个群

方式 B：手动改配置

用记事本打开 ~/.hermes/.env 文件，填入：

WECOM_BOT_ID=你的机器人ID
WECOM_SECRET=你的机器人密码

# 可选：限制谁能私聊机器人
WECOM_ALLOWED_USERS=用户ID1,用户ID2

# 可选：定时通知发到哪个群
WECOM_HOME_CHANNEL=群聊ID

第 3 步：启动机器人

hermes gateway

看到 “connected” 字样就说明成功了！现在去企业微信里给你的机器人发条消息试试吧。

进阶设置（可选）

限制使用人群：如果你只想让特定同事用机器人，可以设置“白名单”：

WECOM_DM_POLICY=allowlist   # 只允许白名单用户私聊
WECOM_GROUP_POLICY=allowlist  # 只允许白名单群使用

按群精细管控：在 config.yaml 里，你可以指定“A 群只有张三能用，B 群只有李四能用”，就像给每个群发不同的门禁卡。

它能做什么？

  • 收发消息：文字、图片、文件、语音、视频都能处理
  • 自动解密：企业微信加密的文件，Hermes 会自动解密
  • 自动重连：网络断了会自动恢复，不用你操心
  • 回复关联：机器人回复时会自动“@“

对应的那条消息，聊天体验更自然

小总结

接入企业微信就像给公司请了个24 小时在线的数字员工：扫码创建 → 配置权限 → 启动运行，三步搞定。最棒的是它通过 WebSocket 长连接通信，不需要公网 IP 或服务器，内网也能用。

下篇预告：下一篇我们聊聊如何给机器人设置“门禁”——企业微信回调模式（WeCom Callback），让机器人能主动接收外部消息，敬请期待！

📖 官方文档

本文根据 Hermes Agent 官方文档编写，原文见：官方文档 › user-guide/messaging/wecom

← 返回全部文章