需完成钉钉机器人创建、API权限开通、WorkBuddy凭证配置、群内添加机器人及双向通信验证五步：一、在钉钉开放平台创建企业内部应用并绑定自定义机器人，启用HTTP回调并记录Webhook；二、在应用权限管理中添加Card.Streaming.Write、Card.Instance.Write、qyapi_robot_sendmsg三项API权限并发布；三、在WorkBuddy客户端Claw设置中填入应用的Client ID、Client Secret及Webhook URL；四、在目标钉钉群中通过“智能助手”添加该机器人并授权消息收发；五、通过@机器人发送/hel或“你好”测试，确认WorkBuddy弹出通知、执行日志正常且钉钉群收到卡片响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您希望在手机端通过钉钉远程操控电脑上的WorkBuddy执行任务，但发现无法成功连接或消息无响应，则可能是由于钉钉机器人配置未完成、权限缺失或Webhook地址未正确同步。以下是实现WorkBuddy与钉钉平台对接的具体设置方式：
一、创建并配置钉钉机器人
该步骤旨在为WorkBuddy获取一个具备消息收发能力的钉钉身份入口，需在钉钉开放平台中完成应用注册与机器人绑定。机器人必须启用HTTP回调模式，才能与WorkBuddy的Claw远程控制模块通信。
1、登录钉钉开放平台，使用企业管理员账号进入“应用开发” → “企业内部集成” → “创建应用”。
2、填写应用名称（如“WorkBuddy-Claw”）和描述，点击创建。
3、在应用详情页左侧菜单选择“机器人”，点击“添加机器人”，选择“自定义机器人”类型。
4、勾选“启用机器人”，并开启“消息接收”权限，确保“安全设置”中加签方式为空或按需配置，但务必记录下生成的Webhook地址。
二、开通必要API权限
WorkBuddy需调用钉钉特定接口实现卡片消息发送、流式响应及消息回传，若权限未开放，将导致指令无法解析或结果无法返回。所有权限必须在应用“权限管理”中显式授予并发布生效。
1、在应用管理后台，进入“权限管理” → “API权限” → “添加权限”。
2、依次添加以下三项权限：Card.Streaming.Write、Card.Instance.Write、qyapi_robot_sendmsg。
3、点击“提交审核”，审核通过后点击“发布”按钮，选择“指定人员可见”或“全员可见”范围并确认发布。
三、在WorkBuddy中填入钉钉凭证
此步骤将钉钉应用的身份凭证注入WorkBuddy客户端，使其能以合法身份调用钉钉API。Client ID与Client Secret来源于钉钉应用的基本信息页，非机器人页面。
1、启动WorkBuddy桌面客户端，登录腾讯账号后进入主界面。
2、点击右上角头像 → 选择“Claw设置” → 在IM平台列表中点击“钉钉”。
3、在弹出配置窗口中，粘贴钉钉应用基本信息页中的Client ID与Client Secret（非机器人Webhook页）。
4、将此前记录的Webhook地址完整填入“Webhook URL”字段，点击“保存并测试连接”。
四、在钉钉端添加并启用机器人
仅配置服务端权限和凭证并不足以触发交互，还需在实际钉钉工作群中引入该机器人，使其成为可接收并响应消息的成员。机器人必须被手动添加至目标群组，且群内成员需具备使用权限。
1、打开钉钉App，在目标工作群中点击右上角“+” → “智能助手” → “添加机器人”。
2、搜索已创建的应用名称（如“WorkBuddy-Claw”），点击添加。
3、在弹出的授权页面中，确认授权范围包含“发送消息”与“读取消息”，点击“同意”。
4、添加成功后，该机器人将显示在群成员列表底部，头像旁标注“机器人”字样。
五、验证双向通信是否正常
完成全部配置后，需通过真实消息触发端到端链路，检验从钉钉发令、WorkBuddy解析、本地执行到结果回传的全流程是否畅通。测试应避开特殊字符与长文本，优先使用标准指令格式。
1、在已添加机器人的钉钉群中，向机器人@发送指令：/help 或 你好。
2、观察WorkBuddy客户端右下角是否弹出通知气泡，并在对话区域显示欢迎语或指令解析结果。
3、在WorkBuddy中查看“任务日志”，确认状态为“已接收”、“已解析”、“执行中”；同时检查钉钉群内是否收到结构化卡片形式的响应。
