企业微信智能机器人最近上线了长连接模式,对于将 OpenClaw 部署在本地环境的用户来说,这次更新非常实用。
过去,如果想把企业微信机器人接入 OpenClaw,通常需要采用 callback 回调方案。
这意味着你必须准备一个可被公网访问的地址,完成回调 URL 配置,同时还要处理消息加解密相关逻辑。
如果 OpenClaw 本身运行在本地环境中,往往还得额外折腾内网穿透,整体接入门槛并不低。
现在情况有了明显变化。
企业微信已经支持通过 WebSocket 长连接 的方式接收机器人消息。也就是说,开发者服务可以主动与企业微信建立连接,不再强制要求提供公网回调地址。
对于本地部署的 OpenClaw 而言,只要当前机器能够正常访问外网,就可以直接完成接入,无需公网 IP,也不需要域名,更不用再配置内网穿透。
这次更新的核心变化是什么?
目前,企业微信为智能机器人提供了两种消息接收方式:
-
Webhook 短连接
-
WebSocket 长连接
两者最关键的区别主要体现在以下几个方面:
-
Webhook 需要配置一个可被公网访问的回调 URL;如果是认证企业,通常还涉及与企业相关的备案域名要求
-
WebSocket 长连接 不要求固定公网 IP
-
Webhook 模式下需要处理消息加解密
-
WebSocket 长连接 则无需处理这套 callback 加解密逻辑
对于 OpenClaw 用户来说,长连接模式显然更适合本地开发、局域网部署以及小团队内部使用。
为什么这对 OpenClaw 尤其重要?
OpenClaw 很适合用于搭建企业微信中的本地知识库助手、内部问答机器人、流程提醒机器人以及通知机器人。
但此前最让人头疼的,往往并不是业务逻辑,而是接入时的网络环境配置。
在长连接模式上线之后,整体链路被大幅简化:
-
在本地启动 OpenClaw
-
由 OpenClaw 主动连接企业微信的 WebSocket 地址
-
企业微信通过这条长连接将消息推送过来
-
OpenClaw 完成处理后再直接返回结果
换句话说,企业微信不再需要反向回调你的本地服务,而这正是本地部署 OpenClaw 最理想的接入方式。
具体操作步骤
1. 在企业微信后台开启长连接模式
进入企业微信智能机器人的配置页面,开启 API 模式,然后选择 长连接。
启用之后,你会获得两项关键凭证:
-
BotID
-
Secret

后续需要将这两个参数写入 OpenClaw 配置中。
2. 安装企业微信 OpenClaw 插件
官方已经提供对应插件:@wecom/wecom-openclaw-plugin。
根据插件包信息,建议使用的 OpenClaw 版本至少为 2026.1.29 及以上。
安装命令如下:
openclaw plugins install @wecom/wecom-openclaw-plugin
如果后续需要升级插件,可执行:
openclaw plugins update wecom
3. 写入 OpenClaw 配置
最小可用配置如下:
openclaw config set channels.wecom.botId
openclaw config set channels.wecom.secret
openclaw config set channels.wecom.enabled true
openclaw gateway restart
配置完成后,OpenClaw 会主动尝试连接企业微信的长连接网关:
wss://openws.work.weixin.qq.com
4. 测试消息收发
完成上述配置后,进入企业微信机器人会话窗口,向机器人发送一条消息,重点检查以下两项:
-
OpenClaw 日志中是否成功收到消息
-
企业微信中是否能够正常收到机器人回复
如果这两项都没有问题,就说明本地 OpenClaw 已经通过长连接模式成功接入企业微信。
有几个注意事项需要提前了解
1. 长连接模式与 callback 模式不能同时启用
同一个机器人只能二选一:要么使用长连接模式,要么继续使用原来的回调地址模式。
一旦切换到长连接,原先的 callback 配置将不再继续生效。
2. 同一个机器人同一时刻只能保留一条有效长连接
如果你在两台机器上同时使用同一个 BotID 建立连接,新连接会把旧连接挤掉。
因此,建议测试环境和正式环境分别使用不同的机器人,以免互相影响。
3. 虽然不需要公网暴露,但本地机器仍然必须能够主动访问外网
这次更新解决的是“外部服务无法访问你的本地服务”的问题,并不意味着“本地机器不需要联网”。
你的 OpenClaw 所在主机,依然需要能够访问企业微信的 WebSocket 地址。
4. 主动推送消息仍存在限制
企业微信长连接模式支持主动推送消息,但前提是用户或群聊已经与机器人建立过会话。同时,主动推送本身也存在额度限制。
因此,它更适合用于通知、提醒、异步任务结果回传等场景,而不适合进行无节制的群发操作。
总结
这次企业微信机器人长连接模式的上线,真正解决了本地 OpenClaw 接入过程中最棘手的网络问题。
以前的接入方式通常意味着:
-
需要 callback
-
需要公网地址
-
需要域名
-
需要内网穿透
而现在,流程已经简化为:
-
在企业微信后台开启长连接
-
获取 BotID 和 Secret
-
安装
@wecom/wecom-openclaw-plugin -
写入 OpenClaw 配置
-
本地直接连接企业微信
如果你之前一直被 callback、公网 IP 或内网穿透问题卡住,那么这次更新基本意味着可以直接开始上手了。