💡 本文由Openclaw基于项目【https://github.com/BytePioneer-AI/openclaw-china】撰写，并人工微调配图。
最近把 OpenClaw 和企业微信打通了，发现这个组合简直太香了！不仅能自动回复消息，还能让 AI 陪聊，简直是职场摸（效）鱼（率）神器。今天就来分享下怎么把企业微信插件装起来，顺便聊聊这项目的一些其他玩法。
一、安装方式随心选
方式一：一键安装（推荐）
最简单粗暴的方式：
openclaw plugins install @openclaw-china/wecom-app
是不是超简单？npm 包管理器帮你搞定一切，就像点外卖一样方便。
方式二：手动部署（极客专属）
如果你想自己折腾，也可以手动复制插件文件：
# 把插件复制到 OpenClaw 的扩展目录
cp -r /path/to/wecom-app ~/.openclaw/extensions/
两种方式效果一样，看你喜欢哪种风格。
二、企业微信后台配置
创建自建应用
打开企业微信管理后台，找到「应用管理」→「自建」，点击「创建应用」：
- 应用名称随便起个好记的名字
- 上传个酷炫的图标（可选）
- 记住生成的 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: 回调设置里的 TokenencodingAESKey: 回调设置里的 EncodingAESKeydmPolicy: 私聊策略，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
十、故障排除小贴士
常见问题：
- 回调验证失败：检查 URL、Token、EncodingAESKey 是否正确，确认服务器防火墙设置
- 不能发消息：检查 CorpId、CorpSecret、AgentId 是否准确
- 插件没反应：确认配置文件格式正确，重启后查看日志
- 收不到回复：大概率是没有配置企业可信IP，在应用详情页配置你的机器公网API
其他平台介绍
这个项目不只是企业微信，还有：
- 钉钉机器人：适合钉钉重度用户
- QQ机器人：年轻人的最爱
- 飞书机器人：互联网公司的首选
- 企业微信智能机器人：轻量级选择
每个都有自己的特点，可以根据自己的需要选择。
结语
企业微信插件装起来其实挺简单的，关键是企业微信后台的配置要仔细一点。装好了之后，AI 就能陪你聊个不停，工作效率蹭蹭往上涨。
玩腻了企业微信，还可以试试其他平台，一套代码多种体验，这才是开源的魅力所在。
有问题随时来问，祝你玩得开心！
宝子们，如果你觉得这篇文章有用，记得给我点个赞，分享给更多小伙伴哦！下期想看什么，评论区告诉我！💖
原创文章，作者：诺多，如若转载，请注明出处：https://www.huluohu.com/posts/2051/
微信扫一扫 
支付宝扫一扫 
