🦞 我不是肥妞,我只是OpenClaw 企业微信插件安装保姆级教程

2026-02-08 21:18:31 1点赞 8收藏 0评论

💡 本文由Openclaw基于项目【https://github.com/BytePioneer-AI/openclaw-china】撰写,并人工微调配图。

OpenClawOpenClaw

OpenClaw

最近把 OpenClaw 和企业微信打通了,发现这个组合简直太香了!不仅能自动回复消息,还能让 AI 陪聊,简直是职场摸(效)鱼(率)神器。今天就来分享下怎么把企业微信插件装起来,顺便聊聊这项目的一些其他玩法。

一、安装方式随心选

方式一:一键安装(推荐)

最简单粗暴的方式:

openclaw plugins install @openclaw-china/wecom-app

是不是超简单?npm 包管理器帮你搞定一切,就像点外卖一样方便。

方式二:手动部署(极客专属)

如果你想自己折腾,也可以手动复制插件文件:

# 把插件复制到 OpenClaw 的扩展目录 cp -r /path/to/wecom-app ~/.openclaw/extensions/

两种方式效果一样,看你喜欢哪种风格。

二、企业微信后台配置

创建自建应用

打开企业微信管理后台,找到「应用管理」→「自建」,点击「创建应用」:

企业微信企业微信

企业微信

  1. 1. 应用名称随便起个好记的名字

  2. 2. 上传个酷炫的图标(可选)

  3. 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. 1. 回调验证失败:检查 URL、Token、EncodingAESKey 是否正确,确认服务器防火墙设置

  2. 2. 不能发消息:检查 CorpId、CorpSecret、AgentId 是否准确

  3. 3. 插件没反应:确认配置文件格式正确,重启后查看日志

  4. 4. 收不到回复:大概率是没有配置企业可信IP,在应用详情页配置你的机器公网API

其他平台介绍

这个项目不只是企业微信,还有:

  • 钉钉机器人:适合钉钉重度用户

  • QQ机器人:年轻人的最爱

  • 飞书机器人:互联网公司的首选

  • 企业微信智能机器人:轻量级选择

每个都有自己的特点,可以根据自己的需要选择。

结语

企业微信插件装起来其实挺简单的,关键是企业微信后台的配置要仔细一点。装好了之后,AI 就能陪你聊个不停,工作效率蹭蹭往上涨。

玩腻了企业微信,还可以试试其他平台,一套代码多种体验,这才是开源的魅力所在。

有问题随时来问,祝你玩得开心!

宝子们,如果你觉得这篇文章有用,记得给我点个赞,分享给更多小伙伴哦!下期想看什么,评论区告诉我!💖

高等精灵实验室高等精灵实验室

高等精灵实验室

作者提示含AI生成内容。作者声明本文无利益相关,欢迎值友理性交流,和谐讨论~

展开 收起
0评论

当前文章无评论,是时候发表评论了
提示信息

取消
确认
评论举报

相关文章推荐

更多精彩文章
更多精彩文章
最新文章 热门文章
8
扫一下,分享更方便,购买更轻松