Automation

自動化

OpenClawは、タスク、スケジュール済みジョブ、推論されたコミットメント、イベントフック、Standing Ordersを通じてバックグラウンドで作業を実行します。このページでは、適切な仕組みを選び、それらがどのように連携するかを理解できます。

クイック判断ガイド

flowchart TD
    START([何が必要ですか？]) --> Q1{作業をスケジュールする？}
    START --> Q2{切り離された作業を追跡する？}
    START --> Q3{複数ステップのフローをオーケストレーションする？}
    START --> Q4{ライフサイクルイベントに反応する？}
    START --> Q5{エージェントに永続的な指示を与える？}
    START --> Q6{自然なフォローアップを記憶する？}

    Q1 -->|はい| Q1a{正確なタイミングか柔軟なタイミングか？}
    Q1a -->|正確| CRON["Scheduled Tasks (Cron)"]
    Q1a -->|柔軟| HEARTBEAT[Heartbeat]

    Q2 -->|はい| TASKS[Background Tasks]
    Q3 -->|はい| FLOW[Task Flow]
    Q4 -->|はい| HOOKS[Hooks]
    Q5 -->|はい| SO[Standing Orders]
    Q6 -->|はい| COMMITMENTS[Inferred Commitments]

ユースケース	推奨	理由
毎日午前9時ちょうどにレポートを送信する	Scheduled Tasks (Cron)	正確なタイミング、分離された実行
20分後にリマインドする	Scheduled Tasks (Cron)	正確なタイミングの単発実行（`--at`）
毎週の詳細分析を実行する	Scheduled Tasks (Cron)	独立したタスクで、別のモデルも使用可能
30分ごとに受信箱を確認する	Heartbeat	他の確認とまとめて処理でき、コンテキストを考慮
予定表で近づいているイベントを監視する	Heartbeat	定期的な認識に自然に適合
言及された面接の後に確認する	Inferred Commitments	メモリのようなフォローアップで、正確なリマインダー要求ではない
ユーザーコンテキストの後に軽いケア確認をする	Inferred Commitments	同じエージェントとチャンネルにスコープされる
サブエージェントまたはACP実行の状態を調べる	Background Tasks	タスク台帳がすべての切り離された作業を追跡する
何がいつ実行されたかを監査する	Background Tasks	`openclaw tasks list` と `openclaw tasks audit`
複数ステップの調査後に要約する	Task Flow	リビジョン追跡付きの耐久的なオーケストレーション
セッションリセット時にスクリプトを実行する	Hooks	イベント駆動で、ライフサイクルイベント時に発火
すべてのツール呼び出しでコードを実行する	Plugin hooks	インプロセスフックがツール呼び出しをインターセプトできる
返信前に常にコンプライアンスを確認する	Standing Orders	すべてのセッションに自動的に注入される

Scheduled Tasks (Cron) と Heartbeat

観点	Scheduled Tasks (Cron)	Heartbeat
タイミング	正確（cron式、単発）	おおよそ（デフォルトは30分ごと）
セッションコンテキスト	新規（分離）または共有	メインセッションの完全なコンテキスト
タスクレコード	常に作成される	作成されない
配信	チャンネル、webhook、または無音	メインセッション内にインライン
最適な用途	レポート、リマインダー、バックグラウンドジョブ	受信箱確認、予定表、通知

正確なタイミングや分離された実行が必要な場合はScheduled Tasks (Cron)を使用します。完全なセッションコンテキストが役立ち、おおよそのタイミングで十分な場合はHeartbeatを使用します。

コア概念

スケジュール済みタスク（cron）

Cronは、正確なタイミングのためのGateway組み込みスケジューラーです。ジョブを永続化し、適切な時刻にエージェントを起動し、出力をチャットチャンネルまたはwebhookエンドポイントに配信できます。単発リマインダー、繰り返し式、インバウンドwebhookトリガーをサポートします。

Scheduled Tasksを参照してください。

タスク

バックグラウンドタスク台帳は、すべての切り離された作業を追跡します。ACP実行、サブエージェントの起動、分離されたcron実行、CLI操作が含まれます。タスクはレコードであり、スケジューラーではありません。確認にはopenclaw tasks listとopenclaw tasks auditを使用します。

Background Tasksを参照してください。

推論されたコミットメント

コミットメントは、オプトインの短命なフォローアップメモリです。OpenClawは通常の会話からそれらを推論し、同じエージェントとチャンネルにスコープし、期限になった確認をheartbeat経由で配信します。ユーザーが正確に要求したリマインダーは引き続きcronの担当です。

Inferred Commitmentsを参照してください。

Task Flow

Task Flowは、バックグラウンドタスクの上にあるフローオーケストレーション基盤です。管理同期モードとミラー同期モード、リビジョン追跡、確認用のopenclaw tasks flow list|show|cancelを備えた耐久的な複数ステップフローを管理します。

Task Flowを参照してください。

Standing Orders

Standing Ordersは、定義されたプログラムに対してエージェントに恒久的な運用権限を付与します。これはワークスペースファイル（通常はAGENTS.md）に置かれ、すべてのセッションに注入されます。時間ベースの強制にはcronと組み合わせます。

Standing Ordersを参照してください。

Hooks

内部フックは、エージェントのライフサイクルイベント（/new、/reset、/stop）、セッションCompaction、Gateway起動、メッセージフローによってトリガーされるイベント駆動スクリプトです。ディレクトリから自動的に検出され、openclaw hooksで管理できます。インプロセスのツール呼び出しインターセプトには、Plugin hooksを使用します。

Hooksを参照してください。

Heartbeat

Heartbeatは、定期的なメインセッションのターンです（デフォルトは30分ごと）。複数の確認（受信箱、予定表、通知）を、完全なセッションコンテキストを持つ1回のエージェントターンにまとめます。Heartbeatのターンはタスクレコードを作成せず、日次またはアイドル時のセッションリセットの新鮮さを延長しません。小さなチェックリストにはHEARTBEAT.mdを使用し、heartbeat自体の中で期限到来時のみの定期確認を行いたい場合はtasks:ブロックを使用します。空のheartbeatファイルはempty-heartbeat-fileとしてスキップされ、期限到来時のみのタスクモードはno-tasks-dueとしてスキップされます。cron作業がアクティブまたはキューにある間、Heartbeatは延期されます。また、heartbeat.skipWhenBusyは、同じエージェントのセッションキー付きサブエージェントまたはネストされたレーンがビジーな間、そのエージェントを延期することもできます。

Heartbeatを参照してください。

連携の仕組み

Cronは、正確なスケジュール（日次レポート、週次レビュー）と単発リマインダーを処理します。すべてのcron実行はタスクレコードを作成します。
Heartbeatは、定期的な監視（受信箱、予定表、通知）を30分ごとの1回のまとめられたターンで処理します。
Hooksは、特定のイベント（セッションリセット、Compaction、メッセージフロー）にカスタムスクリプトで反応します。Plugin hooksはツール呼び出しを対象にします。
Standing ordersは、エージェントに永続的なコンテキストと権限の境界を与えます。
Task Flowは、個々のタスクの上で複数ステップのフローを調整します。
Tasksは、すべての切り離された作業を自動的に追跡し、確認と監査を可能にします。

自動化