Openclaw向けqueue-task

task-father 環境での再開可能かつべき等なバッチ処理用に設計された、永続的なキュータスクヘルパーです。

moodykong
v0.1.0
Feb 22, 2026
0
2k
0

インストール&ダウンロード

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 の仕組み

  1. ユーザーはタスクのスラッグ(slug)と、バッチサイズやスケジュールなどの構成パラメーターを提供します。
  2. システムは、状態ファイル(キュー、進捗、完了、失敗、ロック)を含む専用のタスクディレクトリを初期化します。
  3. タスクは、順次またはバッチ処理のために queue.jsonl ファイルに追加されます。
  4. 実行中、スキルは相互排除を確実にするためにアクティブなロックファイルを確認します。
  5. アイテムが処理されるにつれて progress.json が更新され、結果は done.jsonl または failed.jsonl に移動されます。
  6. プロセスが中断された場合、スキルは進捗ファイルを使用して、中断された場所から正確に再開します。

queue-task のセットアップ

Openclaw Skills 環境で queue-task を開始するには、次の手順に従います。

  1. 特定のスラッグのタスク構造を初期化します:
python3 scripts/queue_task.py init <slug>
  1. (オプション)チャット優先の初期化を使用しない場合は、環境を手動で構成します:
cp config.env.example config.env
# WORKSPACE_DIR と BATCH_SIZE を指定して config.env を編集します
  1. インストールとステータスを確認します:
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のスキル

特徴*