Async Task

核心用法

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命令行工具接口变更将导致推送中断

核心用法

OpenClaw Async Task 是专为解决长运行任务 HTTP 超时而设计的异步执行工具。通过 start→execute→done/fail 三段式工作流，用户可在 5 秒内立即获得任务确认，后续结果通过 OpenClaw/Clawdbot CLI 自动推送至活跃会话。

关键命令

• async-task start "描述" — 立即返回任务 ID，避免超时
• async-task done "结果" / async-task fail "错误" — 推送最终结果
• async-task push "消息" — 无需 start 直接推送
• async-task status — 查看任务状态

技术原理：任务状态持久化至 ~/.openclaw/async-task-state.json，会话通过 openclaw sessions 自动检测，消息推送依赖本地 CLI 无需额外认证。

显著优点

1. 零依赖架构：仅使用 Node.js 原生模块（child_process、fs、http/https），无 npm 供应链风险
2. 即装即用：自动检测活跃会话，无需手动配置 session ID
3. 灵活推送：支持自定义 HTTP 端点，可集成企业 Webhook 或内部通知系统
4. 状态隔离：任务状态存储于用户目录，不影响系统关键区域

潜在局限

• T3 来源风险：个人开发者（Enderfga）维护，社区验证有限，需关注后续更新
• 无内置重试：HTTP 推送失败时缺乏自动重试机制，网络不稳定时可能丢消息
• CLI 依赖：必须预装 OpenClaw 或 Clawdbot CLI，纯容器环境需额外配置
• 单会话限制：同一时刻仅支持一个活跃异步任务

适合人群

• OpenClaw/Clawdbot 重度用户，频繁执行代码分析、文件扫描等耗时操作
• 需要集成自定义通知管道的 DevOps 工程师
• 追求极简依赖、重视供应链安全的团队

常规风险

• 自定义推送端点（ASYNC_TASK_PUSH_URL）需自行确保可信，避免敏感数据泄露至不可信服务器
• ASYNC_TASK_AUTH_TOKEN 建议通过密钥管理系统配置，避免明文导出到 shell 历史
• 状态文件权限由用户控制，多用户共享机器时需注意隔离