OpenClaw如何接入企业微信智能机器人【腾讯企业微信邮箱】【图文教程】
一、接入前期准备
在把 OpenClaw 接入到企业微信智能机器人之前,需要先做好设备端的基础环境配置,确保以下软硬件和应用版本符合要求:
-
企业微信客户端已经安装好,并且是最新版本;
-
本地设备已经安装好 OpenClaw,或者已经在腾讯云轻量应用服务器(或其他云服务商的服务器)上完成 OpenClaw 的部署;
-
确认操作终端能够正常执行命令行指令。如果是在本地部署,就用本地终端;如果是在云服务器上部署,就用对应服务器的终端。
-
风险提示:通过模型调用接口来操作企业微信内部应用,可能会因为模型幻觉等问题,带来数据泄露、越权访问等风险。建议先在测试企业中验证好后再谨慎使用。安装后即视为默认接受这些潜在风险。
二、标准接入流程
2.1 通过长连接方式创建智能机器人,获取 Bot ID 和 Secret
通过 API模式(长连接) 创建的智能机器人,支持被动回复多条消息,也支持主动给用户发消息。这是对接 OpenClaw 的专用创建方式,操作步骤如下:
-
打开企业微信客户端,进入 工作台 → 智能机器人,点击 创建机器人 → 手动创建。
-
进入创建页面后,选择 API模式创建(页面上会提示:“如需使用自有系统获取成员与机器人的聊天并输出回复,可切换至 API 模式创建”)。


3. 在 API 配置页面中,选择连接方式为 “使用长连接”(这种方式不需要域名或 IP 地址就能接收消息并返回结果,和 URL 回调方式不同)。
4. 配置完成后,页面上会自动生成并显示出 Bot ID 和 Secret。请务必妥善保存这两项信息(后续关联 OpenClaw 时会用到)。

5. 接下来需要补充配置机器人的“可见范围”(即哪些成员能看到并使用这个机器人),其他选项保持默认就行。API模式暂时不支持预览和调试,配置完成后直接保存即可。
说明:长连接方式是推荐用来对接 OpenClaw 的。如果你是在云服务商部署的 OpenClaw,也可以选择“URL 回调”方式来快速创建并对接机器人。
6. 通过长连接方式创建的智能机器人,支持接收和发送以下格式的消息:文字、图片、图文混排、音频、视频、文件。更详细的说明请参考接口文档。
消息类型格式说明如下:
|
消息类型 |
|
说明 |
|---|---|---|
| 模板卡片 |
|
|
| Markdown |
|
|
| 文件消息 |
|
|
| 图片消息 |
|
|
| 语音消息 |
|
|
| 视频消息 |
|
|
2.2 关联企业微信机器人与 OpenClaw
无论是在本地还是云服务器上部署的 OpenClaw,都需要通过终端命令来完成插件安装、渠道添加和信息配置。
2.2.1 在腾讯云 Lighthouse 中部署 OpenClaw 并关联机器人
-
使用腾讯云的轻量应用服务器(Lighthouse)。
-
进入轻量云控制台,找到已经部署好 OpenClaw 的轻量应用服务器,点击该服务器的实例卡片,进入“管理实例”页面,然后打开“应用管理”页。
3、在“模型(Models)”下需要添加模型
未添加模型对话中会有如下报错
4. 在通道列表中,选择 “企微机器人(长连接)”。
然后,按照页面提示,在对应的输入框里依次填入之前创建企业微信机器人时生成的 Bot ID 和 Secret。填写完毕后,点击界面上的 “添加并应用” 按钮,在弹出的确认框中点击 “确定”。稍等片刻,就可以在界面中看到已经配置好的企业微信机器人了。
5、输入后,点击添加并应用,并完成重启。
6、回到企业微信机器人创建页面,保存并创建。即可在企业微信中与智能机器人正常对话。
7、如配置完成后未能找到机器人,可在以下路径中找到:工作台->智能机器人->详情->去使用->发消息

2.2.2在本地终端部署OpenClaw并关联机器人
1、安装企微插件:打开本地终端,打开终端,依次执行如下命令
npx -y @wecom/wecom-openclaw-cli install
2、企微扫码接入:选择扫码接入,并使用企业微信扫描二维码
3、一键创建机器人:无需更多配置,只需点击一键创建机器人
4. 自动接入 OpenClaw:机器人创建成功后,无需手动配对,会自动接入本地的 OpenClaw。你可以点击「前往使用」,开始和“小龙虾”(即 OpenClaw 机器人)对话了。

三、附1:机器人通过 MCP 使用文档的使用指引
前提: 请先将你的企业微信 OpenClaw 插件升级到最新版本。如果还没有升级,可以在本地终端中输入以下命令:
bash
openclaw plugins update wecom-openclaw-plugin
3.1 功能介绍
3月13日更新的 5.0.7 版本,已经支持机器人通过 MCP 来创建文档和智能表格。
3.2 配置方式
3.2.1 配置方式1:通过对话授权,使用文档
-
你可以直接吩咐机器人操作文档,比如对它说:“帮我搜集这周零售行业的重要新闻,汇总成一篇企业微信文档”。机器人收到指令后,会自动发送一条授权链接,需要你点击链接并授权。

2、点击进入授权页面,点击“确认授权”,授权机器人文档使用权限。
3、授权成功,只需要告诉机器人“授权了”,就会自动对接MCP服务并生成文档。
3.2.2 配置方式2:手动授权前提:已经创建过API模式机器人,并完成OpenClaw接入。
1、入口:工作台->智能机器人->找到对应接入了OpenClaw的机器人,进入编辑页,点击可使用权限。
2、点击授权,并复制streamableHTTP URL或者JSON Config,两者任一即可(实测各模型对JSON Config的推理安装更稳定)。

3、将复制的配置,发送给机器人,即可完成安装。
3.2.3 典型配置案例
案例1:搜集本周零售行业重要新闻,汇总成一篇企业微信文档。



四、附2:智能表格 Webhook 使用指引
OpenClaw 可以通过 Webhook 快速接入企业微信智能表格,自动把数据写入或更新到表格中。智能表格在这里充当数据容器,适用于各种场景下的数据同步和可视化展示。详细的配置和接入方法,可以参考官方文档:《接收外部数据到智能表格》。
4.1 核心配置方式
-
在企业微信的智能表格中,打开 “接收外部数据” 功能,系统会自动生成一个该表格专属的 Webhook 地址。
-
使用标准的 HTTP POST 请求,把 OpenClaw 产生的数据发送到这个 Webhook 地址,就能实现智能表格中记录的 新增 或 更新。
4.2 典型适用场景

五、附3:企业微信 API 调用指引
如果你想通过 OpenClaw 进一步调用企业微信的各种应用 API(比如操作文档、审批、打卡等),需要先拿到企业微信的“企业 ID”和“应用 Secret”,然后完成 API 调用的授权。具体步骤如下:
5.1 获取企业 ID 与应用 Secret
-
获取企业 ID:登录企业微信的管理后台,进入 “我的企业” 页面,在页面下方会显示企业唯一的 企业 ID(corpid)。


5.2 API 调用流程
-
把你刚才拿到的“企业 ID”和“应用 Secret”发送给已经关联好 OpenClaw 的企业微信机器人。
-
向机器人发出指令:“获取 access token”,机器人会帮你拿到调用 API 所需的核心凭证。
-
用这个 access token 去调用企业微信的各种服务端 API,比如新建文档、发起审批、查询打卡数据等。
-
API 调用示例(以新建智能表格为例):
说明:企业微信各个功能模块的 API 具体怎么调用,请参考官方的「调用 API 文档」。

六、常见问题
1、OpenClaw 如何在本地终端部署安装?
目前企业微信官方没有提供 OpenClaw 的下载链接,需要你自己在本地设备上安装 OpenClaw,或者在腾讯云轻量应用服务器(或其他云服务商)的实例中完成 OpenClaw 的部署。
2、长连接接入和 URL 回调接入有什么区别?
长连接方式是推荐用来对接 OpenClaw 的。如果你是在云服务商上部署 OpenClaw,也可以选择“URL 回调”方式来快速创建并对接机器人。
注意:长连接方式不需要企业自己的域名和 IP 地址;而 URL 回调方式需要企业拥有可信的域名和 IP,或者备案主体与企业主体相同的域名(具体可参考“可信域名说明”)。
3、OpenClaw 接入企业微信智能机器人,必须由企业超级管理员操作吗?
不是。只要是企业管理员,或者拥有“创建智能机器人”权限的成员,都可以在智能机器人中接入 OpenClaw。
4、可以限制某些企业成员使用 OpenClaw 接入的机器人吗?
可以。管理员可以在后台配置“长连接方式”下该机器人的可用成员范围。操作路径如下:
【管理后台 → 安全与管理 → 管理工具 → 智能机器人 → 管理 → API模式管理 → 可配置】
「长连接」方式接入的成员
(1)默认权限设置
-
对于通讯录人数 超过 1000 人 的大型企业,这个设置项默认为空,也就是 企业内所有成员都暂时不能配置长连接方式的智能机器人。管理员可以后续自行调整权限。
-
对于通讯录人数 ≤ 1000 人 的中小企业,这个设置项的默认范围与 “机器人创建权限”的成员范围一致,也就是说:企业中那些有权限创建智能机器人的成员,都可以配置长连接方式的机器人。后续管理员也可以自行管理调整。
无权限的成员 在尝试用长连接方式接入时,页面上不会显示 Bot ID 和 Secret,同时会提示:“获取 Bot ID 和 Secret 需要联系管理员开通「长连接」权限”。
5、在本地终端部署 OpenClaw,需要先申请大模型的 Token 吗?
需要。
6、通过腾讯云 Lighthouse 部署 OpenClaw 并关联了机器人,但运行后智能机器人没有回复,是什么问题?
通过腾讯云 Lighthouse 部署 OpenClaw 时,使用的插件不是企业微信官方提供的。建议你联系 Lighthouse 团队的客服或技术支持寻求帮助。
7、OpenClaw 机器人能在外部群或客户群中使用吗?
目前配置 OpenClaw 接入的企业微信智能机器人,暂时不支持在外部群或客户群中使用。
8、接入 OpenClaw 后,企业微信会授予哪些接入权限?可以实现哪些功能?
目前已开放的 skills(技能插件)都可以安装使用。未来还会有更多官方插件上线,敬请期待。
9、OpenClaw 接入智能机器人后,能识别附件吗?
只有使用了“多模态模型”的 OpenClaw 接入方式,才支持识别附件内容。
10、为什么会收到“企业微信 OpenClaw 插件更新提醒”?
从 2026 年 3 月 20 日下午开始,针对全网近一个月内有过对话的长连接机器人,系统会向机器人的创建者推送一条“OpenClaw 企业微信官方插件已升级”的提醒。你可以在更新提醒中看到新版本的编号、新增能力以及更新指令,直接复制指令到终端执行即可完成更新。
后续,当同时满足以下条件时,系统会再次向机器人创建者推送一次插件已升级的提醒:
-
(1)OpenClaw 企业微信官方插件发布了新版本;
-
(2)该智能机器人采用的是“长连接”模式;
-
(3)用户进入了该机器人的会话界面。
夜雨聆风