告别超时，后台任务结果自动送达

解决AI工具HTTP超时限制的异步任务执行方案，让长耗时操作在后台运行并主动推送结果，避免"empty response"错误。

基本信息

• 技能名称?Async Task
• 中文名称?告别超时，后台任务结果自动送达
• 作者?enderfga
• 分类?其他
• 版本?0.1.0
• 标签?async, background-task, cli-tool, nodejs, openclaw, timeout-handling, automation, push-notification

使用方法

使用说明
核心用法
OpenClaw Async Task 是一套专为AI对话场景设计的异步任务执行工具，解决大模型工具调用中HTTP超时导致的任务中断问题。其工作流程严格遵循"启动-执行-推送"三阶段模式：首先通过 async-task start 立即返回确认信息保持会话连接，然后在后台执行实际耗时操作（如大文件扫描、代码分析、外部API调用），最后使用 async-task done 或 async-task fail 将结果主动推送至用户会话。
显著优点
零配置开箱即用 ：自动检测 OpenClaw/Clawdbot 活跃会话，无需手动管理session ID
超时免疫 ：彻底规避5秒以上的HTTP响应超时限制，支持任意时长任务
会话状态保持 ：用户无需等待，可继续其他对话，结果自动送达
灵活推送机制 ：支持原生CLI推送与自定义HTTP端点，便于集成企业通知系统
轻量依赖 ：仅依赖Node.js 16+与现有OpenClaw CLI工具
潜在缺点与局限性
会话绑定风险 ：自动检测依赖 openclaw sessions 命令，若CLI未安装或会话过期则推送失败
无内置重试机制 ：单次推送失败（如网络抖动）不会自动重试，可能导致结果丢失
状态管理简陋 ： status 命令仅显示基础信息，无任务队列、优先级或取消机制
单会话限制 ：未明确支持多会话并行或任务隔离，复杂场景易混淆
生态封闭性 ：专为OpenClaw/Clawdbot设计，迁移至其他AI平台需改造推送层
适合人群
频繁执行代码仓库分析、日志处理、构建任务的开发者
需要集成不稳定第三方API（如慢速LLM、数据服务）的自动化工作流
使用OpenClaw/Clawdbot作为AI基础设施的企业团队
追求"启动即返回"用户体验的AI应用构建者
常规风险
orphaned tasks ：开发者未遵循 start 必须配 done/fail 的规则，导致任务悬停占用资源
信息泄露 ：自定义推送端点若未配置 ASYNC_TASK_AUTH_TOKEN ，传输内容可能被截获
会话劫持 ： OPENCLAW_SESSION 环境变量若被恶意覆盖，结果可能推送给错误用户
CLI版本漂移 ：依赖的 openclaw / clawdbot 命令行工具接口变更将导致推送中断