10+年产品经理专注分享AI 工具、AI 资讯、AI Coding、Vibe Coding与下一代产品创新,按 Ctrl+D 收藏我们
关于我 留言板 小程序 标签云

苏米客

  • 首页
  • AIGC
    • AI最新动态
    • AI学习教程
    • AI工具集合
    • AI产品百科
    • AI编程开发
    • AI提示词
    • AI开源项目
    • AI智能体
  • Axure
    • Axure动态
    • Axure教程
  • 产品
    • 用户体验
    • 产品设计
    • 苏米杂谈
  • 资源
    • 产品UI组件库
    • 开源图标库
    • 中后台框架
  • 书单
    • AI书籍
    • 用户体验
    • UI视觉
    • 产品研究
    • 其他类型
  • 下载
    • Axure组件
    • Axure原型
    • 文档报告
    • 素材资源
  • 登录
  • 首页
  • AIGC
    • AI最新动态
    • AI学习教程
    • AI工具集合
    • AI产品百科
    • AI编程开发
    • AI提示词
    • AI开源项目
    • AI智能体
  • Axure
    • Axure动态
    • Axure教程
  • 产品
    • 用户体验
    • 产品设计
    • 苏米杂谈
  • 资源
    • 产品UI组件库
    • 开源图标库
    • 中后台框架
  • 书单
    • AI书籍
    • 用户体验
    • UI视觉
    • 产品研究
    • 其他类型
  • 下载
    • Axure组件
    • Axure原型
    • 文档报告
    • 素材资源
当前位置: 首页 » AI智能体

OpenClaw 接入企微迎来重要升级:无需公网 IP 和域名,本地即可直连,附完整配置说明

4月前 AI智能体 2029 0

企业微信智能机器人最近上线了长连接模式,对于将 OpenClaw 部署在本地环境的用户来说,这次更新非常实用。

过去,如果想把企业微信机器人接入 OpenClaw,通常需要采用 callback 回调方案。

这意味着你必须准备一个可被公网访问的地址,完成回调 URL 配置,同时还要处理消息加解密相关逻辑。

如果 OpenClaw 本身运行在本地环境中,往往还得额外折腾内网穿透,整体接入门槛并不低。

现在情况有了明显变化。

企业微信已经支持通过 WebSocket 长连接 的方式接收机器人消息。也就是说,开发者服务可以主动与企业微信建立连接,不再强制要求提供公网回调地址。

对于本地部署的 OpenClaw 而言,只要当前机器能够正常访问外网,就可以直接完成接入,无需公网 IP,也不需要域名,更不用再配置内网穿透。

这次更新的核心变化是什么?

目前,企业微信为智能机器人提供了两种消息接收方式:

  • Webhook 短连接

  • WebSocket 长连接

两者最关键的区别主要体现在以下几个方面:

  • Webhook 需要配置一个可被公网访问的回调 URL;如果是认证企业,通常还涉及与企业相关的备案域名要求

  • WebSocket 长连接 不要求固定公网 IP

  • Webhook 模式下需要处理消息加解密

  • WebSocket 长连接 则无需处理这套 callback 加解密逻辑

对于 OpenClaw 用户来说,长连接模式显然更适合本地开发、局域网部署以及小团队内部使用。

为什么这对 OpenClaw 尤其重要?

OpenClaw 很适合用于搭建企业微信中的本地知识库助手、内部问答机器人、流程提醒机器人以及通知机器人。

但此前最让人头疼的,往往并不是业务逻辑,而是接入时的网络环境配置。

在长连接模式上线之后,整体链路被大幅简化:

  1. 在本地启动 OpenClaw

  2. 由 OpenClaw 主动连接企业微信的 WebSocket 地址

  3. 企业微信通过这条长连接将消息推送过来

  4. 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 或内网穿透问题卡住,那么这次更新基本意味着可以直接开始上手了。

声明:本站原创文章文字版权归本站所有,转载务必注明作者和出处;本站转载文章仅仅代表原作者观点,不代表本站立场,图文版权归原作者所有。如有侵权,请联系我们删除。
未经允许不得转载:OpenClaw 接入企微迎来重要升级:无需公网 IP 和域名,本地即可直连,附完整配置说明
#OpenClaw #企业微信 
收藏 1
新手入门小龙虾(OpenClaw)完整配置指南
腾讯QClaw内测开启,微信直连AI!附内测邀请链接
推荐阅读
  • HTML在Agent生态中崛起:为什么它正在取代PPT成为演示新标准
  • Skill开发完全规范指南
  • SGLang 团队把工程经验写进 Agent:3 个 Kernel PR 合并,B200 加速 2.75x
  • marketingskills:3.8 万 Star 的开源营销技能库,给 AI Agent 装上营销专家大脑
  • Hermes多代理协作完全指南:从零搭建你的第一个AI团队
评论 (0)
请登录后发表评论
分类精选
Multi-Agent(多智能体)实战:OpenClaw x 飞书机器人,为每个业务场景打造专属多Agent项目协作群
6976 4月前
微信 iLink Bot 协议深度拆解:开发者必备实战手册
5936 4月前
微信官方 ClawBot 插件多Agent如何绑定多个微信号?让全家人都用上了OpenClaw!
4908 3月前
即梦CLI:如何用OpenClaw搭建AI工作流实现24小时自动化生图、生视频创作
4618 3月前
OpenClaw 升级到 2026.3.24 后,微信 ClawBot 插件更新指南
4348 4月前
Star-Office-UI:用像素办公室实时可视化 OpenClaw(小龙虾)的工作状态
4014 4月前
腾讯系 WorkBuddy :一键部署 OpenClaw 并接入微信,扫码即用,体验丝滑
3738 4月前
OpenClaw 飞书多 Agent 实战:一只龙虾不够用?教你养一池子龙虾
3675 4月前
7 个高质量前端UI设计的 Skills(技能包),让 AI 编程生成高质量UI代码
3464 3月前
新手入门小龙虾(OpenClaw)完整配置指南
3339 4月前

文章目录

关注「苏米客」公众号

订阅推送更及时,手机查看更方便
分类排行
1 LangChain、AgentScope、Mem0 深度横评:谁才是 Agent 的真正记忆系统?
2 10 个 Claude Code Skill 帮你跑通一人公司创业链路
3 WorkBuddy 生图 Skill 怎么选?7个工具和 5大模型一次讲清
4 marketingskills:3.8 万 Star 的开源营销技能库,给 AI Agent 装上营销专家大脑
5 大模型解决智能问题,Harness解决交付问题
6 让AI自己写策略跑回测:基于Loop Engineering的量化开发范式
7 AI Agent 实战:从建站到数据分析,AI 如何从文本对话转向自主行动
8 herdr:专为多 Agent 协作设计的终端管理神器,1.3 万 Star 开源项目
9 Hermes Agent 接入 OpenViking 外部记忆库:长期经验沉淀与检索全指南
10 OpenClaw 会话管理详解:无限对话框架构、SessionKey 与上下文清理机制
©2015-2024 苏米客XMSUMI 版权所有 · WWW.XMSUMI.COM 闽ICP备14005900号-6
微信文章助手 程序库 免费影视APP 免费字体下载 产品经理导航 爱克硕儿 产品经理AI资讯 Axure元件库下载 申请友联