验证失败主因是企微后台与workbuddy端的回调url或token不一致：需逐字符核对webhook地址（含协议、路径、token参数）、双向同步纯ascii token、排查代理层篡改url、确认消息加密开关与encodingaeskey配置匹配。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在WorkBuddy中配置企业微信机器人后收到“验证失败”提示，则极可能源于回调URL或Token在企微后台与WorkBuddy端未严格一致。以下是解决此问题的步骤：
一、核对企微后台填写的URL是否与WorkBuddy生成的Webhook地址完全匹配
企业微信要求回调URL必须与WorkBuddy服务端实际暴露的地址逐字符一致，任何协议、端口、路径、查询参数的差异（包括末尾斜杠、空格、编码格式）都会导致签名校验失败。
1、在WorkBuddy客户端中进入「Claw设置」→「企微AIBot集成」→ 点击「配置」，复制显示的完整Webhook URL（形如https://workbuddy.codebuddy.cn/api/v1/qywx/webhook?token=abc123）。
2、登录企业微信管理后台，进入「应用管理」→「智能机器人」→ 找到对应机器人 → 点击「编辑」。
3、在「URL」输入框中，**粘贴第1步复制的完整URL**，不得手动修改、删减或添加任何字符，尤其不可遗漏?token=部分及后续全部参数。
4、确认URL以https://开头，且域名、路径、大小写、标点符号与WorkBuddy端显示内容完全一致；若使用HTTP或本地IP地址，将直接触发验证失败。
二、验证Token值是否双向同步且未被篡改
Token是企微用于校验请求来源合法性的密钥，必须在WorkBuddy配置页填入的值与企微后台“Token”字段填写的值完全相同，且不能含不可见字符。
1、在WorkBuddy「企微AIBot集成」配置页中，检查「Token」输入框内容是否为纯ASCII字符串，长度通常为16–32位字母数字组合。
2、返回企微后台机器人编辑页，在「Token」字段中**重新点击「随机获取」生成新Token**，并立即复制该值。
3、将新Token**完整粘贴至WorkBuddy配置页对应位置**，严禁通过截图识别、手动输入或从邮件/聊天记录中复制——这些方式极易引入全角空格、换行符或零宽字符。
4、保存WorkBuddy配置后，点击「测试连接」；若仍失败，需清空企微后台Token字段再重新粘贴一次，避免浏览器自动填充缓存旧值。
三、排查URL中token参数是否被代理或CDN劫持修改
若WorkBuddy部署在反向代理（如Nginx）、负载均衡器或CDN之后，中间层可能对URL进行重写、解码或过滤，导致传入企微的token值与原始生成值不一致。
1、在企微后台机器人配置页的「URL」字段中，临时将token参数替换为固定测试值（如?token=test123），保存并测试。
2、在WorkBuddy服务端日志中查看实际接收到的请求URL，比对query string中的token是否仍为test123。
3、若日志中token已变为其他值或丢失，说明代理层存在URL重写规则；需检查Nginx配置中是否有proxy_set_header、rewrite或sub_filter指令误操作。
4、确保代理配置中启用proxy_http_version 1.1并透传原始Host头，避免因Host变更引发签名计算偏差。
四、确认企微后台未启用消息加密且EncodingAESKey为空
当企微后台开启“消息加密”时，必须同时提供EncodingAESKey，否则校验流程会因缺失密钥而中断；若未启用加密却填入了AESKey，也会干扰基础签名验证逻辑。
1、在企微后台机器人编辑页，检查「消息加解密」开关状态：若为关闭，则EncodingAESKey字段必须留空，且WorkBuddy配置页中该字段也须清空。
2、若开关为开启，则需在WorkBuddy配置页中准确填入企微后台生成的43位EncodingAESKey（含大小写字母、数字及=号），并确认无前后空格。
3、对比企微后台「Token」与「EncodingAESKey」两个字段的复制操作是否独立完成——严禁将二者内容混淆粘贴至同一输入框。
4、修改任一密钥后，必须在企微后台点击「保存」并等待页面提示成功，否则更改不会生效。
