差分

このページの2つのバージョン間の差分を表示します。

--- ai:openclaw:cron [2026/02/21 16:44] – [指定時間にメッセージが来ない問題] oga
+++ ai:openclaw:cron [2026/02/22 16:34] (現在) – [指定時間にメッセージが来ない問題] oga
@@ 行 2: / 行 2: @@
 Cronや Heartbeat は、エージェントが独立して自律的に動作するための仕組みです。
+この仕組みがあるので、OpenClaw は自律的な動作が可能です。
+特に何も指示をしていなくても、おすすめの情報を見つけたときに OpenClaw の方から話しかけてくるような行動を取ることがあります。
-Heartbeat は定期的に起動し、workspace 内の HEARTBEAT.md を実行します。
+  * Heartbeat
-デフォルトでは 30分です。
+    * Heartbeat は定期的に起動し、workspace 内の HEARTBEAT.md を実行します。この間隔はデフォルトでは 30分です。
-継続的に実行する必要があるがあまり時間に厳密である必要がない場合は Heartbeat が使われます。
+    * 継続的に実行する必要があるがあまり時間に厳密である必要がない場合は Heartbeat が使われます。
-HEATBEAT.md の中身が空の場合は何もしません。
+    * HEATBEAT.md の中身が空の場合は何もしません。
-厳密に指定時間に実行して欲しい処理に対応するのが Cron です。
+  * Cron
-こちらは指定時間になったらジョブが起動し、登録されているプロンプトを実行します。
+    * 厳密に指定時間に実行して欲しい処理に対応するのが Cron です。
+    * こちらは指定時間になったらジョブが起動し、登録されているプロンプトを実行します。
   * [[https://docs.openclaw.ai/automation/cron-vs-heartbeat]]
@@ 行 16: / 行 19: @@
 いずれもバックグラウンドで何らかのタスクを走らせることが目的です。
 そのため必ずしも実行結果が Slack, Discord 等のチャンネルに報告されるとは限りません。
+もし DM 等で報告が欲しい場合は、明確にメッセージを送信するよう指示を出しておくことが大切です。
-もしこれらのチャンネルに DM 等で報告が欲しい場合は、明確にメッセージを送信するよう指示を出しておくことが重要となります。
-===== ジョブの登録 =====
+===== 明示的なジョブの登録 =====
-エージェントに対して定期的に、または指定した日時になったら行って欲しい指示を出すと自分でこれらのタスクを登録してくれます。
+エージェントに対して定期的に、または指定した日時になったら行って欲しい旨の指示を出すと、エージェントがこれらのタスクを自分で登録してくれます。
 Cron と Heartbeat のどちらが使われるかもエージェントが自分で判断します。
@@ 行 29: / 行 32: @@
 ===== 指定時間にメッセージが来ない問題 =====
-例えば毎日指定時間になったら、何らかのメッセージを送るように指示を出したとします。
+指定時間に何らかのメッセージを送るように指示を出しても、メッセージには何の報告も送られてこない場合があります。
-ですがなんの報告も送られてこない場合があります。
-もともとバックグラウンドで LLM によるタスクを実行するための機能なので、必ずしも明確なアウトプットが行われるとは限りません。
+=== 解決方法 ===
-例えば定期的にバックグラウンドでファイルを整理を行わせるなど、出力が不要なケースもあるからです。
+  * 出力に対する明確な指示を出しておく。ファイルに保存させたり DM として誰あてにメッセージを送るように指示を出す。
+    * プロンプト (payload.message) だけでなく、''~/.openclaw/cron/jobs.json'' の "delivery" が定義されているかも確認してみてください。
+  * 軽量版モデルやパラメータ数が少ないモデルを使ってる場合は、上位モデルやパラメータ数が多いモデルに切り替える。
+    * これで報告の問題があっさり解決する場合があります。
+  * OpenClaw を更新する
+    * ''openclaw update'' コマンドで最新版に更新してください。古い初期のバージョンでは Cron がきちんと動作しない場合があります。
-よって定期的にネットで情報収集するように指示を出しても、バックグランドで情報収集するだけで終わってしまう可能性があります。
-よってジョブ登録する場合に、結果をファイルに保存させたりチャットに結果を送信させたりといった**出力に対する明確な指示**が必要です。
-また単純に LLM の能力不足の可能性もあります。
+===== Cron ジョブの設定の確認 =====
-mini, flash, haiku などの軽量モデルや、パラメータ数が少ない Local LLM を使用している場合に意図した結果にならない場合があります。
-この場合は上位モデルや、よりパラメータ数が多いモデルを使うことであっさり解決する可能性があります。
-==== 解決する方法などまとめ ====
+''openclaw cron list --all'' コマンドで、登録されている cron ジョブの一覧を確認することができます。
+もしくはチャットから確認したい場合はエージェントに尋ねるとおそらく答えてくれます。
-  * 出力に対する明確な指示を出しておく。ファイルに保存させたり DM として誰あてにメッセージを送るように指示を出すなど。
-  * 軽量モデル、パラメータ数が少ないモデルを使ってる場合は、上位モデルやパラメータ数が多いモデルに切り替えてみる。
-  * OpenClaw を更新する。''openclaw update'' コマンドで最新版に更新してください。それでもきちんと動作しない場合は古いバージョンのバグの可能性もあります。
+Cron ジョブには isolated モードと main モードの 2種類があります。
+先程のバックグラウンドで実行されるジョブは isolated になります。
+main モードはチャットへの割り込みが発生するため推奨は isolated になっています。
+もし直接ジョブの設定ファイルを確認したい場合は ''~/.openclaw/cron/jobs.json'' を参照してください。
+===== Heartbeat 時間の変更 =====
+おそらくエージェントに直接指示しても設定できると思いますが、''agents.defaults.heartbeat.every'' で時間の変更できます。
+<code javascript>
+  "agents": {
+    "defaults": {
+      "heartbeat": {
+        "every": "30m",
+        "target": "last"
+      },
+     }
+   }
+</code>
-===== Cron ジョブの設定の確認 =====