文章总结： 本文是OpenClaw企业微信插件的详细安装配置教程，涵盖一键安装与手动部署两种方式，详细说明企业微信后台创建自建应用、配置回调接口流程，以及openclaw.json配置文件编辑方法。重点介绍多账户配置、环境变量高级用法，并针对家庭局域网部署场景提供VPS代理方案解决企业可信IP限制问题。最后给出AI对话功能配置、策略设置选项及常见故障排查建议，帮助用户实现AI自动回复与陪聊功能。 综合评分： 72 文章分类： 安全工具,AI安全,解决方案,应用安全
我不是肥妞，我只是一份OpenClaw 企业微信插件安装与配置保姆级教程
原创
诺多 诺多
高等精灵实验室
2026年2月7日 08:30 江苏
🦞 赛博龙虾，无敌美味～
💡本文由Openclaw基于项目【openclaw-china】撰写，并人工微调配图。
OpenClaw
最近把 OpenClaw 和企业微信打通了，发现这个组合简直太香了！不仅能自动回复消息，还能让 AI 陪聊，简直是职场摸（效）鱼（率）神器。今天就来分享下怎么把企业微信插件装起来，顺便聊聊这项目的一些其他玩法。
一、安装方式随心选
方式一：一键安装（推荐）
最简单粗暴的方式：
openclaw plugins install @openclaw-china/wecom-app
是不是超简单？npm 包管理器帮你搞定一切，就像点外卖一样方便。
方式二：手动部署（极客专属）
如果你想自己折腾，也可以手动复制插件文件：
# 把插件复制到 OpenClaw 的扩展目录
cp -r /path/to/wecom-app ~/.openclaw/extensions/
两种方式效果一样，看你喜欢哪种风格。
二、企业微信后台配置
创建自建应用
打开企业微信管理后台，找到「应用管理」→「自建」，点击「创建应用」：
企业微信
- 1. 应用名称随便起个好记的名字
- 2. 上传个酷炫的图标（可选）
- 3. 记住生成的 AgentId，后面要用
创建完应用后，点击进入应用详情页，你会看到：
- • AgentId（应用ID）：记下来
- • Secret（应用凭证）：点「明文」按钮显示，记下来
企业微信
配置回调接口
重点来了！在应用详情页找到「接收消息」，点击「设置API接收」填入以下信息：
企业微信
- • 回调 URL：
https://your-domain.com/wecom-app（换成你的openclaw域名/ip+端口） - • Token：自己设个密码，比如 “my-wecom-token”
- • EncodingAESKey：点「随机生成」
企业微信
记住这三个东西：Token、EncodingAESKey 和 CorpId（在「我的企业」里找），待会儿要用。
企业微信
三、OpenClaw 配置实战
编辑 openclaw.json 配置文件：
{
"channels": {
"wecom-app": {
"enabled": true,
"corpId": "你的CorpId",
"corpSecret": "你的应用Secret",
"agentId": 你的AgentId,
"token": "你的Token",
"encodingAESKey": "你的EncodingAESKey",
"dmPolicy": "pairing",
"groupPolicy": "open"
}
}
}
或者，直接在终端中执行：
openclaw config set channels.wecom-app.enabled true
openclaw config set channels.wecom-app.webhookPath /wecom-app
openclaw config set channels.wecom-app.token 你的Token
openclaw config set channels.wecom-app.encodingAESKey 你的EncodingAESKey
openclaw config set channels.wecom-app.corpId 你的CorpId
openclaw config set channels.wecom-app.corpSecret 你的应用Secret
openclaw config set channels.wecom-app.agentId 你的AgentId
配置项解读：
- •
enabled: true 表示开启插件 - •
corpId: 企业ID，企业微信后台找 - •
corpSecret: 应用凭证，应用详情页找 - •
agentId: 应用ID，应用详情页找 - •
token: 回调设置里的 Token - •
encodingAESKey: 回调设置里的 EncodingAESKey - •
dmPolicy: 私聊策略，pairing 表示需要配对才能聊天 - •
groupPolicy: 群聊策略，open 表示群聊消息都能收到
四、多账户玩法
如果你有多个企业微信应用，可以这样配置：
{
"channels": {
"wecom-app": {
"defaultAccount": "main",
"accounts": {
"main": {
"name": "主应用",
"corpId": "主应用CorpId",
"corpSecret": "主应用Secret",
"agentId": 主agentId,
"token": "主应用Token",
"encodingAESKey": "主应用EncodingAESKey"
},
"backup": {
"name": "备用应用",
"corpId": "备用应用CorpId",
"corpSecret": "备用应用Secret",
"agentId": 备用agentId,
"token": "备用应用Token",
"encodingAESKey": "备用应用EncodingAESKey"
}
}
}
}
}
五、环境变量配置（高级玩法）
不想把敏感信息写在配置文件里？可以用环境变量：
export WECOM_APP_CORP_ID="你的CorpId"
export WECOM_APP_CORP_SECRET="你的Secret"
export WECOM_APP_AGENT_ID="你的AgentId"
export WECOM_APP_TOKEN="你的Token"
export WECOM_APP_ENCODING_AES_KEY="你的EncodingAESKey"
环境变量优先级更高，相当于配置文件的加强版。
六、启动和验证
配置搞定后，重启 OpenClaw：
openclaw gateway restart
看看日志有没有报错，如果有问题就对着错误信息排查。
在企业微信后台测试回调，如果显示成功，那就 OK 了！
八、玩法升级
AI 对话
配置完成后，直接在企业微信里给应用发消息，AI 会自动回复。你甚至可以让 AI 扮演各种角色，比如客服、秘书或者段子手。
企业微信
策略配置
-
•
dmPolicy可选值： -
•
open: 任何人私聊都能回复 -
•
pairing: 需要先配对 -
•
allowlist: 白名单模式 -
•
disabled: 禁用私聊 -
•
groupPolicy可选值： -
•
open: 所有群聊消息都处理 -
•
allowlist: 只处理白名单群 -
•
disabled: 禁用群聊
九、避坑必看
如果你是在家庭局域网部署的Openclaw，以上操作完成后，还不能愉快玩耍。因为插件回复消息给企微客户端，是通过调用企微的API发送消息的，但是插件里企微API的地址是写死的（https://qyapi.weixin.qq.com)。 然而，企微要求调用官方的API的机器IP必须提前在加入企业可信IP才行，so，你懂的～
针对这个情况，建议使用VPS搭建企微API代理，在VPS上用Nginx、Lucky、Docker等方式建立转发代理即可，搜一搜教程一大把，然后把VPS的IP填写到企业可信IP即可。
企业微信
然后，还需要操作操作一下，把插件代码里的企微API地址替换成你的VPS代理域名或IP即可，例如：
# 到插件目录，请按你自己实际的路径写
cd ~/.openclaw/extensions/wecom-app/dist
# 替换地址
sed -i '' 's/https:\/\/qyapi.weixin.qq.com/https:\/\/你的VPS域名或IP+端口/g' index.js
最后，建议重启一下openclaw
openclaw gateway restart
十、故障排除小贴士
常见问题：
- 1. 回调验证失败：检查 URL、Token、EncodingAESKey 是否正确，确认服务器防火墙设置
- 2. 不能发消息：检查 CorpId、CorpSecret、AgentId 是否准确
- 3. 插件没反应：确认配置文件格式正确，重启后查看日志
- 4. 收不到回复：大概率是没有配置企业可信IP，在应用详情页配置你的机器公网API
其他平台介绍
这个项目不只是企业微信，还有：
- • 钉钉机器人：适合钉钉重度用户
- • QQ机器人：年轻人的最爱
- • 飞书机器人：互联网公司的首选
- • 企业微信智能机器人：轻量级选择
每个都有自己的特点，可以根据自己的需要选择。
结语
企业微信插件装起来其实挺简单的，关键是企业微信后台的配置要仔细一点。装好了之后，AI 就能陪你聊个不停，工作效率蹭蹭往上涨。
玩腻了企业微信，还可以试试其他平台，一套代码多种体验，这才是开源的魅力所在。
有问题随时来问，祝你玩得开心！
宝子们，如果你觉得这篇文章有用，记得给我点个赞，分享给更多小伙伴哦！下期想看什么，评论区告诉我！💖
高等精灵实验室
免责声明：
本文所载程序、技术方法仅面向合法合规的安全研究与教学场景，旨在提升网络安全防护能力，具有明确的技术研究属性。
任何单位或个人未经授权，将本文内容用于攻击、破坏等非法用途的，由此引发的全部法律责任、民事赔偿及连带责任，均由行为人独立承担，本站不承担任何连带责任。
本站内容均为技术交流与知识分享目的发布，若存在版权侵权或其他异议，请通过邮件联系处理，具体联系方式可点击页面上方的联系我。
本文转载自：高等精灵实验室 诺多 诺多《我不是肥妞，我只是一份OpenClaw 企业微信插件安装与配置保姆级教程》
版权声明
本站仅做备份收录，仅供研究与教学参考之用。
读者将信息用于其他用途的，全部法律及连带责任由读者自行承担，本站不承担任何责任。
评论