workbuddy需分别完成飞书和钉钉的机器人合法注册与双向认证才能正常接收指令、同步状态、执行任务。飞书端须创建自建应用、导入指定json权限、绑定app id/secret并订阅im.message.receive_v1等事件；钉钉端支持群内自定义机器人或开发者后台正式应用两种方式，均需配置webhook（https）、开通card.streaming.write等权限并完成发布。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy已安装但无法通过飞书或钉钉接收指令、同步状态、执行任务，说明IM机器人通道尚未完成合法注册与双向认证。必须分别在飞书开放平台和钉钉开发者后台完成应用创建、权限开通、凭证配置与事件订阅，缺一不可。
飞书端：企业自建应用创建与权限导入
第一步：访问飞书开放平台，使用企业管理员账号登录，点击「创建企业自建应用」。
第二步：填写应用名称（如“WorkBuddy-办公助手”）、应用描述，上传图标后点击「创建」；创建成功后自动跳转至应用详情页。
第三步：在左侧菜单栏进入「添加应用能力」→ 找到「机器人」卡片 → 点击「添加」。
第四步：进入「权限管理」→「批量导入/导出权限」→ 清空输入框 → 【必须完整粘贴以下JSON代码，首尾空格、换行、引号均不可删改】：
{ "scopes":{ "tenant":[ "contact:contact.base:readonly", "docx:document:readonly", "im:chat:read", "im:chat:update", "im:message.group_at_msg:readonly", "im:message.p2p_msg:readonly", "im:message.pins:read", "im:message.pins:write_only", "im:message.reactions:read", "im:message.reactions:write_only", "im:message:readonly", "im:message:recall", "im:message:send_as_bot", "im:message:send_multi_users", "im:message:send_sys_msg", "im:message:update", "im:resource", "application:application:self_manage", "cardkit:card:write", "cardkit:card:read" ], "user":[ "contact:user.employee_id:readonly", "offline_access", "base:app:copy", "base:field:create", "base:field:delete", "base:field:read", "base:field:update", "base:record:create", "base:record:delete", "base:record:retrieve" ] } }
第五步：点击「确定新增权限」，等待页面提示「权限已添加成功」——若无提示或报错，说明JSON格式有误，需重新校对。
飞书端：App ID/Secret绑定与Webhook订阅
进入应用详情页左侧菜单「凭证与基础信息」，完整复制App ID与App Secret。
打开本地WorkBuddy客户端 → 右上角头像 →「Claw设置」→「飞书集成」→ 分别粘贴App ID与App Secret → 点击「注册」。
注册成功后，页面将生成一个Webhook URL，请完整复制该链接。
返回飞书开放平台 → 进入「事件配置」→「订阅方式」→ 选择「将事件发送至开发者服务器」→ 粘贴刚复制的Webhook URL → 保存。
在「事件配置」中手动添加「im.message.receive_v1」事件；在「回调配置」中添加「card.action.trigger」回调项。
钉钉端：H5微应用+机器人双模配置
方法一：群内快速创建自定义机器人（适合无管理员权限但可建群的用户）
① 进入目标钉钉群 → 右上角「群设置」→「智能群助手」→「添加机器人」→ 选择「自定义机器人」。
② 填写机器人名称，勾选协议条款 → 完成后，在安全设置中选择HTTP模式 → 记录Webhook地址与密钥（密钥可为空，但Webhook必须保留）。
③ 打开WorkBuddy →「Claw设置」→「钉钉集成」→ 填入Client ID、Client Secret（若无则跳过此步，仅用Webhook模式）、Webhook地址 → 点击「保存并测试连接」。
方法二：开发者后台创建正式应用（推荐，支持完整功能）
① 登录钉钉开发者后台，使用企业管理员账号 →「应用开发」→「创建应用」→ 填写名称、描述 → 保存。
② 应用创建后 →「添加应用能力」→「机器人」→ 填写机器人基本信息 →「确认发布」。
③ 进入「权限管理」→ 搜索并开通三项权限：【Card.Streaming.Write、Card.Instance.Write、qyapi_robot_sendmsg】 → 提交后点击「发布」。
④ 左侧菜单进入「凭证与基础信息」→ 复制Client ID与Client Secret → 回到WorkBuddy「钉钉集成」页面填入 → 点击「注册」获取Webhook地址。
⑤ 返回钉钉开发者后台 → 进入机器人配置页 → 滚动到底部「消息接收配置」→ 将Stream模式切换为HTTP模式 → 在「消息接收地址」中粘贴WorkBuddy生成的Webhook → 【务必把地址开头的http://改为https://，否则回调失败】 → 点击「发布」。
双通道冗余部署与最终验证
在飞书搜索栏输入应用名称，打开机器人对话窗口，发送“/help”或任意指令，观察是否返回响应。
在钉钉群中@刚添加的机器人，发送“/status”，确认WorkBuddy桌面端弹出任务提示并执行反馈。
若任一平台无响应，立即检查：飞书是否已发布应用版本、钉钉是否完成HTTPS地址替换、WorkBuddy Claw功能是否处于开启状态。
两个平台均显示“连接成功”且可交互后，关闭所有配置页面。
