aionclaw需通过企业微信开放平台回调机制接收消息,必须安装wecom插件、配置corpid/agentid/secret、设置https webhook url并启用可见范围,否则无法接收任何事件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想让AionClaw自动接收企业微信里的审批、打卡、群消息或自定义事件通知,不是靠“加好友”或“扫码进群”这种个人号逻辑,而是必须走企业微信开放平台的回调机制——消息得由企微服务器主动推给AionClaw监听的地址,否则它永远收不到。
确认AionClaw已启用企业微信通道
在AionClaw部署目录下执行:openclaw channels list,检查输出中是否包含 wecom 类型通道。若无,需先安装插件:openclaw plugins install @wecom/wecom-openclaw-plugin。
插件安装后必须重启服务:openclaw gateway restart,否则新通道不会加载。
获取并填写企微应用凭证
登录企业微信管理后台 → 进入「应用管理」→ 点击左侧「自建应用」→ 创建或选中一个已有应用(如“AI通知中心”)。
在该应用详情页中,复制以下三项值:【CorpID】(形如 wwxxxxxxxxxxxxxx)、【AgentId】(纯数字,如 1000005)、【Secret】(一长串字母数字组合,仅显示一次,务必立即复制)。
这三项是AionClaw调用企微API的身份钥匙,缺一不可;Secret一旦关闭页面即无法再次查看,只能重置——重置会导致旧配置全部失效。
配置AionClaw通道参数
执行命令:openclaw channels add → 在交互式菜单中选择 wecom → 依次填入上一步复制的 CorpID、AgentId、Secret。
Token 和 EncodingAESKey 可留空回车,AionClaw会自动生成;但生成后必须立即将 EncodingAESKey 复制到企微后台对应应用的「接收消息」设置中,否则所有回调消息解密失败,表现为“企微发了,AionClaw日志里完全没记录”。
填写完毕后,AionClaw会输出类似 Webhook URL: https://your-domain.com/api/wecom/callback 的地址——这就是企微必须推送消息的目标入口。
在企微后台绑定回调地址
第一步:确保你的AionClaw服务有公网可访问的HTTPS地址(开发阶段可用 ngrok http 3000 临时映射);HTTP地址会被企微直接拒绝。
第二步:回到企微应用「接收消息」配置页,将上一步得到的 Webhook URL 粘贴到「URL」栏;Token 和 EncodingAESKey 必须与AionClaw生成的一致,否则校验不通过。
第三步:点击「启用回调」→ 输入管理员手机验证码 → 提交。此时企微会向该URL发送一次验证请求,AionClaw控制台应打印 [wecom] callback verified 日志。
第四步:在「可见范围」中勾选你希望接收通知的成员或部门——【未勾选的成员产生的事件,企微根本不会触发回调】,这是90%用户收不到通知的根本原因。
测试通知是否可达
方法一:在企微应用详情页点击「测试」按钮,手动触发一条测试消息,观察AionClaw终端日志是否出现 received wecom event: text 或类似内容。
方法二:让已勾选的成员在企微中向该应用发送一条文本消息(例如“你好”),AionClaw应实时收到并可响应。
若无日志,优先检查:① 企微后台「接收消息」是否已启用;② 可见范围是否包含该成员;③ AionClaw进程是否运行且端口未被防火墙拦截;④ ngrok隧道是否仍有效(超时会断开)。











