需依次完成钉钉机器人创建、WorkBuddy推送配置、消息推送验证、钉钉指令反向触发及故障排查五步操作，确保Webhook地址、自定义关键词、签名密钥、系统权限与网络策略均正确配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装WorkBuddy并希望将其接入钉钉群，实现通过钉钉机器人远程触发任务或接收通知，则需完成钉钉端机器人配置与WorkBuddy端的对接。以下是具体操作方法：
一、在钉钉群中创建自定义机器人
该步骤用于获取钉钉侧的Webhook地址，这是WorkBuddy与钉钉通信的关键凭证。必须确保安全设置合理，防止未授权调用。
1、打开钉钉客户端，进入目标群聊会话。
2、点击右上角群设置图标，进入群管理界面。
3、选择「智能群助手」→「添加机器人」→「自定义机器人」。
4、填写机器人名称，上传头像（可选）。
5、在安全设置中，必须启用“自定义关键词”并输入至少一个关键词（如“WorkBuddy”），否则消息将被拦截。
6、勾选《自定义机器人服务及免责条款》，点击「完成」。
7、复制生成的Webhook地址，此地址仅显示一次，请立即保存。
二、在WorkBuddy中配置钉钉推送通道
该步骤用于将钉钉Webhook注入WorkBuddy系统，使其具备向指定群发送消息的能力。需在平台管理域中完成第三方推送配置。
1、启动WorkBuddy应用，使用腾讯账号登录。
2、进入主界面右上角「个人中心」→「Claw设置」→「第三方推送配置」。
3、在「钉钉」配置项下，点击「新增配置」。
4、输入钉钉群名称（用于识别，非群ID）。
5、粘贴此前复制的Webhook地址至「Wehhook地址」字段。
6、若使用自定义机器人，必须填写签名密钥（即安全设置中生成的密钥）；若为应用机器人则留空。
7、所属项目选择「全部项目」或按需限定范围。
8、点击「保存配置」，系统将自动测试连接状态。
三、验证钉钉消息推送功能
该步骤用于确认WorkBuddy已成功获得向钉钉群发送消息的权限，并确保格式与权限无误。
1、进入WorkBuddy主界面左侧导航栏「报告」模块。
2、选择任意一份已完成的报告或任务摘要。
3、点击「分享」→「推送」→「立即推送」。
4、推送方式选择「钉钉」，接收人选择已配置的钉钉群名称。
5、在推送信息框中输入测试内容，例如：【WorkBuddy测试】连接成功，当前时间：2026-03-12。
6、点击「发送」，观察钉钉群内是否收到对应消息。
7、若未收到，检查钉钉群安全设置中的关键词是否匹配，以及Webhook地址是否完整粘贴。
四、通过钉钉指令反向触发WorkBuddy任务
该步骤启用双向交互能力，允许在钉钉群中@机器人并发送指令，由WorkBuddy解析执行。需确保Claw协议兼容性已启用。
1、确保WorkBuddy版本不低于v1.3.0（官网下载页标注支持OpenClaw技能）。
2、在钉钉群中@刚创建的机器人，输入合法指令，例如：/summary 今日会议纪要。
3、WorkBuddy将自动捕获该消息，解析指令语义并调用本地能力。
4、执行结果将以富文本形式直接回复至同一钉钉群聊中。
5、若指令无响应，检查WorkBuddy后台日志中是否出现「Claw webhook receive timeout」错误提示。
五、故障排查：常见连接失败原因
当钉钉Webhook配置完成后仍无法收发消息时，应逐项核查以下基础环节，避免因权限或网络策略导致中断。
1、确认钉钉群为普通群或企业内部群，不支持临时群、保密群及部分教育版专属群。
2、检查WorkBuddy运行状态：任务栏图标常驻且无红色告警标识。
3、验证系统级权限：macOS需在「系统设置 → 隐私与安全性 → 完全磁盘访问」中勾选WorkBuddy；Windows需确认「辅助功能」已启用。
4、查看防火墙设置：确保 outbound 方向对钉钉Webhook域名（oapi.dingtalk.com）开放HTTPS（443端口）。
5、核对时间同步：设备系统时间与网络授时误差不得超过3分钟，否则签名验证失败。
