若workbuddy无法通过飞书或钉钉接收指令、同步状态或执行任务，需分别完成飞书自建应用配置（含权限导入、webhook绑定与版本发布）和钉钉h5微应用+机器人双模配置（含权限开通、https回调设置与版本发布），并支持双通道冗余部署以保障任务连续性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已部署 WorkBuddy 桌面客户端，但无法通过企业现有的飞书或钉钉接收指令、同步状态或执行任务，则可能是由于应用未在对应平台完成合法注册、权限未开通、机器人未入群或凭证配置错误。以下是解决此问题的步骤：
一、飞书端集成：企业自建应用全流程配置
该方法通过飞书开放平台创建专属企业自建应用，赋予 WorkBuddy 在指定组织内收发消息、解析卡片、响应交互的完整能力，适用于拥有飞书管理员权限的企业环境。所有操作均需在飞书管理后台与 WorkBuddy 客户端协同完成。
1、访问飞书开放平台（https://open.feishu.cn/），使用企业管理员账号登录，点击「创建企业自建应用」。
2、填写应用名称（如“WorkBuddy-企业办公助手”）、应用描述，上传图标后点击「创建」。
3、进入应用详情页，在「添加应用能力」区域找到「机器人」卡片，点击「添加」。
4、左侧菜单进入「权限管理」→「批量导入/导出权限」，清空输入框，粘贴以下完整权限代码块：
{ "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" ] } }
5、点击「确定新增权限」，等待页面提示「权限已添加成功」。
6、左侧菜单点击「凭证与基础信息」，完整复制 App ID 与 App Secret；App Secret 为高敏感密钥，严禁截图、转发或明文存储。
7、打开 WorkBuddy 客户端，点击右上角头像 →「Claw 设置」→「飞书集成」，将 App ID 与 App Secret 粘贴至对应字段，点击「注册」。
8、注册成功后，系统生成 Webhook URL，立即复制；返回飞书开放平台应用详情页，进入「事件配置」→「订阅方式」，选择「将事件发送至开发者服务器」，粘贴 Webhook 并保存。
9、在「事件配置」中手动添加「接收消息」事件；进入「回调配置」，搜索并添加「卡片回传交互」。
10、点击「创建版本」，填写版本号（如 1.0.0）及描述，点击「发布」；若创建者为企业超级管理员，通常自动免审批通过。
二、钉钉端集成：H5微应用+机器人双模配置
该方法采用钉钉 H5 微应用作为主通道，配合机器人能力实现指令下发与状态回传，支持企业级 SSO 登录、可信域名校验及细粒度群权限控制，适用于已启用钉钉 OA 管理体系的企业。
1、访问钉钉开发者后台（https://developers.dingtalk.com/），使用企业管理员账号登录；若提示“该账号还未加入组织”，可创建个人企业并完成实名认证。
2、点击「应用开发」→「创建应用」，选择「H5 微应用」类型，填写应用名称（如“WorkBuddy-钉钉协同”）、描述、上传图标，点击「保存」。
3、应用创建成功后，自动跳转至「添加应用能力」页面，点击「添加机器人」，填写机器人名称、描述、预览图，点击「确认发布」。
4、左侧菜单进入「权限管理」，在搜索框中依次输入并开通以下三项权限：
Card.Streaming.Write
Card.Instance.Write
qyapi_robot_sendmsg
5、左侧菜单点击「凭证与基础信息」，完整复制 Client ID（即 AppKey）与 Client Secret（即 AppSecret）；二者必须与 WorkBuddy 配置界面完全一致，大小写及符号不可遗漏。
6、返回 WorkBuddy，进入「Claw 设置」→「钉钉集成」，填入 Client ID 与 Client Secret，点击「注册」获取 Webhook 地址并复制。
7、返回钉钉开发者后台，进入机器人配置页，下滑至「消息接收配置」，将「Stream 模式」切换为「HTTP 模式」，在「消息接收地址」中粘贴 Webhook 地址；必须将地址开头的 http 改为 https，否则回调失败。
8、点击「发布」保存配置。
9、点击页面上方「查看版本详情」，填写版本描述后点击「确认发布」；等待审核通过（通常为自动审批）。
三、企业级多通道冗余部署：飞书+钉钉双活同步
该方案通过在 WorkBuddy 中同时启用飞书与钉钉两个集成模块，构建指令双通道分发与结果聚合机制，当任一平台连接中断时，另一通道仍可保障关键任务可达性，适用于对办公连续性要求高的企业场景。
1、在 WorkBuddy「Claw 设置」中，分别完成「飞书集成」与「钉钉集成」的全部配置流程，确保两个模块状态栏均显示「已连接」。
2、在飞书中搜索并添加 WorkBuddy 机器人，发送指令“/status”；同步在钉钉中搜索同一机器人并发送相同指令。
3、观察 WorkBuddy 桌面端任务栏右下角是否出现双通道同步提示图标（含飞书与钉钉双标识）。
4、在飞书目标群中发送“帮我整理今天项目群的会议记录”，同时在钉钉同名群中发送相同指令；WorkBuddy 将自动识别平台来源并分别调用对应 API，不产生指令冲突。
5、检查两平台返回结果是否均包含执行日志、中间产物（如表格截图）及最终交付物（如 PPT 文件）；任一通道失败时，另一通道结果仍完整回传。
6、在 WorkBuddy 主界面左下角点击「+ 添加Bot」按钮，从列表中选择「飞书」或「钉钉」，可单独启用或禁用指定通道；禁用某通道后，其关联的凭证与 Webhook 自动失效，无需额外清理。
