---
read_when:
    - タスクフローとバックグラウンドタスクの関係を理解したい
    - リリースノートやドキュメントで TaskFlow または openclaw tasks flow に遭遇する
    - 永続的なフロー状態を確認または管理したい
summary: バックグラウンドタスク上位のタスクフローオーケストレーションレイヤー
title: タスクフロー
x-i18n:
    generated_at: "2026-07-02T07:58:58Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: e4f5ff3c9a68eb0408a180bc947a03b410568d7914cb1c1d7f31d6013e036096
    source_path: automation/taskflow.md
    workflow: 16
---

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

## Task Flow を使う場面

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

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

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

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

1. タイミングには[スケジュール済みタスク](/ja-JP/automation/cron-jobs)を使用します。
2. ワークフローが以前のコンテキストを基に進むべき場合は、永続的な cron セッションを使用します。
3. 決定論的なステップ、承認ゲート、再開トークンには [Lobster](/ja-JP/tools/lobster) を使用します。
4. 子タスク、待機、再試行、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-brief
steps:
  - 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` を使用します。[ブラウザー](/ja-JP/tools/browser)を参照してください。
- 各ソースの API 認証情報とクォータ。
- 必要なエンドポイントへのネットワーク到達性。
- `lobster`、`browser`、`llm-task` など、エージェントで必要なツールが有効になっていること。
- プリフライト失敗が可視化されるように、cron の失敗送信先が設定されていること。[スケジュール済みタスク](/ja-JP/automation/cron-jobs#delivery-and-output)を参照してください。

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

```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](/ja-JP/tools/llm-task) を使用します。

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

## 同期モード

### 管理モード

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

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

```
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 コマンド

```bash
# List active and recent flows
openclaw tasks flow list

# Show details for a specific flow
openclaw tasks flow show <lookup>

# Cancel a running flow and its active tasks
openclaw tasks flow cancel <lookup>
```

| コマンド                           | 説明                                   |
| --------------------------------- | --------------------------------------------- |
| `openclaw tasks flow list`        | 状態と同期モード付きで追跡中のフローを表示します |
| `openclaw tasks flow show <id>`   | フロー ID または検索キーで1つのフローを調べます     |
| `openclaw tasks flow cancel <id>` | 実行中のフローとそのアクティブなタスクをキャンセルします    |

## フローとタスクの関係

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

## 関連

- [バックグラウンドタスク](/ja-JP/automation/tasks) — フローが調整する、切り離された作業台帳
- [CLI: tasks](/ja-JP/cli/tasks) — `openclaw tasks flow` の CLI コマンドリファレンス
- [自動化の概要](/ja-JP/automation) — すべての自動化メカニズムの概観
- [Cron ジョブ](/ja-JP/automation/cron-jobs) — フローに入力される可能性があるスケジュール済みジョブ