OpenClaw 异步任务

描述

执行长时间运行的任务，避免HTTP超时。在以下情况时使用：

• 运行可能超过5秒的命令
• 分析大型文件或代码库
• 执行多步骤操作
• 调用延迟不可预测的外部API

重要提示：当任务可能超时时，您必须使用此技能以避免服务器返回空响应或错误。

触发词："async task", "long running", "timeout", "background task", "push result"

安装

# Clone and link globally
git clone https://github.com/Enderfga/openclaw-async-task.git
cd openclaw-async-task
npm link

# Or just copy async-task.js to your PATH
chmod +x async-task.js
cp async-task.js /usr/local/bin/async-task

命令

async-task start "<description>"  # Start task, returns immediately
async-task done "<result>"        # Complete task, push result to user
async-task fail "<error>"         # Task failed, push error message
async-task push "<message>"       # Push message directly (no start needed)
async-task status                 # Show current task status

使用流程（必须严格遵守）

1. 开始：async-task start "正在扫描文件..."
2. 执行：运行您的实际命令
3. 推送结果：异步任务完成："找到42个文件"

示例

用户询问："统计此项目中的所有TypeScript文件"

# Step 1: Acknowledge immediately
async-task start "Counting TypeScript files..."

# Step 2: Do the actual work
count=$(find . -name "*.ts" | wc -l)

# Step 3: Push the result
async-task done "Found $count TypeScript files"

工作原理

1. 开始保存任务状态并立即返回确认
2. 您执行所需的任何命令
3. 完成/失败使用OpenClaw/Clawdbot CLI将结果推送到活动会话

无需配置- 通过以下方式自动检测活动会话openclaw sessions或clawdbot sessions.

高级：自定义推送端点

适用于自定义网页聊天或通知系统：

export ASYNC_TASK_PUSH_URL="https://your-server.com/api/push"
export ASYNC_TASK_AUTH_TOKEN="your-token"

端点接收：

{
  "sessionId": "session-id",
  "content": "message",
  "role": "assistant"
}

环境变量

要求

• Node.js 16+
• 已安装OpenClaw或Clawdbot CLI

关键规则

• 必须配对开始与完成或失败
• 绝不开始后不完成
• 绝不说“稍后推送”然后忘记

链接

• GitHub
• OpenClaw