一個專為 task-father 環境中的可恢復和冪等批量處理設計的持久化隊列任務助手。
安裝與下載
1. ClawHub CLI
從來源直接安裝技能的最快方式。
npx clawhub@latest install queue-task
2. 手動安裝
將技能資料夾複製到以下位置之一
~/.openclaw/skills/ <project>/skills/ 優先級：工作區 > 本地 > 內建
3. 提示詞安裝
將此提示詞複製到 OpenClaw 即可自動安裝。
請幫我使用 Clawhub 安裝 queue-task。如果尚未安裝 Clawhub，請先安裝（npm i -g clawhub）。
想要直接下載？
取得包含原生技能檔案的ZIP壓縮檔。
什麼是 queue-task？
queue-task 技能是一個專門設計的實用工具，用於處理 Openclaw Skills 框架內的長時間運行、異步操作。它透過提供結構化的、基於文件的隊列系統，解決了在分散式或中斷的工作流中保持狀態的常見挑戰。透過利用 task-father 目錄佈局，它使開發人員能夠構建既可靠又可擴展的自動化。
其核心關注點在於持久性和冪等性。它使用唯追加日誌來確保在處理過程中不丟失數據，並利用鎖定文件來防止並發執行過程中的競態條件。無論您是在處理大型數據集還是管理多步驟代理工作流，queue-task 都能提供必要的支架來保持作業的組織性和可恢復性。
queue-task 應用場景
- 處理需要可恢復狀態追蹤的高容量數據批次。
- 編排可能跨越多個對話的長運行 AI 代理任務。
- 實現任務在重試時不得重複的冪等工作流。
- 透過 Openclaw Skills 內部的 cron 集成調度定期維護或同步作業。
queue-task 運作原理
- 用戶提供任務標識（slug）以及批處理大小和調度等配置參數。
- 系統初始化包含狀態文件（隊列、進度、已完成、失敗和鎖）的專用任務目錄。
- 任務被追加到 queue.jsonl 文件中以進行順序或批處理。
- 在執行期間，技能會檢查啟動的鎖定文件以確保互斥。
- 隨著項目的處理，進度文件 progress.json 會被更新，結果會移至 done.jsonl 或 failed.jsonl。
- 如果進程中斷，技能將使用進度文件從上次中斷的地方精確恢復。
queue-task 設定指南
要在您的 Openclaw Skills 環境中開始使用 queue-task，請遵循以下步驟：
- 為您的特定標識初始化任務結構：
python3 scripts/queue_task.py init <slug>
- （可選）如果不使用對話優先的初始化，請手動配置您的環境：
cp config.env.example config.env
# 編輯 config.env，設置您的 WORKSPACE_DIR 和 BATCH_SIZE
- 驗證安裝和狀態：
python3 scripts/queue_task.py status <slug>
queue-task 資料結構與分類體系
該技能在 tasks 目錄中使用平面文件數據庫方法組織其狀態。這確保了在不同 Openclaw Skills 實現之間的便攜性和透明度：
| 文件 | 格式 | 用途 |
|---|---|---|
queue.jsonl |
JSONL | 存儲等待處理的掛起任務列表。 |
progress.json |
JSON | 追蹤當前批次的偏移量和元數據。 |
done.jsonl |
JSONL | 成功完成任務的永久日誌。 |
failed.jsonl |
JSONL | 捕捉失敗項目的任務數據和錯誤詳情。 |
lock.json |
JSON | 防止並發執行並存儲進程 PID。 |
queue-task 進階特性
- 支持過期鎖定檢測和手動清理，以確保高可用性。
- 生成用於進程監控和自動重啟的 supervisor 工作程序模板。
- 與 Openclaw Skills cron 表達式原生兼容，用於自動化調度。
- 透過環境變數 (config.env) 進行便攜式配置，實現跨機器無縫部署。
- 採用唯追加的 JSONL 日誌記錄，實現高性能寫入操作和可審計性。
SKILL.md
加載中
Openclaw 相關技能
OneDrive 集成
一個專為 AI 智慧體設計的工具，用於自動將本地檔案移動並重新命名至 Microsoft OneDrive，以便在行動聊天平台上進行無縫共享。
Perstudio AI 圖像與影片生成
一款專為 Openclaw Skills 設計的專業級 AI 媒體引擎，可將自然語言轉化為高保真圖像、影片和音訊。
精選*
