企业微信接入 AI 机器人指南

为什么企业微信适合托管机器人

企业微信的智能机器人走的是长连接：机器人主动连到企业微信服务器，而不是等企业微信来 访问你。这意味着不需要公网 IP、不需要备案域名、也不需要做端口映射，托管实例可以直接 连上，这一点比很多需要回调地址的平台省事得多。

个人微信和企业微信是两套完全不同的东西。本文讲的是企业微信（WeCom）。如果您要接的是 个人微信，请在控制台的「连接平台」里直接扫码，那边是一键连接的。

准备工作

• 一个企业微信管理后台的管理员账号，能创建应用或机器人。
• 一个已经部署好的 OpenClaw 或 Hermes 实例。
• 知道哪些同事需要用这个机器人，方便后面设置可见范围。

第一步：创建智能机器人

登录企业微信管理后台，创建一个智能机器人，填写名称、头像和简介。创建完成后，后台会 给出两个关键信息：机器人的 BotID 和 Secret。Secret 只显示一次，请当场保存好。

接着设置可用范围，也就是哪些成员或部门可以和这个机器人对话。建议先只放开自己或一个 小部门，测试通过之后再逐步扩大，避免一上来全公司都在用、消耗超出预期。

第二步：配置 Hermes

在实例的网页终端里运行引导式配置，选择 WeCom：

hermes gateway setup

也可以直接写配置：

WECOM_BOT_ID=你的-bot-id
WECOM_SECRET=你的-secret

# 可选：限制可以对话的成员
WECOM_ALLOWED_USERS=user_id_1,user_id_2

# 可选：定时任务和通知的默认发送目标
WECOM_HOME_CHANNEL=chat_id

WECOM_HOME_CHANNEL 值得配一下。定时任务、提醒这类不是由人触发的消息， 需要知道往哪里发，没配的话这些消息就没有默认去处。

配置完成后重启网关，让新配置生效。

第二步（OpenClaw 版）：安装企业微信插件

OpenClaw 这边走的是腾讯官方发布的企业微信插件，同样使用 BotID 和 Secret：

openclaw plugins install npm:@wecom/wecom-openclaw-plugin

安装完成后按插件说明填入 BotID 与 Secret，然后检查通道状态：

openclaw channels status --probe

第三步：测试

在企业微信里找到这个机器人，发一条消息试试。正常情况下几秒内就会收到回复。如果没有 反应，先确认自己是不是在可用范围里面——这是最常见的原因，机器人本身其实是好的。

常见问题

• 发消息没有任何反应：先检查可用范围有没有包含自己，再检查 Secret 是否填错或已经 重新生成过。
• 之前能用，突然不回了：Secret 被重置过的话，旧的就失效了，需要把新的重新填进去。
• 群里不回复：机器人在群聊中通常需要被 @ 到才会响应，这是正常行为。
• 定时任务没发出来：多半是没有配 WECOM_HOME_CHANNEL，任务跑了但不知道 发给谁。

需要我们代为配置吗

如果不想自己折腾，可以在 控制台 联系客服，我们帮您在 实例上配置好。请不要把 Secret 直接发在聊天里，我们会告诉您填在哪里。