通过异步启动、更新和完成任务并立即响应来运行和管理超过 HTTP 超时的长任务。
数据来源:ClawHub。 在 ClawSkills 查看
选择你使用的 Agent
方法一:命令行安装(推荐)
推荐(无需提前安装 clawhub)
npx clawhub@latest --dir ~/.claude/skills install async-task或使用 clawhub CLI(需提前安装)
clawhub --dir ~/.claude/skills install async-task⚠️ 需要 Node.js 18+,没有 Node?请使用下方方法二直接下载 ZIP。 安装 Node.js →
方法二:手动下载安装(无需 Node)
下载 ZIP,解压后将文件夹放到以下路径,重启 Agent 即可:
安装路径
~/.claude/skills/async-task/💡解压后将文件夹放到上方路径,重启 Agent 即可生效
Execute long-running tasks without HTTP timeouts. Use when you need to:
IMPORTANT: When a task might timeout, you MUST use this skill to avoid empty response from server errors.
Triggers: "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
async-task start "Scanning files..."async-task done "Found 42 files"User asks: "Count all TypeScript files in this project"
# 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"
start saves task state and returns confirmation immediatelydone/fail uses OpenClaw/Clawdbot CLI to push result to the active sessionZero configuration required - automatically detects active session via openclaw sessions or clawdbot sessions.
For custom webchat or notification systems:
export ASYNC_TASK_PUSH_URL="https://your-server.com/api/push"
export ASYNC_TASK_AUTH_TOKEN="your-token"
The endpoint receives:
{
"sessionId": "session-id",
"content": "message",
"role": "assistant"
}
| Variable | Required | Description | |----------|----------|-------------| | OPENCLAW_SESSION | No | Target session (auto-detected) | | ASYNC_TASK_PUSH_URL | No | Custom HTTP push endpoint | | ASYNC_TASK_AUTH_TOKEN | No | Auth token for custom endpoint |
start with done or fail安装 异步任务 后,可以对 AI 说这些话来触发它
Help me get started with Async Task
Explains what Async Task does, walks through the setup, and runs a quick demo based on your current project
Use Async Task to run and manage long tasks exceeding HTTP timeouts by starting, upda...
Invokes Async Task with the right parameters and returns the result directly in the conversation
What can I do with Async Task in my documents & notes workflow?
Lists the top use cases for Async Task, with example commands for each scenario
将技能文件夹放到 ~/.claude/skills/async-task/ 目录(个人级,所有项目可用),或 .claude/skills/async-task/(项目级)。重启 AI 客户端后,用 /async-task 主动调用,或让 AI 根据上下文自动发现并使用。
异步任务 支持 Claude、Cursor、OpenClaw,可与这些 AI 平台无缝集成,扩展其能力。
异步任务 可免费安装使用。请查阅仓库了解许可证信息。
通过异步启动、更新和完成任务并立即响应来运行和管理超过 HTTP 超时的长任务。
异步任务 属于「Documents & Notes」分类,该分类的技能帮助 AI 智能体在此领域执行专业任务。
Automate my documents & notes tasks using Async Task
Identifies repetitive steps in your workflow and sets up Async Task to handle them automatically