用途:该技能面向 Slack 频道问题的深度排查,建议在 channel-debug-core 之后使用,聚焦“能收到事件”与“能真正投递回复”之间的差异。
运行路径:Slack 事件进入 /api/channels/slack/webhook,基于原始请求体做 Slack 签名校验,再进行事件/bot/子类型/用户消息去重;随后走快速路径到 3000 端口的 /slack/events,或进入 workflow,由 Bolt 再次验证签名后以线程方式回复 Slack。
主要能力:
- 判定 OAuth 授权完成不等于投递就绪;排查 liveConfigSync 失败是否可被近期已接受的 lastForward 覆盖。
- 解析 Slack 401:通常来自原生处理器的 Bolt 签名失败,需确认原始请求体与 x-slack-* 请求头在转发过程中未被破坏。
- 路由修复:出现 404 后修复路由,必须用修复前后的信号加以证明。
- 启动消息清理:当机器人回复事件到达时,清理待处理的启动消息。
- 识别 app_mention 与 message.channels 造成用户意图重复的情况。
相关文件:src/app/api/channels/slack/webhook/route.ts、src/server/channels/slack/**、src/server/workflows/channels/drain-channel-workflow.ts、src/server/admin/why-not-ready.ts、src/app/api/channels/summary/route.ts。
使用方式:提出 Slack 修复方案前,先消费并行通道输入,包括 Vercel/应用日志中的 channels.slack_webhook_accepted、快速路径事件、回退/workflow 事件、requestId/deliveryId 与项目指向证据;沙箱运行时中的 3000 端口监听、/slack/events 探测行为、OpenClaw 插件数量、脱敏配置是否含 channels.slack;快速路径被跳过或失败时 drainChannelWorkflow 的运行状态,以及在 .vercel/project.json 与事故目标不一致时经核实的项目指向;并与既有修复(openclaw-42 零插件卡死、沙箱 URL 过期、workflow 重试耗尽、Slack 401 原始请求体/签名失败)做对比。
限制:以上为资料中给出的流程与检查点,未提供具体命令、配置模板、收费或平台支持范围,实施细节需结合项目实际情况确认。