问题极可能出在事件订阅缺失、权限未开通或回调地址不可达：需依次验证飞书事件订阅配置、开通im:message等必要权限、确保Workbuddy回调地址可访问且服务正常、确认机器人已添加至目标会话、排查OpenClaw插件加载异常。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您已将Workbuddy接入飞书，但机器人在群聊或单聊中完全无响应，既不回复消息也不触发任何日志输出，则问题极可能出在事件订阅缺失、权限未开通或回调地址不可达。以下是排查与修复该故障的多个独立路径：
一、验证飞书开放平台事件订阅配置
飞书机器人必须显式订阅特定事件类型，否则即使消息送达飞书服务器，也不会转发至Workbuddy后端。未订阅im.message.receive_v1将导致所有用户消息被静默丢弃。
1、登录飞书开放平台，进入对应应用的「事件订阅」页面。
2、确认已点击「添加事件」，并在弹出列表中勾选以下三项： im.message.receive_v1、im.message.message_read_v1、contact.user.add_v4。
3、检查「启用状态」是否为开启，且「订阅地址」栏中填写的URL与Workbuddy实际暴露的HTTPS回调地址完全一致（含末尾斜杠）。
4、点击「验证」按钮，等待飞书返回绿色对勾提示；若失败，需先确保Workbuddy服务正在运行且该URL可被公网访问。
二、核对飞书应用权限开通状态
事件订阅仅负责消息投递，而权限决定了Workbuddy能否合法读取和解析这些消息内容。缺少im:message基础权限将导致飞书在网关层直接拦截请求，不生成任何错误日志。
1、在飞书开放平台同一应用下，进入「权限管理」→「权限列表」。
2、查找并确认以下权限已处于「已开通」状态：im:message、im:message.group:readonly、im:message.p2p:readonly、contact:user:readonly。
3、若任一权限显示「待管理员审批」，需联系企业飞书管理员在后台「应用管理」中完成人工授权。
4、完成开通后，点击「重新授权」按钮，强制刷新权限缓存。
三、检查Workbuddy本地服务与回调连通性
飞书回调请求必须能成功抵达Workbuddy进程监听的端口，且服务需正确响应200状态码及飞书要求的加密校验。任意网络或代码层阻断均会导致超时丢弃。
1、在Workbuddy部署主机上执行命令：curl -I https://your-workbuddy-domain.com/api/feishu/event，确认返回HTTP 200而非连接拒绝或超时。
2、检查Workbuddy进程是否运行：ps aux | grep workbuddy（Linux/macOS）或任务管理器（Windows），确保主服务与Feishu插件子进程均存活。
3、查看Workbuddy日志文件（通常位于logs/feishu.log或控制台输出），搜索关键词event verification failed或signature mismatch，定位签名验证失败原因。
4、确认App ID与App Secret已准确填入Workbuddy配置文件，且未被空格或换行符污染。
四、确认飞书机器人已正确添加至目标会话
Workbuddy作为飞书机器人，必须被手动添加进具体群组或与用户发起单聊，飞书不会自动向未添加对象投递消息。未添加即无上下文，自然无响应。
1、在飞书客户端中打开目标群聊，点击右上角「群设置」→「添加机器人」→ 搜索并选择已发布的Workbuddy应用。
2、若为单聊测试，需在飞书通讯录中找到该机器人名称，点击进入其主页后发送首条消息以建立会话通道。
3、发送测试消息前，确认当前账号具备该群组的「邀请成员」权限；如为「仅管理员可添加」群组，需由管理员操作。
4、发送后立即检查Workbuddy日志，确认是否收到原始payload；若无记录，说明飞书根本未发起回调，问题仍在前三步范围内。
五、排查OpenClaw兼容性与插件加载异常
Workbuddy完全兼容OpenClaw技能，但若底层依赖插件未正确加载或版本冲突，会导致事件路由中断，消息进入框架后即丢失，不抛出异常也不执行逻辑。
1、在Workbuddy项目根目录执行：openclaw plugins list，确认输出中包含@m1heng-clawd/feishu且状态为enabled。
2、若未列出，执行：openclaw plugins install @m1heng-clawd/feishu 并重启Workbuddy服务。
3、检查node_modules/@m1heng-clawd/feishu目录是否存在dist/index.js，若缺失则需手动运行npm run build生成。
4、在Workbuddy启动日志中搜索FeishuPlugin loaded，确认插件初始化成功，且注册了/api/feishu/event路由。
