很多小伙伴在内网环境中搭建了功能强大的 OpenClaw,想要用它来自动化处理企业微信的业务——比如自动创建一个智能表格、自动写入会议纪要、或者批量生成文档。

但在实际操作中,大家都会撞上一堵墙:企业微信要求调用文档 API 的请求必须来自合法的“企业内部应用”,而内部应用往往需要一个公网可访问的回调地址来完成身份验证和配置。

没有公网 IP?不想折腾复杂的防火墙映射?使ZeroNews 轻松打通这条链路。

为什么你需要这个组合?

  1. OpenClaw: 强大的自动化/AI 集成能力,但通常部署在内网环境中,无法直接被企业微信后台“握手”。
  2. 企业微信 API 限制: 创建文档、读写智能表格等高级功能,必须通过“自建应用”的身份进行,且需要验证 URL 有效性。
  3. ZeroNews (wecom-pxy):解决了企业微信回调地址的校验问题,让内网服务瞬间具备接收企微验证信号的能力。

第一步:内网安装Openclaw接入企业微信
第二步在企业微信后台创建自建应用

登录企业微信管理后台,在“应用管理”中创建一个自建应用。你需要记录下:

  • AgentId
  • Secret
  • 企业 ID (corpid)

具体如何在企业微信上创建应用,可以继续参考企业微信的文档:

企微创建应用文档

步:安装配置 ZeroNews 回调地址

这是最关键的一步。参考 ZeroNews官方安装文档,通过其提供的代理服务,你可以获得一个公网域名。

  • 原理: ZeroNews 会帮你自动响应企微的 GET 请求校验。
  • 注意:如果创建的应用,需要调用企业微信的API或OAuth2.0,则企业需要准备可信的回调域名,此处的可信域名是指,域名的所属权,跟当前企业微信认证主体一致,或是关联体。
  • 配置域名映射此步骤,需要登录ZeroNews 控制台,按要求完成域名的cname映射,详细实操文档为:ZeroNews(零讯)自有域名 文档

  • 配置可信域名 回到企业微信管理后台ZeroNews 生成的公网 URL 填写到企业微信自建应用的开发者接口-网页授权JS-SDK按照企业微信要求完成域名验证

域名验证通过此时就可以使用OpenClaw调用企业文档API
步:配置OpenClaw 调用文档 API

当回调链路打通后,你的 OpenClaw 就可以通过 ZeroNews 提供的稳定通道,此时你需要企业ID应用ID信息通过会话窗口发送OpenClaw便获得Access token应用凭证(Access Token)去调用企微 API 了。

  • 创建文档: 发送 POST 请求至企微接口,OpenClaw 即可调用企微文档API创建文档智能表格
请求地址: https://qyapi.weixin.qq.com/cgi-bin/wedoc/create_doc?access_token=ACCESS_TOKEN

请求包体

{
	"spaceid": "SPACEID",
	"fatherid": "FATHERID",
	"doc_type": 3,
	"doc_name": "DOC_NAME",
	"admin_users": ["USERID1", "USERID2", "USERID3"]

  • 读写智能表格: 实现内网数据库与企微智能表格的实时同步。

场景演示:自动化办公的新姿势

情景: 每天下午 5 点,内网 OpenClaw 自动汇总当天的系统运行数据。

动作: 通过 ZeroNews 代理,OpenClaw 成功调用企微文档 API,在指定的群聊文件夹中创建一份《运营日报.docx》,并自动将数据写入其中。

结果: 无需人工干预,老板在手机端就能直接查看由内网 AI 总结出的最新报表。

总结

利用 OpenClaw + ZeroNews 这一组合,我们解决了“内网无法被企微识别”的硬件局限。让企业微信的安全机制与内网的高效工具实现了完美无缝的对接。

如果你也正受困于“回调地址验证失败”,不妨试试这个方案!

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐