1. 为什么我最后选了自建应用模式企业微信接入 AI 助手这件事我前后折腾过两轮。第一轮用的是机器人模式配置简单、流式打字机效果也好看但很快就撞墙了机器人模式只能被动回复没法主动推送消息发文件、发图片也受限。而我的实际需求是让 OpenClaw 在审批通过后主动推一条通知到群里还要能发 PDF 附件——这些机器人模式都做不到。于是转向自建应用模式。自建应用模式的核心优势就是主动发送能力你可以让 OpenClaw 在任意时刻调用企业微信 API把消息推给指定的人或部门消息格式支持文本、Markdown、图文、文件、图片回调走 XML 加密通道安全性也更高。代价是配置链路更长需要在企业微信后台创建自建应用、拿到 CorpID/AgentId/Secret 三组凭证、配置回调 URL 和 Token、设置可信 IP还要在 OpenClaw 侧装 wecom 插件、写 config 配置、重启网关。这篇教程就是把这整条链路一次跑通。我会给出可直接复制的config.toml骨架、TaoToken 统一 Key 的配置片段以及回调验证和消息收发联调的具体动作。适合已经用过 OpenClaw、想把它接进企业微信做业务集成的同学。版本上我实测通过的是 OpenClaw 2026.2.26 配合sunnoy/wecom1.5.0生产环境建议锁版本。2. 前置准备TaoToken 统一 Key 与凭证清单在动企业微信后台之前先把模型侧的 Key 准备好。OpenClaw 本身不绑定某一家模型服务它通过统一的 API 入口调用模型。我这边用的是 TaoToken 作为统一入口好处是一个 Key 就能覆盖对话、编码、Agent 几类场景不用在多个平台之间来回切换配置。TaoToken 的 API 地址是https://taotoken.net/api官网在https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。你需要先去控制台创建一个 API Key路径是 API Keys 管理页创建后复制保存后面写进 OpenClaw 配置里。企业微信侧需要提前收集的凭证有四组凭证获取位置用途CorpID我的企业 页面底部企业唯一标识AgentId应用详情页应用唯一标识纯数字Secret应用详情页点击查看应用调用凭证Token / EncodingAESKey接收消息 配置区回调签名与加解密这四组缺一不可而且 Token 和 EncodingAESKey 必须和 OpenClaw 配置里写的完全一致差一个字符回调验证就会失败。我建议先把它们记在一个临时文本里等配置全部写完再回后台点保存。3. 企业微信后台创建自建应用与回调配置登录企业微信管理后台进入「我的企业」页面拉到最底部找到「企业ID」复制备用。然后进「应用管理」「应用」点「创建应用」填应用名称比如 OpenClaw 智能助手、上传 logo、选择可见范围创建后进入应用详情页。在详情页记下 AgentId纯数字和 Secret点「查看」获取。接着找到「接收消息」区域点「设置 API 接收」弹出配置框URL 填https://your-domain.com/webhooks/app这里的/webhooks/app是 wecom 插件的默认接收路径域名必须是你自己公网可访问的 HTTPS 地址。Token 点「随机生成」复制保存EncodingAESKey 也点「随机生成」复制保存43 位字符。关键点先不要点保存。企业微信在你点保存的瞬间会向这个 URL 发一个验证请求如果此时 OpenClaw 服务还没起来验证必然失败。正确顺序是填好 URL/Token/AESKey → 先放着 → 去装插件、写配置、启动服务 → 再回来点保存。4. 安装 wecom 插件与编写 config.toml在终端执行插件安装openclaw plugins install sunnoy/wecom1.5.0安装成功后插件会落在~/.openclaw/extensions/目录下。生产环境建议锁定这个版本号因为 OpenClaw 迭代快插件不一定跟得上新版本。接下来编辑配置文件。OpenClaw 的配置入口是~/.openclaw/openclaw.json但如果你用的是较新的 config.toml 风格结构类似。下面是我实测可用的配置骨架把占位符替换成你自己的值# ~/.openclaw/config.toml [channels.wecom] enabled true [channels.wecom.agent] corpId 你的企业ID agentId 1000002 corpSecret 你的应用Secret token 回调Token encodingAesKey 回调EncodingAESKey # TaoToken 统一 Key 配置 [providers.taotoken] baseUrl https://taotoken.net/api apiKey 你的TaoToken API Key几个容易踩的坑agentId必须是数字类型不要加引号加了会报invalid typecorpSecret、token、encodingAesKey三个字符串要和后台完全一致baseUrl结尾不要多加斜杠。如果你更习惯用 Web UI可以访问http://127.0.0.1:18789/config点「Raw」进原始编辑模式粘贴保存。配置写完后还要去企业微信后台的「管理工具」「企业可信IP」里把你部署 OpenClaw 服务器的公网 IP 加进白名单。这一步不做后面发消息会一直没回复而且前端不给任何提示非常隐蔽。5. 重启服务与回调验证配置落盘后重启网关openclaw gateway restart openclaw gateway status确认状态是running且没有报错。这时候回到企业微信后台的 API 接收配置页点「保存」。如果一切正常页面会提示保存成功如果失败通常是服务没起来、端口不通或者 Token/AESKey 对不上。保存成功后用日志确认回调验证通过openclaw gateway logs | grep wecom日志里应该能看到回调 URL 验证通过的记录。到这一步企业微信和 OpenClaw 之间的加密通道就算打通了。6. 消息收发联调与常见报错排查联调动作很简单在企业微信里进入你刚创建的应用发一条「你好」观察 OpenClaw 是否回复。如果回复正常说明整条链路通了。下面是我踩过的几个典型报错和对应解法回调 URL 验证失败多半是服务未启动或端口不通先查openclaw gateway status再确认防火墙放行了 443 端口。提示「Token 不匹配」就是配置文件里的 token 和后台生成的不一致逐字符核对。配置无误但提问无回复九成是没配企业可信 IP 白名单去后台「管理工具」「企业可信IP」把服务器公网 IP 加进去保存后等几分钟生效。如果是动态 IP 或临时测试可以暂时填0.0.0.0/0但生产环境务必改回固定 IP。消息发送成功但无回复检查应用 Secret 是否正确、应用是否在可见范围内。接收不到消息回调回后台确认 API 接收状态是启用而非被禁用。还有一个隐蔽问题agentId写成字符串会直接报invalid type改成数字即可。另外如果你同时开了机器人模式和自建应用模式注意两者的回调路径和 Token 不要混用。7. 主动推送与后续接入建议自建应用模式跑通后最有价值的其实是主动推送能力。你可以在 OpenClaw 的 Agent 逻辑里调用企业微信的消息发送接口把审批结果、定时报表、告警通知推给指定成员或部门还能带文件附件。这部分的具体接口调用方式建议对照接入文档来写文档里对消息类型和参数有完整说明。模型侧如果后面要换更强的模型或者做长期编码任务可以在 TaoToken 控制台里管理 Key 和额度需要跑 Agent 长任务的话可以看看 Coding Plan 的配置方式。回调验证和接入过程中遇到签名、加解密的问题优先查接入文档里的签名算法说明比在日志里盲猜快得多。最后提醒一句生产环境把sunnoy/wecom1.5.0这个版本号锁死别用latest插件和 OpenClaw 主版本的兼容性窗口有时候很窄升级前先看插件发布说明。
