必须用企业微信管理员账号创建机器人，因普通成员无权配置URL回调地址及企业级开关，非管理员创建的机器人即使填入Webhook URL，企业微信后台也不会启用回调，导致WorkBuddy收不到指令。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 与企业微信机器人联动部署，核心在于打通「企微消息入口」和「本地执行环境」之间的可信通道。只要 Token 和 EncodingAESKey 填对、Webhook URL 回填准确、企业微信已认证，95% 的失败都出在权限或时序问题上——不是协议不支持，而是步骤跳过了关键校验。
为什么必须用企业微信管理员账号创建机器人
普通成员账号虽能创建机器人，但默认无权配置 API 模式下的 URL 回调地址，也无法开启「多端同步响应」等企业级开关。非管理员创建的机器人即使填入了 Webhook URL，企业微信后台也不会真正启用回调，导致 WorkBuddy 收不到任何指令。
- 管理员路径：浏览器访问
https://work.weixin.qq.com/→ 登录 → 【安全与管理】→【管理工具】→【智能机器人】→【添加机器人】→ 切换至 API 模式 - 普通成员路径：手机企微 App → 工作台 → 智能机器人 → 创建机器人 → 手动创建 → 再选 API 模式（仅支持长连接模式，不适用于标准 Claw 集成）
- 若企业未认证，【智能机器人】页面右上角不会显示“企业已认证”标识，此时无法生成 EncodingAESKey，必须先完成实名认证
Token 和 EncodingAESKey 填错的典型表现
这两个参数一旦错一位、多一个空格、或混淆大小写，WorkBuddy 就无法通过企微签名验证，所有消息都会被静默丢弃——你发指令，企微说“已发送”，WorkBuddy 却毫无反应，日志里也看不到任何接入记录。
-
Token是纯字母数字组合，长度固定为 16 位；EncodingAESKey是 43 位 Base64 字符串，末尾带 = 号，复制时务必包含 - 在 WorkBuddy 的「Claw设置」→「企微 AIBot 集成」中，两个字段必须严格按顺序粘贴，不能交换位置
- 填完后点击「注册」，若提示“鉴权失败”或长时间卡在“绑定中”，大概率是这两个值有误，建议重新进入企微后台点击「随机获取」再试
Webhook URL 必须回填到企业微信的哪个字段
这个 URL 是 WorkBuddy 动态生成的唯一接收地址，它只在「企微 AIBot 集成」页面点击「注册」后才出现，且每次注册都会刷新。很多人复制的是旧链接，或误填到「加解密密钥」栏，导致企微根本不知道该往哪发消息。
启用该技能，可以在WorkBuddy对话页的右边栏添加一个日历，提供月历视图、日程增删改查、分类标签（开庭/会议/截止日期/个人/研究/其他），支持从对话中提取事件并自动同步到日历。当用户提到"日历""日程""打开日历""添加日程""我的日程""calendar""安排"或询问已记录的日程信息时使用。
- 正确位置：企微机器人创建页 → 「API 模式创建」→ 下方「机器人接收消息URL」输入框（不是 Token 栏，也不是 EncodingAESKey 栏）
- 填完后必须点击「保存」，否则配置不生效；保存后页面会跳转，若没跳转说明保存失败，需检查网络或重试
- 该 URL 有效期为 24 小时，如长期未使用或重启 WorkBuddy，需重新注册并更新
授权失败后 WorkBuddy 界面没反应？先看系统权限弹窗
首次启动或重装后，WorkBuddy 会尝试申请桌面控制、辅助功能、文件读写等系统级权限。如果 macOS 用户没在「系统设置 → 隐私与安全性」里手动允许，或者 Windows 用户忽略了 SmartScreen 提示，Claw 通道根本无法初始化，后续所有集成都会卡在“未连接”状态。
- macOS：打开「系统设置」→「隐私与安全性」→ 滑到底部点「完全磁盘访问权限」→ 点「+」添加
WorkBuddy.app - Windows：右键开始菜单中的 WorkBuddy →「以管理员身份运行」，首次启动时遇到 SmartScreen 弹窗，点「更多信息」→「仍要运行」
- 授权完成后，WorkBuddy 右上角头像旁应显示绿色「已连接」，而非灰色「未连接」或「等待授权」
最易被忽略的一点：企业微信通讯录里出现的 WorkBuddy-您的姓名 机器人，只是身份标识，不代表指令通路已就绪。真正决定能否执行任务的，是本地 WorkBuddy 是否完成 Claw 初始化、是否通过企微签名验证、以及是否获得了操作系统授予的必要权限——三者缺一不可。
