若WorkBuddy与企业微信对接身份验证失败，主因是CorpID或Secret填写错误、格式不符或权限未开通；需依次核对后台凭证准确性、WorkBuddy中严格填写并启用集成、开通并审批API权限，或改用Webhook替代方案。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在配置WorkBuddy与企业微信对接时无法完成身份验证，则很可能是由于CorpID或应用Secret填写错误、格式不匹配或权限未开通所致。以下是解决此问题的具体操作路径：
一、确认企业微信端基础信息获取准确性
CorpID与应用Secret是企业微信后台颁发的唯一身份凭证，必须从官方管理后台精确复制，不可手动输入或转录，避免空格、换行、全角字符等隐性错误。
1、使用企业微信管理员账号登录企业微信管理后台。
2、点击左侧菜单【我的企业】→【企业信息】，在页面中找到并完整复制“企业ID”（即CorpID），注意该字段为纯英文与数字组合，不含下划线或连字符。
3、进入【应用管理】→【自建应用】，选择已创建或新建一个用于WorkBuddy集成的应用。
4、在应用详情页中，点击【修改应用】→【应用凭证】，展开后复制“应用Secret”值（32位十六进制字符串），该值仅首次可见，刷新后不可再查。
二、在WorkBuddy后台填写CorpID与Secret进行绑定
WorkBuddy需将获取到的CorpID与Secret用于调用企业微信API接口，完成身份鉴权与消息收发通道建立；若填写位置错误或未启用对应权限，将导致握手失败。
1、启动已登录CodeBuddy账号的WorkBuddy客户端（v4.6.4及以上版本）。
2、点击左下角头像 → 进入【Claw设置】→【企微AIBot集成】→【配置】。
3、在表单中严格按顺序填入“CorpID”与“应用Secret”字段，确保大小写、字符长度与后台完全一致。
4、勾选【启用企业微信集成】开关，点击【保存并测试连接】。
5、观察状态栏提示：若显示“连接成功”且图标变为绿色在线状态，表示凭证校验通过；若提示“无效凭证”或“签名错误”，请立即返回第一步重新核对。
三、验证应用权限与API调用范围
即使CorpID与Secret正确，若企业微信后台未授予对应API权限，WorkBuddy仍无法读取消息或发送响应。需确保该自建应用已开通必要接口权限。
1、回到企业微信管理后台【应用管理】→【自建应用】→ 找到对应应用 → 点击【设置】→【功能设置】。
2、在【API权限】区域，点击【添加权限】，依次勾选以下接口：接收消息/事件、发送消息、获取成员信息、获取部门列表。
3、点击【保存】后，系统将提示“需管理员二次确认”，此时由企业微信超级管理员进入【安全与管理】→【API权限管理】→ 审批该申请。
4、审批通过后，返回WorkBuddy配置页重新点击【测试连接】，等待状态更新为在线。
四、使用Webhook替代方案（免Secret模式）
当无法获取应用Secret（如无管理员权限）或希望规避密钥泄露风险时，可改用Webhook方式对接，该方式仅依赖机器人Webhook地址，无需CorpID与Secret参与鉴权。
1、在企业微信管理后台【安全与管理】→【管理工具】→【智能机器人】→【创建机器人】。
2、填写机器人名称与可见范围，切换至“API模式” → 选择“使用URL回调”。
3、点击【随机获取】生成Token与EncodingAESKey，务必完整保存这两项值，后续在WorkBuddy端配置时必需。
4、打开WorkBuddy【Claw设置】→【企微AIBot集成】→【配置】，粘贴Token与EncodingAESKey，点击【注册】获取Webhook URL。
5、将生成的Webhook URL完整粘贴回企业微信机器人创建页的“URL”字段中，点击保存，完成双向绑定。
