WorkBuddy与钉钉机器人打通需完成四步：一、在钉钉群创建自定义机器人并获取Webhook地址与密钥；二、在WorkBuddy Claw设置中填入Client ID、Client Secret及Webhook地址并测试连接；三、在钉钉开发者后台开通Card.Streaming.Write、Card.Instance.Write、qyapi_robot_sendmsg三项API权限；四、将WorkBuddy机器人添加至目标钉钉群并发送测试指令验证响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装WorkBuddy桌面客户端，但尚未将其与钉钉机器人打通，导致无法通过钉钉移动端远程下达任务，则问题通常出在机器人配置未完成或权限未开放。以下是实现WorkBuddy与钉钉机器人成功接入的具体步骤：
一、创建并配置钉钉自定义机器人
需在钉钉群中添加自定义机器人，并获取其Webhook地址与密钥，这是WorkBuddy接收指令的通信入口。配置时必须启用HTTP协议模式，否则WorkBuddy无法建立有效连接。
1、进入目标钉钉群，点击右上角“群设置” → “智能群助手” → “添加机器人”。
2、选择“自定义机器人”，填写机器人名称，勾选“我已阅读并同意……”后点击“添加”。
3、在安全设置中，将消息推送方式设为HTTP（推荐），记录生成的Webhook地址及可选密钥。
4、点击“完成”，此时机器人已创建但尚未与WorkBuddy关联。
二、在WorkBuddy中填入钉钉机器人凭证
WorkBuddy需通过Claw设置模块录入钉钉机器人的身份标识，包括Client ID、Client Secret及Webhook地址，从而完成双向认证与通道绑定。
1、打开WorkBuddy客户端，点击右上角头像进入个人中心。
2、选择“Claw设置” → “配置指南”，找到钉钉接入选项。
3、在对应输入框中分别填入：Client ID、Client Secret、Webhook地址（三者缺一不可）。
4、点击“保存并测试连接”，确认状态显示“连接成功”。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
三、开通钉钉机器人必要API权限
仅配置Webhook不足以支持完整交互功能，WorkBuddy需调用钉钉开放平台的特定接口以发送卡片消息、流式响应及异步任务通知，因此必须手动开启三项关键权限。
1、登录钉钉开发者后台，进入对应应用的“权限管理”页面。
2、在API权限列表中，搜索并勾选以下三项：Card.Streaming.Write、Card.Instance.Write、qyapi_robot_sendmsg。
3、提交权限申请，等待审核通过（通常即时生效）。
4、返回应用详情页，点击“发布”按钮，发布范围选择指定群组或全员可见。
四、在钉钉中添加并启用WorkBuddy机器人
完成后台配置后，需在实际使用场景（即钉钉群）中正式启用该机器人，使其具备接收和响应用户消息的能力。
1、在钉钉搜索栏输入机器人名称，找到已配置的WorkBuddy机器人。
2、点击进入机器人主页，点击“添加到群聊”，选择目标工作群。
3、在群内发送任意测试指令，例如“帮我查一下今天待办事项”。
4、观察WorkBuddy客户端是否触发响应动作，若弹出执行界面或返回结构化卡片，则接入成功。
