Automation

タスクフロー

Task Flow は、バックグラウンドタスクの上位に位置するフローオーケストレーション基盤です。個々のタスクを切り離された作業の単位として維持しながら、独自の状態、リビジョン追跡、同期セマンティクスを持つ永続的な複数ステップのフローを管理します。

Task Flow を使う場面

作業が複数の順次ステップまたは分岐ステップにまたがり、Gateway の再起動をまたいだ永続的な進捗追跡が必要な場合は Task Flow を使用します。単一のバックグラウンド操作であれば、通常のタスクで十分です。

シナリオ	使用するもの
単一のバックグラウンドジョブ	通常のタスク
複数ステップのパイプライン（A、次に B、次に C）	Task Flow（管理）
外部で作成されたタスクを監視する	Task Flow（ミラー）
1回限りのリマインダー	Cron ジョブ

信頼性の高いスケジュール済みワークフローパターン

市場インテリジェンスのブリーフィングなどの定期ワークフローでは、スケジュール、オーケストレーション、信頼性チェックを別々のレイヤーとして扱います。

タイミングにはスケジュール済みタスクを使用します。
ワークフローが以前のコンテキストを基に進むべき場合は、永続的な cron セッションを使用します。
決定論的なステップ、承認ゲート、再開トークンには Lobster を使用します。
子タスク、待機、再試行、Gateway の再起動をまたいで複数ステップの実行を追跡するには Task Flow を使用します。

cron 形状の例:

bash

openclaw cron add \  --name "Market intelligence brief" \  --cron "0 7 * * 1-5" \  --tz "America/New_York" \  --session session:market-intel \  --message "Run the market-intel Lobster workflow. Verify source freshness before summarizing." \  --announce \  --channel slack \  --to "channel:C1234567890"

定期ワークフローに意図的な履歴、前回実行の要約、または常設コンテキストが必要な場合は、isolated ではなく session:<id> を使用します。各実行を新規に開始し、必要な状態がすべてワークフロー内で明示されるべき場合は、isolated を使用します。

ワークフロー内では、LLM 要約ステップの前に信頼性チェックを配置します。

yaml

name: market-intel-briefsteps:  - id: preflight    command: market-intel check --json  - id: collect    command: market-intel collect --json    stdin: $preflight.json  - id: summarize    command: market-intel summarize --json    stdin: $collect.json  - id: approve    command: market-intel deliver --preview    stdin: $summarize.json    approval: required  - id: deliver    command: market-intel deliver --execute    stdin: $summarize.json    condition: $approve.approved

推奨されるプリフライトチェック:

ブラウザーの可用性とプロファイルの選択。たとえば、管理された状態には openclaw、サインイン済みの Chrome セッションが必要な場合は user を使用します。ブラウザーを参照してください。
各ソースの API 認証情報とクォータ。
必要なエンドポイントへのネットワーク到達性。
lobster、browser、llm-task など、エージェントで必要なツールが有効になっていること。
プリフライト失敗が可視化されるように、cron の失敗送信先が設定されていること。スケジュール済みタスクを参照してください。

収集された各項目に推奨されるデータ出所フィールド:

json

{  "sourceUrl": "https://example.com/report",  "retrievedAt": "2026-04-24T12:00:00Z",  "asOf": "2026-04-24",  "title": "Example report",  "content": "..."}

要約の前に、ワークフローで古い項目を拒否または古いものとしてマークしてください。LLM ステップには構造化 JSON のみを渡し、出力で sourceUrl、retrievedAt、asOf を保持するよう依頼する必要があります。ワークフロー内でスキーマ検証済みのモデルステップが必要な場合は、LLM Task を使用します。

再利用可能なチームまたはコミュニティ向けワークフローでは、CLI、.lobster ファイル、セットアップメモを Skills または Plugin としてパッケージ化し、ClawHub を通じて公開します。Plugin API に必要な汎用機能が欠けている場合を除き、ワークフロー固有のガードレールはそのパッケージ内に保持します。

同期モード

管理モード

Task Flow がライフサイクルをエンドツーエンドで所有します。フローステップとしてタスクを作成し、完了まで進め、フロー状態を自動的に進行させます。

例: （1）データを収集し、（2）レポートを生成し、（3）配信する週次レポートフロー。Task Flow は各ステップをバックグラウンドタスクとして作成し、完了を待ってから次のステップに進みます。

Code

Flow: weekly-report  Step 1: gather-data     → task created → succeeded  Step 2: generate-report → task created → succeeded  Step 3: deliver         → task created → running

ミラーモード

Task Flow は外部で作成されたタスクを監視し、タスク作成の所有権を持たずにフロー状態を同期します。これは、タスクが cron ジョブ、CLI コマンド、その他のソースから生成され、それらの進捗をフローとして統一的に表示したい場合に便利です。

例: 3つの独立した cron ジョブが合わさって「morning ops」ルーチンを形成する場合。ミラーされたフローは、それらがいつ、どのように実行されるかを制御せずに、全体の進捗を追跡します。

永続状態とリビジョン追跡

各フローは独自の状態を永続化し、リビジョンを追跡するため、Gateway の再起動後も進捗が維持されます。リビジョン追跡により、複数のソースが同じフローを同時に進めようとした場合の競合検出が可能になります。フローレジストリは SQLite を使用し、長時間稼働する Gateway が無制限の registry.sqlite-wal サイドカーファイルを保持しないように、定期チェックポイントとシャットダウン時チェックポイントを含む、制限付きの write-ahead-log メンテナンスを行います。

キャンセル動作

openclaw tasks flow cancel は、フローに固定的なキャンセル意図を設定します。フロー内のアクティブなタスクはキャンセルされ、新しいステップは開始されません。キャンセル意図は再起動後も保持されるため、すべての子タスクが終了する前に Gateway が再起動しても、キャンセルされたフローはキャンセルされたままになります。

CLI コマンド