Automation

タスクフロー

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

Task Flow を使うタイミング

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

シナリオ	使用
単一のバックグラウンドジョブ	通常のタスク
複数ステップのパイプライン (A then B then C)	Task Flow (managed)
外部で作成されたタスクを監視する	Task Flow (mirrored)
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 を使用します。Browser を参照してください。
各ソースの 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 ファイル、セットアップメモを skill または plugin としてパッケージ化し、ClawHub を通じて公開します。plugin API に必要な汎用機能が欠けている場合を除き、ワークフロー固有のガードレールはそのパッケージ内に保持します。

同期モード

managed モード

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

mirrored モード

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

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

耐久性のある状態とリビジョン追跡

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

キャンセル動作

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

CLI コマンド