Automation

タスクフロー

Task Flow は、バックグラウンドタスクの上位に位置するオーケストレーションレイヤーです。フローは、独自のステータス、JSON 状態、リビジョンカウンター、リンクされたタスクレコードを持つ、複数ステップの作業を永続的に記録するものです。フローは Gateway の再起動後も維持されます。個々のタスクは、引き続き切り離された作業の単位です。

Task Flow を使用する場合

シナリオ	使用するもの
単一のバックグラウンドジョブ	通常のタスク
Plugin コードで駆動する複数ステップのパイプライン	Task Flow（管理モード）
切り離された ACP またはサブエージェントの起動	Task Flow（ミラーモード、自動作成）
1 回限りのリマインダー	Cron ジョブ

同期モード

管理モード

管理対象フローにはコントローラーがあります。これは、目標と必須のコントローラー ID を指定して Plugin ランタイムの Task Flow API からフローを作成し、その後フローを明示的に駆動する Plugin コードです。

各ステップはフロー配下に作成されたバックグラウンドタスクとして実行され、フローの所有者キーとリクエスターのオリジンが子タスクに引き継がれます。
コントローラーはフローを running、waiting、終了状態の間で進行させ、任意の JSON ステップ状態をフローレコードに保存します。
すべての変更操作で、フローの期待リビジョンを渡します。古い書き込みは新しい状態を上書きせず、リビジョン競合として拒否されます。
キャンセルが要求されると、新しい子タスクは拒否され、アクティブな子タスクがなくなった時点でフローは cancelled として終了します。

例：（1）データを収集し、（2）レポートを生成し、（3）配信する週次レポートフロー。各ステップにつき 1 つのバックグラウンドタスクを使用します。

Code

フロー: weekly-report  ステップ 1: gather-data     → タスク作成 → 成功  ステップ 2: generate-report → タスク作成 → 成功  ステップ 3: deliver         → タスク作成 → 実行中

ミラーモード

切り離された ACP またはサブエージェントの実行が開始されると（配信可能な完了結果を持つセッションスコープのタスク）、OpenClaw はミラー化された単一タスクのフローを自動的に作成します。フローレコードは、単一の基盤タスクのステータス、目標、タイミングを反映します。これにより、切り離された起動はコントローラーなしでも、ステータス確認や再試行のための安定したフローハンドルを取得できます。ミラーフローの同期モードは CLI で task_mirrored と表示されます。

フローのステータス

ステータス	意味
`queued`	作成済み、まだ進行していない
`running`	フローが進行中
`waiting`	管理対象フローが待機メタデータ（タイマー、外部イベント）で一時停止している
`blocked`	ステップが使用可能な結果なしで終了した。詳細は `blockedTaskId`/概要に示される
`succeeded`	正常に完了
`failed`	エラーで完了
`cancelled`	キャンセルが要求され、すべての子タスクが完了した
`lost`	フローが信頼できる基盤状態を失った

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

フローレコードはタスクレコードとともに共有 SQLite 状態データベース（~/.openclaw/state/openclaw.sqlite、flow_runs テーブル）に永続化されるため、Gateway の再起動後も進行状況が維持されます。書き込みのたびにフローの revision が増加します。古い期待リビジョンを渡した同時書き込み処理では競合が発生し、再読み込みが必要です。WAL の増加は SQLite の自動チェックポイントと定期的なパッシブチェックポイントによって制限され、シャットダウン時には truncate チェックポイントが実行されます。以前のインストールで使用されていた従来の flows/registry.sqlite サイドカーは、openclaw doctor によってインポートされます。

キャンセル時の動作

openclaw tasks flow cancel はフローに永続的なキャンセル意図を設定し、アクティブな子タスクをキャンセルして、新しい管理対象の子タスクを拒否します。アクティブな子タスクがなくなると、フローは cancelled として終了します。これは即時に行われるか、子タスクの完了に時間がかかる場合はメンテナンススイープによって行われます。この意図は永続化されるため、すべての子タスクが終了する前に Gateway が再起動しても、キャンセルされたフローはキャンセル状態のままです。

CLI コマンド

bash

# アクティブなフローと最近のフローを一覧表示openclaw tasks flow list [--status <status>] [--json] # 特定のフローの詳細を表示openclaw tasks flow show <lookup> [--json] # 実行中のフローとそのアクティブなタスクをキャンセルopenclaw tasks flow cancel <lookup>

コマンド	説明
`openclaw tasks flow list`	同期モード、ステータス、リビジョン、コントローラー、タスク数を含む追跡対象フロー
`openclaw tasks flow show <id>`	フロー ID または所有者キーで、リンクされたタスクを含む 1 つのフローを調査
`openclaw tasks flow cancel <id>`	実行中のフローとそのアクティブなタスクをキャンセル

フローは openclaw tasks audit（古い、または破損したフローの検出）と openclaw tasks maintenance（停止したキャンセル処理を完了し、7 日後に終了済みフローを削除）の対象にもなります。

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

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

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

Cron の構成例：

bash

openclaw cron add \  --name "市場情報ブリーフ" \  --cron "0 7 * * 1-5" \  --tz "America/New_York" \  --session session:market-intel \  --message "market-intel Lobster ワークフローを実行してください。要約する前にソースの鮮度を確認してください。" \  --announce \  --channel slack \  --to "channel:C1234567890"

定期的なワークフローで意図的な履歴、前回実行の概要、または継続的なコンテキストが必要な場合は、isolated ではなく --session 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": "レポート例",  "content": "..."}

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

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

フローとタスクの関係

フローはタスクを置き換えるのではなく、調整します。1 つのフローは、その存続期間中に複数のバックグラウンドタスクを駆動できます。個々のタスクレコードを調査するには openclaw tasks、オーケストレーションを行うフローを調査するには openclaw tasks flow を使用します。