webhook是当前唯一稳定可用的workbuddy向企业微信推送消息方式，长连接仅限腾讯内部账号；需在workbuddy中正确填写token和encodingaeskey以生成有效webhook url，并通过claw指令触发推送。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 向企业微信推送消息，本质是走「Webhook 回调」或「WebSocket 长连接」两条通路，但当前稳定可用、无需额外开发的只有 Webhook 方式。长连接虽在文档中被提及为“优先推荐”，但截至 2026 年 4 月，其实际支持仍限于腾讯内部账号，外部企业用户配置后大概率收不到回调事件——这不是你配错了，而是接口尚未全量开放。
为什么 Webhook 是目前唯一靠谱的选择
企业微信官方明确将 Webhook 定义为「群机器人」的标准接入方式，而 WorkBuddy 的 企微 AI Bot 集成 模块正是基于该协议封装的。它不依赖后台服务、不穿透防火墙、不需域名备案，只要 Webhook URL 能被企微服务器访问（本地运行时需确保 WorkBuddy 客户端常驻），就能稳定接收并响应指令。
- Webhook 地址由 WorkBuddy 动态生成，含一次性签名，每次注册都会刷新
- 企业微信只向该地址 POST JSON 消息，WorkBuddy 内部自动完成加解密与路由
- 若你误用「消息推送」模块（即群聊右上角设置里添加的机器人）生成的 Webhook，会失败——那个地址只接受固定格式的文本/卡片，不支持 Claw 协议指令解析
Token 和 EncodingAESKey 必须手动填对
很多用户卡在“测试连接失败”，根本原因是把企业微信管理后台创建机器人时生成的 Token 和 EncodingAESKey 拷错位置：它们不是填在企微后台的 URL 字段里，而是必须原样输入到 WorkBuddy 的 Claw 设置 → 企微 AI Bot 集成 → 配置 对话框中。填完点「注册」，WorkBuddy 才会生成真正有效的 Webhook URL。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
-
Token是明文字符串，长度通常为 16 位字母数字组合 -
EncodingAESKey是 43 位 Base64 字符串，末尾带 = 号，复制时务必包含 - 填错任意一个，WorkBuddy 无法解密企微发来的加密消息，状态永远卡在「连接中」
推送内容必须走 Claw 指令触发，不能直接调 API
WorkBuddy 不提供对外暴露的 REST API 接口供你 curl 推送。所有消息下发都必须通过内置的 Claw 任务链驱动：要么写定时任务（如「每天 8:00 发晨会摘要」），要么在企微聊天窗口 @ 机器人发自然语言指令（如「把桌面上 report.xlsx 转成 PDF 并发到财务群」）。WorkBuddy 收到指令后，在本地执行、生成结构化消息，再通过已注册的 Webhook 地址反向推回企微。
- 直接向 Webhook URL POST 原始 JSON 会失败——它只认 Claw 协议封装的消息体
- 想用脚本触发？只能走混合模式：先用 Python 爬完新闻，再用
curl -X POST http://localhost:5000/claw/trigger（假设本地启用了 Claw HTTP 网关）调用预设任务 - 推送目标不能是个人，只能是群聊或客服号；发给单聊需走「微信客服号集成」通道，和企微 Webhook 无关
最易忽略的一点：Webhook 回调地址的有效期是动态绑定的，重启 WorkBuddy 或切换网络后，旧地址立即失效。别存着备用，每次重连都要重新注册、重新粘贴。
