SuperAPI AI 工具集

telegram-native-8787

通用与其它

查看项目

更新于 10-16 05:53

技能介绍

用途:该技能是 Telegram 渠道专项排障工作流,需在 channel-debug-core 之后使用,用于处理 /api/channels/telegram/webhook 相关故障、原生端口 8787 的 /telegram-webhook、webhookSecret、启动消息清理以及“已接受但用户看不到回复”等问题。

涉及文件:src/app/api/channels/telegram/webhook/route.ts、src/server/channels/telegram/**、src/server/workflows/channels/drain-channel-workflow.ts、src/server/openclaw/config.ts、src/server/admin/why-not-ready.ts、src/app/api/channels/summary/route.ts。

运行时路径:Telegram update 进入 /api/channels/telegram/webhook,经 secret header 校验、去重后,走快路径到 sandbox 端口 8787 的 /telegram-webhook,或进入 workflow;再进行本地/公网原生 handler 探测,交给 OpenClaw Telegram provider,最终产生 Telegram 用户可见回复。

需并行消费的证据:一、Vercel/应用日志,包括 accepted webhook、planner event、fast-path 结果、workflow handoff、requestId/deliveryId/update_id,以及项目指向证明;二、Sandbox 运行态,包括真实 sandboxId、8787 端口监听、本地/公网 /telegram-webhook 探测、清理后的配置含 channels.telegram、webhookSecret 是否存在(不取值);三、Workflow 状态,drainChannelWorkflow 运行态,以及 8787 not-listening/ECONNREFUSED 是否触发 reconciliation,并在 .vercel/project.json 与故障目标不一致时核验项目指向;四、与既往修复对比,包括 webhookSecret 流程、suspicious_empty_200、陈旧 8787 URL 刷新、启动消息清理。

特别检查:8787 不是 3000;原生 handler 是否注册以本地/公网探测行为为准,尤其无效 secret 时本地返回 401;快速返回的空 200 可疑,不应视为 accepted;lastRestoreMetrics.telegramListenerReady 只是证据之一而非全部事实;webhookSecret 必须流经 config build、restore assets、dynamic resume files 与 config hash;转发被接受不证明用户能看到回复;启动消息的发送/更新/删除行为是用户可见证据。

限制:资料未提供收费、价格、平台支持范围或具体安装步骤,未提供可执行的命令示例,相关内容暂未提供。