async-task

核心用法

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

显著优点

该 Skill 最突出的价值在于彻底解决了 AI 交互场景中的 HTTP 超时痛点，允许无阻塞地执行超过 5 分钟的复杂任务。零外部依赖的设计（仅使用 Node.js 内置模块）极大降低了供应链攻击面，无需担心恶意依赖包风险。自动会话检测机制实现了零配置开箱即用，能够智能识别当前活跃的 OpenClaw/Clawdbot 会话。本地状态管理采用自动轮转策略，默认仅保留最近 20 条任务记录，有效防止磁盘空间无限膨胀。命令行接口设计简洁直观，通过强制配对 start 与 done/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，存在中间人攻击或会话劫持风险。环境权限方面，需要确保运行用户拥有写入主目录和执行子进程的权限，在严格沙箱或只读文件系统环境中可能运行失败。此外，用户必须严格遵守"启动必完成"的原则，若忘记调用 done 或 fail，会导致任务状态悬空，虽然不影响系统安全，但会造成会话状态不一致。