async-task

🚀 告别超时困扰的异步任务管家

OpenClaw 生态异步任务管理器,通过后台执行与消息推送,彻底解决 AI 长耗时任务的 HTTP 超时困扰。

收藏
6.2k
安装
2.4k
版本
v0.1.0
CLS 安全性认证2026-05-11
点击查看完整报告 >

使用说明

核心用法

OpenClaw Async Task 提供了一套轻量级 CLI 工具链,专门用于管理需要长时间运行的后台任务。其核心工作流程遵循严格的"启动-执行-完成"三阶段模式:首先通过 async-task start "描述" 立即返回任务确认并保存状态,随后在执行环境中运行实际的耗时操作(如大规模文件扫描、复杂数据分析或慢速 API 调用),最后使用 async-task done "结果"async-task fail "错误" 将结果推送至活跃会话。系统通过调用 openclawclawdbot CLI 的 sessions send 命令实现消息回推,支持自定义 HTTP 端点以满足企业内网或第三方通知系统的集成需求。

显著优点

该 Skill 最突出的价值在于彻底解决了 AI 交互场景中的 HTTP 超时痛点,允许无阻塞地执行超过 5 分钟的复杂任务。零外部依赖的设计(仅使用 Node.js 内置模块)极大降低了供应链攻击面,无需担心恶意依赖包风险。自动会话检测机制实现了零配置开箱即用,能够智能识别当前活跃的 OpenClaw/Clawdbot 会话。本地状态管理采用自动轮转策略,默认仅保留最近 20 条任务记录,有效防止磁盘空间无限膨胀。命令行接口设计简洁直观,通过强制配对 startdone/fail 的规则,确保了任务生命周期的完整性。

潜在缺点

作为 T3 来源的个人开源项目,其长期维护稳定性和社区支持力度相对有限,存在未来断更或兼容性问题的风险。功能强依赖 OpenClaw/Clawdbot CLI 环境,在未安装这些基础设施的系统中完全无法使用,生态封闭性较高。状态管理基于本地文件系统(~/.openclaw/),在容器化、无服务器或分布式部署场景下难以实现状态共享和持久化。缺乏内置的任务队列和重试机制,若执行过程中进程崩溃或系统重启,未完成的任务状态将丢失。对于非 OpenClaw 生态用户而言,学习成本和集成门槛较高。

适合的目标群体

主要面向 OpenClaw/Clawdbot 平台的重度用户,特别是需要构建复杂 AI 工作流的开发者和技术团队。适用于数据工程师执行长时间 ETL 作业、DevOps 工程师处理耗时部署流水线、以及需要扫描大型代码库或生成复杂报告的场景。对于希望将 AI 处理结果推送到自定义渠道(如企业微信、钉钉、Slack 或内部监控系统)的运维人员尤为实用。也适合任何在 AI 交互中频繁遇到 "empty response from server" 错误,需要可靠异步处理机制的技术从业者。

使用风险

尽管代码本身安全性较高,但在高并发场景下频繁的磁盘 I/O 操作(读写 ~/.openclaw/async-task-state.json)可能成为性能瓶颈。使用自定义 HTTP 推送端点时,若未强制使用 HTTPS 协议或妥善保管 ASYNC_TASK_AUTH_TOKEN,存在中间人攻击或会话劫持风险。环境权限方面,需要确保运行用户拥有写入主目录和执行子进程的权限,在严格沙箱或只读文件系统环境中可能运行失败。此外,用户必须严格遵守"启动必完成"的原则,若忘记调用 donefail,会导致任务状态悬空,虽然不影响系统安全,但会造成会话状态不一致。

安全解读

核心用法

OpenClaw Async Task 是一套异步任务执行协议,专门解决大模型处理耗时任务时遭遇的 HTTP 超时限制。其工作流遵循「Start → Execute → Done/Fail」三段式模式:先用 start 立即返回确认,避免用户端等待超时;后台执行实际命令;最终通过 donefail 推送结果。该 Skill 通过 OpenClaw/Clawdbot CLI 与活跃会话自动绑定,零配置即可接入现有工作流。

显著优点

  • 零依赖架构:仅使用 Node.js 内置模块(child_process、fs、https 等),彻底消除供应链攻击风险
  • 即插即用:自动检测 openclaw/clawdbot CLI,无需手动配置会话 ID
  • 灵活推送:支持内置 CLI 推送或自定义 HTTP 端点,兼容企业内网通知系统
  • 状态透明status 命令实时查看任务历史,内置 20 条记录轮转
  • MIT 开源:代码完全公开,安全审计可追溯

潜在局限

  • CLI 强依赖:必须预装 OpenClaw 或 Clawdbot CLI,纯容器环境需额外安装
  • 单会话绑定:每次只能向当前活跃会话推送,不支持多会话广播
  • 无内置重试:HTTP 推送失败需外部处理,无自动指数退避机制
  • Node 版本门槛:要求 Node.js 16+,老旧系统可能存在兼容性问题

适合人群

  • 使用 OpenClaw/Clawdbot 生态的开发者
  • 需要批量处理代码仓库、生成报告、调用慢速 API 的 AI 工作流搭建者
  • 对供应链安全敏感、追求零依赖架构的技术团队

常规风险

  • 进程残留风险:若 start 后脚本异常退出而未调用 done/fail,任务将处于悬挂状态
  • 环境变量泄露ASYNC_TASK_AUTH_TOKEN 以明文形式存在于进程环境,多用户系统需注意权限隔离
  • 自定义端点不可信:用户配置的 ASYNC_TASK_PUSH_URL 若指向不可信服务端,存在数据外泄风险
  • 命令注入边界:虽 CLI 参数经 which 检测固定,但会话 ID 来自外部输入,建议额外校验格式

async-task 内容

手动下载zip · 6.5 kB
async-task.jstext/javascript
请选择文件