Task Flow は、バックグラウンドタスクの上に位置するフローオーケストレーション基盤です。個々のタスクが分離された作業の単位であり続ける一方で、独自の状態、リビジョン追跡、同期セマンティクスを持つ耐久性のある複数ステップのフローを管理します。Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Task Flow を使うタイミング
作業が複数の逐次ステップまたは分岐ステップにまたがり、Gateway の再起動をまたいで耐久性のある進捗追跡が必要な場合は Task Flow を使用します。単一のバックグラウンド操作では、通常のタスクで十分です。| シナリオ | 使用 |
|---|---|
| 単一のバックグラウンドジョブ | 通常のタスク |
| 複数ステップのパイプライン (A then B then C) | Task Flow (managed) |
| 外部で作成されたタスクを監視する | Task Flow (mirrored) |
| 1回限りのリマインダー | Cron ジョブ |
信頼性の高いスケジュール済みワークフローパターン
市場インテリジェンスのブリーフィングなどの反復ワークフローでは、スケジュール、オーケストレーション、信頼性チェックを別々のレイヤーとして扱います。- タイミングにはスケジュール済みタスクを使用します。
- ワークフローが以前のコンテキストを基にする必要がある場合は、永続的な cron セッションを使用します。
- 決定論的なステップ、承認ゲート、再開トークンには Lobster を使用します。
- 子タスク、待機、再試行、Gateway の再起動をまたぐ複数ステップの実行を追跡するには Task Flow を使用します。
isolated ではなく session:<id> を使用します。各実行を新規に開始し、必要な状態がすべてワークフロー内で明示されている場合は isolated を使用します。
ワークフロー内では、LLM 要約ステップの前に信頼性チェックを配置します。
- ブラウザーの可用性とプロファイルの選択。たとえば、管理された状態には
openclaw、サインイン済みの Chrome セッションが必要な場合はuserを使用します。Browser を参照してください。 - 各ソースの API 認証情報とクォータ。
- 必要なエンドポイントへのネットワーク到達性。
lobster、browser、llm-taskなど、エージェントで必要なツールが有効になっていること。- 事前チェックの失敗が見えるように、cron の失敗先が設定されていること。スケジュール済みタスクを参照してください。
sourceUrl、retrievedAt、asOf を保持するように依頼する必要があります。ワークフロー内でスキーマ検証済みのモデルステップが必要な場合は、LLM Task を使用します。
チームまたはコミュニティで再利用可能なワークフローの場合は、CLI、.lobster ファイル、セットアップメモを skill または plugin としてパッケージ化し、ClawHub を通じて公開します。plugin API に必要な汎用機能が欠けている場合を除き、ワークフロー固有のガードレールはそのパッケージ内に保持します。
同期モード
managed モード
Task Flow はライフサイクル全体を所有します。フローステップとしてタスクを作成し、完了まで実行させ、フロー状態を自動的に進めます。 例: (1) データを収集し、(2) レポートを生成し、(3) 配信する週次レポートフロー。Task Flow は各ステップをバックグラウンドタスクとして作成し、完了を待ってから次のステップに進みます。mirrored モード
Task Flow は外部で作成されたタスクを監視し、タスク作成の所有権を持たずにフロー状態を同期させます。これは、タスクが cron ジョブ、CLI コマンド、またはその他のソースから発生し、それらの進捗をフローとして統一的に表示したい場合に便利です。 例: 3つの独立した cron ジョブがまとまって「朝の運用」ルーチンを形成する場合。mirrored フローは、それらがいつ、どのように実行されるかを制御せずに、全体の進捗を追跡します。耐久性のある状態とリビジョン追跡
各フローは独自の状態を永続化し、リビジョンを追跡するため、Gateway の再起動後も進捗が維持されます。リビジョン追跡により、複数のソースが同じフローを同時に進めようとした場合の競合検出が可能になります。 フローレジストリは SQLite を使用し、定期チェックポイントとシャットダウン時チェックポイントを含む、境界付きの write-ahead-log メンテナンスを行うため、長時間実行される Gateway が無制限のregistry.sqlite-wal サイドカーファイルを保持し続けることはありません。
キャンセル動作
openclaw tasks flow cancel は、フローに固定のキャンセル意図を設定します。フロー内のアクティブなタスクはキャンセルされ、新しいステップは開始されません。キャンセル意図は再起動をまたいで保持されるため、すべての子タスクが終了する前に Gateway が再起動しても、キャンセルされたフローはキャンセルされたままになります。
CLI コマンド
| コマンド | 説明 |
|---|---|
openclaw tasks flow list | 追跡中のフローをステータスと同期モード付きで表示します |
openclaw tasks flow show <id> | フロー ID または検索キーで1つのフローを調査します |
openclaw tasks flow cancel <id> | 実行中のフローとそのアクティブなタスクをキャンセルします |
フローとタスクの関係
フローはタスクを置き換えるものではなく、タスクを調整するものです。単一のフローは、その存続期間中に複数のバックグラウンドタスクを駆動する場合があります。個々のタスクレコードを調査するにはopenclaw tasks を使用し、オーケストレーションするフローを調査するには openclaw tasks flow を使用します。
関連
- バックグラウンドタスク — フローが調整する分離された作業台帳
- CLI: タスク —
openclaw tasks flowの CLI コマンドリファレンス - 自動化の概要 — すべての自動化メカニズムの概要
- Cron ジョブ — フローに供給される可能性のあるスケジュール済みジョブ