Skip to main content
OpenClaw は、タスク、スケジュール済みジョブ、イベントフック、 および常設指示を通じてバックグラウンドで処理を実行します。このページを使用して、適切な仕組みを選択してください。

​
クイック判断ガイド

​
スケジュール済みタスク（Cron）と Heartbeat の比較

正確な時刻または分離された実行が必要な場合は、スケジュール済みタスク（Cron）を使用します。完全なセッションコンテキストが役立ち、おおよそのタイミングで問題ない場合は、Heartbeat を使用します。

​
基本概念

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

Cron は、正確なタイミングを実現する Gateway 組み込みのスケジューラーです。ジョブを永続化し、適切な時刻にエージェントを起動し、出力をチャットチャンネルまたは Webhook エンドポイントへ配信できます。単発のリマインダー、繰り返し式、および受信 Webhook トリガーをサポートします。 スケジュール済みタスクを参照してください。

​
タスク

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

​
タスクフロー

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

​
常設指示

常設指示は、定義されたプログラムに対する恒久的な運用権限をエージェントに付与します。ワークスペースファイル（通常は AGENTS.md）に保存され、すべてのセッションに注入されます。時間に基づく適用には cron と組み合わせてください。 常設指示を参照してください。

​
フック

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

​
Heartbeat

Heartbeat は、メインセッションで定期的に行われるターンです（デフォルトでは 30 分ごと）。チェックリスト形式の監視（受信トレイ、カレンダー、通知）を、完全なセッションコンテキストを使用して 1 回のエージェントターンにまとめます。Heartbeat ターンはタスクレコードを作成せず、日次またはアイドル時のセッションリセットの鮮度を延長しません。Heartbeat のスクラッチは小さなプロンプトコンテキストです。繰り返し実行する作業は cron ジョブとしてスケジュールしてください。Heartbeat のスクラッチが空の場合は、empty-heartbeat-file としてスキップされます。cron の作業が実行中またはキューに入っている間、Heartbeat は延期されます。また、同じエージェントのセッションキーに紐づくサブエージェントまたはネストされたレーンが処理中の場合、heartbeat.skipWhenBusy によってそのエージェントを延期することもできます。 Heartbeatを参照してください。

​
各機能の連携

  • Cron は、正確なスケジュール（日次レポート、週次レビュー）と単発のリマインダーを処理します。すべての cron 実行でタスクレコードが作成されます。
  • Heartbeat は、30 分ごとにまとめられた 1 つの監視チェックリストを処理します。独立した間隔が必要な確認処理は cron が担当します。
  • フック は、特定のイベント（セッションのリセット、Compaction、メッセージフロー）にカスタムスクリプトで反応します。Plugin フックはツール呼び出しを対象とします。
  • 常設指示 は、エージェントに永続的なコンテキストと権限の境界を与えます。
  • タスクフロー は、個々のタスクの上位で複数ステップのフローを調整します。
  • タスク は、すべての切り離された作業を自動的に追跡し、確認および監査できるようにします。

​
関連項目