OpenClaw接入企业微信实战

为什么选 OpenClaw 接企业微信？

我们团队最近有个需求：希望在企业微信里直接跟 AI 对话，不是那种简单的“你好”“在的”，而是能真正干活的——查文档、整理表格、定时提醒、甚至操作文件系统。说实话，市面上能做到这些的工具不少，但大多数要么是高价的 SaaS 订阅，要么是封闭平台不支持自定义。

找了一圈之后，我确定了 OpenClaw。这东西是个开源的 AI Agent 平台，GitHub 上已经 25 万+ Star，最关键的是它支持自部署，数据全部在自己服务器上，隐私方面不用担心。而且它的企业微信接入是官方支持的——没错，企业微信团队自己写的插件。

整个接入过程其实只需要三步：创建机器人 → 装插件 → 填配置。完事。不需要公网 IP，不需要域名备案，WebSocket 长连接直接打通。这个体验说实话让我有点意外，比我之前接入其他平台顺畅太多了。

图 1：OpenClaw × 企业微信 架构总览

前置准备：你需要什么

开干之前，确认下面这几样东西都准备好了。缺任何一个都可能在中间卡住：

• ：你需要能在企业微信后台创建智能机器人，这个操作需要管理员身份。如果你不是管理员，找你们公司的 IT 同事开个权限就行。企业微信管理员权限

• ：本地电脑、云服务器都行。Node.js 18 以上版本，推荐 20 LTS。内存至少 2GB。如果只是试玩，本地 macOS 或 Windows 也没问题。一台能跑 Node.js 的服务器

• ：OpenClaw 本身不包含模型，它是一个“网关”，前端连接后端的大模型服务。所以你需要自己准备一个可用的 LLM API Key，无论是 OpenAI、DeepSeek、通义千问还是其他服务商，只要兼容 OpenAI 的 API 格式就行。一个 LLM API Key

💡 如果你是个人开发者想试试水，用自己的电脑就够了。但要是团队使用的话，建议部署到云服务器上，保证 7×24 在线。阿里云、腾讯云都有 OpenClaw 的一键部署模板，可以省去自己装环境的麻烦。

Step 1：企业微信创建智能机器人

打开企业微信客户端，进入「工作台」，找到「智能机器人」入口。如果你看不到这个入口，说明你的企业微信版本较老或者管理员没有开启这个功能，去后台检查一下。

点击「创建机器人」，选择「手动创建」。这里有两种模式可以选：「API 模式」和「简单模式」。我们选 API 模式，因为它支持更灵活的自定义逻辑。创建过程中会让你选接入方式，这里重点来了——

💡 一定要选「长连接方式（WebSocket）」，不要选「回调方式」。长连接的好处是不需要公网 IP、不需要配制域名，对个人开发者和小团队极其友好。回调方式需要你有一个可外部访问的服务器地址，配置起来麻烦得多。

创建完成后，系统会给你两个关键信息：Bot ID 和 Secret。记下来，后面配置用得到。Secret 相当于机器人的密钥，千万不要泄漏。

⚠️ 如果你的企业微信是「自建应用」版本，可能需要在后台先开启「智能机器人」的 API 接入权限。具体路径是：应用管理 → 智能机器人 → 开启 API 模式。

图 2：三步接入流程

Step 2：部署 OpenClaw 并安装企业微信插件

如果你还没有装过 OpenClaw，先装一下。官方推荐用 npx 直接跑，不用手动 clone 代码：

# 全局安装 OpenClaw（首次使用）

$ npm install -g openclaw

# 初始化配置

$ openclaw init

# 启动

$ openclaw start

启动成功后，浏览器打开 http://127.0.0.1:18789 就能看到 OpenClaw 的管理界面了。接下来装企业微信插件，这是企业微信团队官方维护的，不是第三方的东西：

# 安装企业微信官方插件

$ npx -y @wecom/wecom-openclaw-cli install

# 重启 OpenClaw 使插件生效

$ openclaw restart

装完之后重启一下，让插件加载进来。这时候你再打开管理界面，应该能在 Channels 列表里看到「WeCom」这个选项了。

图 3：终端安装过程示例

💡 Node.js 版本要求 18 以上，推荐 20 LTS。如果你本地有多个 Node 版本，用 nvm 切换到合适的版本再装。别问我怎么知道的，都是血的教训。

Step 3：配置并配对企业微信

这是最关键的一步。打开 OpenClaw 管理页面，进入 Channels 配置页，找到 WeCom 通道，你会看到几个需要填写的参数。核心就两个：Token 和 EncodingAESKey。这两个值可以在企业微信智能机器人的设置页面找到。

下面是参数说明：

表 1：WeCom 通道配置参数

填完以后点保存，OpenClaw 会自动尝试与企业微信建立 WebSocket 连接。如果配置正确，你会看到连接状态变成「已连接」。这时候去企业微信找你刚创建的机器人发个消息试试，它应该能正常回复了。

到这里，整个接入流程就完成了。你现在已经可以在企业微信里直接和 AI 对话了。是不是比想象中简单？

踩坑实录：我遇到过的那些问题

说实话，上面的步骤看起来顺理成章，但实际操作中我还是踩了几个坑。把这些经验写出来，希望能帮你省点时间。

坑 1：插件装完找不到 WeCom 通道

装完插件重启之后，打开管理页面的 Channels，发现列表里干干净净，根本没有 WeCom。当时以为是插件没装成功，重新装了三四次都一样。后来发现是因为我没有完全关停再重启，而是用了 `openclaw reload`。reload 只是重新加载配置，不会重新加载插件。必须用 `openclaw restart` 完全停掉再启动。

# 正确做法：完全重启

$ openclaw stop

$ openclaw start

坑 2：WebSocket 连接失败

填完配置点保存后，连接状态一直显示「连接中」，过了好一会儿变成「已断开」。这个问题排查了很久，最后发现是 Token 和 EncodingAESKey 填反了。我把机器人设置页的 Token 填到了 EncodingAESKey 的位置，反过来也一样。解决办法很简单：仔细对照两边的参数名称，一个一个填，不要凭感觉。

坑 3：消息收发有延迟

接好之后发现发消息给机器人，要等三四秒才能收到回复。以为是接入有问题，后来才发现是 LLM API 本身的响应速度就比较慢。如果你用的是海外的模型服务，网络延迟会叠加上去。换成国内的模型服务，比如 DeepSeek 或通义千问，延迟会明显降低。

坑 4：权限不足导致功能受限

机器人能回复消息了，但是说“没有权限访问文档”“无法读取日历”。这是因为企业微信的智能机器人默认只有基础消息权限，要访问文档、日历、通讯录等需要在后台单独授权。进入企业微信管理后台，找到「智能机器人」的「可用功能」设置，根据需要开启对应的权限就行。

进阶玩法：不只是聊天

接好企业微信只是第一步。OpenClaw 的真正实力在于它的技能体系——它可以调用各种工具来完成实际任务。下面分享几个我觉得比较实用的场景。

定时推送日报和提醒

OpenClaw 内置了 cron 功能，可以设置定时任务。比如每天早上 9 点自动拉取团队的 GitHub 提交记录，整理成日报推送到企业微信群里。或者设置会议提前 15 分钟的提醒，自动查询参会人的日程并发送提醒消息。配置很简单，在 SOUL.md 文件里加一段 cron 规则就行。

接入企业文档处理

如果你的企业微信开启了文档权限，机器人可以直接读取和处理企业文档。比如你可以让它帮你总结一份长文档的要点，或者把一张表格里的数据整理成结构化的报告。对于经常需要处理大量文档的同事来说，这个功能非常省事。

通过企业微信桥接个人微信

这个功能我觉得很巧妙。如果你的企业微信开启了「微信互通」功能（管理员在后台的「成员与联系人」里开启），那么企业微信里的机器人可以向个人微信发消息。也就是说，你可以在个人微信里直接跟 AI 对话，体验跟用普通机器人没什么区别，但背后是 OpenClaw 在提供服务。

💡 自定义技能开发也不复杂。OpenClaw 的技能本质上就是 Markdown 文件，写一个 .md 文件放到 skills 目录下就能被自动加载。如果你会写 Prompt，就能写技能。官方的技能市场也有很多别人分享的现成技能可以直接用。

写在最后

从开始接触 OpenClaw 到完成企业微信的接入，我花了大约半天时间，其中一半时间在踩坑，另一半在研究文档。如果把踩坑的时间去掉，其实流程本身真的只需要十几分钟。三步走完，全程无需公网 IP，这个体验确实不错。

当然，接入只是第一步。真正让 AI 变得有用，还需要根据你自己的业务场景去配置技能和提示词。这个没有捷径，需要不断试和调整。但至少基础设施已经搭好了，后面的事情就是细化和优化。

如果你在接入过程中也遇到了什么奇葩的问题，欢迎在评论区交流。另外想问问大家，你们用 OpenClaw 还接了哪些渠道？我现在同时接了 飞书 和 微信，体验都挺不错的。