workbuddy连接钉钉需四步：一、在钉钉群创建自定义机器人并启用http模式及自定义关键词；二、在开发者后台创建企业应用，开通三项权限后获取client id和client secret；三、在workbuddy claw设置中准确填入上述三项凭证并测试连接；四、验证文件接收能力，确保审批附件可自动同步至本地知识库。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
让WorkBuddy连接钉钉，是为了在电脑端直接响应钉钉群消息、自动执行任务或同步审批附件到本地知识库，避免手动切换应用和重复操作。
第一步：在钉钉侧创建自定义机器人
进入目标钉钉群 → 点击右上角「群设置」→「智能群助手」→「添加机器人」→ 选择「自定义机器人」→ 填写名称并勾选协议 → 在安全设置中必须启用“HTTP”模式，同时开启「自定义关键词」并填入至少一个触发词（如“帮我查”），否则WorkBuddy发来的指令会被钉钉拦截。复制生成的Webhook地址——该地址仅显示一次，关闭页面即无法找回。
⚠️注意：如果跳过「自定义关键词」设置，WorkBuddy推送的消息将全部被静默丢弃，且无任何错误提示。
第二步：获取企业级应用凭证（适用于OA/审批/通讯录等深度集成）
登录钉钉开发者后台（https://developers.dingtalk.com）→ 使用企业管理员账号 → 进入「应用开发」→「创建应用」→ 填写基础信息后保存 → 进入新应用详情页 → 左侧菜单点「权限管理」→ 搜索并开通以下三项权限：
• qyapi_robot_sendmsg
• Card.Instance.Write
• Card.Streaming.Write
→ 返回「凭证与基础信息」页面，记录下Client ID 和 Client Secret——这两个值后续必须完整填入WorkBuddy，缺一不可，且不能混淆顺序。
第三步：在WorkBuddy中完成对接
打开WorkBuddy客户端 → 点击右上角头像进入「个人中心」→「Claw设置」→「钉钉集成」→ 按照字段分别填入：
① Client ID
② Client Secret
③ Webhook地址（来自第一步）
→ 点击「保存并测试连接」。
腾讯云代码助手CodeBuddy旗下WorkBuddy 4.24.8版本正式发布。本版本重点修复了上下文压缩异常、冷加载时偶现历史消息丢失、任务停止卡死等问题，并深度优化了Windows沙箱(lightSandbox)的日志写入与误弹窗逻辑，提供更安全稳定的AI协作体验。
若显示“连接成功”，说明通道已通；若提示“没开CLI数据权限”，代表企业管理员尚未为你开通接口调用白名单，此时直接点击页面上的「立即申请」，系统会自动生成审批单推送给管理员，无需额外沟通。
这一步操作起来很简单，直接把三个凭证粘贴进去就行，但务必核对大小写和末尾是否多出空格——Client Secret含特殊字符，复制时容易带入不可见换行符，导致认证失败。
第四步：验证文件接收能力（可选但关键）
方法一：启用Claw的文件监听模式
在Claw设置中开启「接收文件」开关 → 确保本地指定目录有写入权限 → 发送一张图片或PDF到已配置的钉钉群 → WorkBuddy会在几秒内自动下载并保存至设定路径。
方法二：通过OA审批流触发附件同步
在WorkBuddy中新建自动化流程 → 触发条件设为「钉钉OA审批通过」→ 动作节点依次添加：
• 获取审批详情
• 提取附件URL
• 下载附件
• 保存至知识库
→ 此流程依赖第二步开通的qyapi_robot_sendmsg权限，未开通则卡在“获取附件URL”环节，报错代码500。
