name: cron-management description: Clawdbotのcronジョブを安全に作成・更新・管理するスキル。JSONパースエラーを防ぐためのテンプレートとバリデーション手順を含む。「cron追加」「cronジョブ設定」「定期実行」「スケジュール設定」「タスク監視cron」「リマインダー設定」などの作業に使う。

Cron Management スキル

重要: JSON構文エラー防止

cronジョブのpayloadはJSON形式。構文エラーで行動不能になるリスクがある。 必ずこのスキルのテンプレートに従うこと。

重要: Codex / launchd cutover 後の確認先

2026-03 以降、cron 実行モードは複数ある。

ジョブ定義の正本: ~/.openclaw/cron/jobs.json
OpenClaw native scheduler: openclaw cron status / openclaw cron list
Codex launchd 実体: ~/Library/LaunchAgents/com.openclaw.codex.cron.*.plist
重要 5 本の mode 切替: ~/.openclaw/scripts/set-critical-cron-mode.sh

openclaw cron list が enabled でも、Codex launchd が同時に載っていると二重実行になる。重要ジョブの切替時は、必ず set-critical-cron-mode.sh で scheduler 側も揃える。

Codex cron wrapper で動くジョブでは message(...) ツールは使えない。 Slack 通知が必要なときは /Users/satokeita/.openclaw/scripts/codex-slack-notify.sh を使う。

OpenClaw セッションで使う message(...) 例は、その環境限定の例。 Codex cron では必ず helper 呼び出しへ翻訳する。

cron tool のパラメータ一覧

add / update / remove の各アクションのJSON形式、スケジュール種類（cron式・at・every）、セッション種類の詳細は以下を参照:

→ references/api-parameters.md

配信先テンプレート

Slack配信、Codex cron配信、配信なしの各パターンとチャンネルID一覧:

→ references/delivery-templates.md

最重要ルール: Slack投稿時の送信先指定

OpenClaw セッションで Slack 投稿を行う場合、必ず以下の形式をプロンプト内に明記すること:

message({
  action: "send",
  target: "channel:XXXXXXXXX",  // ← 必須！省略禁止！
  message: "投稿内容"
})

なぜ必要か:

target未指定だと「Action send requires a target」エラーになる
delivery.mode: "announce" に頼ると意図しないスレッドに投稿される
2026-02-22 この問題で複数のcronジョブが5日間エラーを起こした

Codex cron ではこの message(...) 例を、そのまま helper 呼び出しに置き換える。

チャンネルID一覧:

C08KHA4BQHW → #claude連携
C0ACUDZCJJC → #stevens
C0AELF58Z5E → #tifa
C0ABPLBL04X → #nemo
C0AKJDLS8HE → #robin

既知の問題: tool_use.name 200文字制限エラー

詳細（症状・原因・対処法）:

→ references/known-issues.md

delivery設定の必須ルール

isolated セッションでは delivery.mode: "announce" + channel: "last" がエラーになる。正しいパターンとチェックリスト:

→ references/delivery-rules.md

定期報告のスレッド指定ルール

特定スレッドへの返信が必要なcronジョブの設定方法。threadId の埋め込みパターンとスレッドID一覧:

→ references/thread-rules.md

スキル読み込み指示の必須ルール

cronメッセージでスキルファイルを参照する場合の書き方。read 明示指示の必須ブロックとチェックリスト:

→ references/skill-read-rules.md

その他の必須ルール

messageフィールドは短く保つ — 長文の指示はスキルやファイルに外出しし、messageでは「〜スキルを読んで実行して」と書く
messageに改行を含める場合は \n を使う — 生の改行もJSON的には許容されるが、ツールパラメータでは \n エスケープが安全
JSONの末尾カンマを入れない — { "a": 1, } はエラー
文字列内のダブルクォートは \" でエスケープ — "message": "He said \"hello\""
数値・真偽値にクォートをつけない — "deliver": true（○）、"deliver": "true"（×）
cronジョブ追加前に cron list で既存ジョブを確認 — 重複防止

監視cronのパターン

バックグラウンドタスクを監視する一時cronの定型パターン。テンプレート:

→ references/example-monitor-cron.json

完了検知後は必ず cron remove で監視ジョブを削除すること。

よくある落とし穴

delivery.to 未設定で sessionTarget: "isolated": isolated セッションには「前回のチャンネル」が存在しないため、delivery.mode: "announce" + channel: "last" の組み合わせは cron delivery target is missing エラーになる。必ず delivery.to = "slack:CHANNEL_ID" を明示するか、delivery.mode: "none" でプロンプト内の message tool で投稿する
JSON パースエラー: payload は JSON 形式のため、末尾カンマ { "a": 1, }、文字列内の未エスケープダブルクォート、数値・真偽値への不要なクォート等で構文エラーになる。必ずこのスキルのテンプレートをコピーして編集すること
スキルファイルを read せずに実行: cron メッセージに「スキル: path」と書いても、エージェントが実際にファイルを read せず「知っている内容」で実行してしまう。▶ まず read <path> してから実行 と明示指示を書く
スレッド返信先の未指定: 定期報告が特定スレッドに返信すべきなのに、メインチャンネルに単発投稿してしまう。cron の payload.message に具体的な threadId（ts値）を仕組みとして埋め込む
Codex cron で message(...) を使う: Codex cron wrapper では OpenClaw の message(...) ツールは使えない。Slack 通知には codex-slack-notify.sh ヘルパーを使う
OpenClaw と Codex launchd の二重実行: openclaw cron list が enabled でも、Codex launchd が同時に載っていると同じジョブが二重実行される。重要ジョブの切替時は set-critical-cron-mode.sh で scheduler 側も揃える