Task Supervisor

Task Supervisor

Manage long-running tasks with checkpoints, progress files, and periodic WhatsApp reports.

Is This a Large Task?

Before doing anything else, mentally check:

If not large → respond normally, skip task files and crons entirely.

On Task Start

When you receive a large task, immediately:

1. Create a task file at .tasks/<TASK-SLUG>.md (use kebab-case slug)
2. Decompose the task into numbered steps
3. Spawn a reporter cron to send progress updates
4. Begin execution, updating the file after each step

Task File Format

# Task: <Title>

**Started**: <ISO timestamp>
**Status**: in_progress | paused | done | failed
**Estimated Steps**: N
**Last Updated**: <ISO timestamp>

## Steps

- [ ] 1. First step
- [ ] 2. Second step
- [x] 3. Completed step ✓ (2026-03-02T22:05:00+08:00)
- [!] 4. Failed step — <error summary>

## Log

### Step 3 — 2026-03-02T22:05:00+08:00
Result or notes here.

### Error — 2026-03-02T22:07:00+08:00
What failed and how it was handled.

## Result

(Fill when done — final summary for the user)

During Execution

After every step (success or failure):

• Update the checkbox in Steps ([x] done, [!] failed)
• Append a Log entry with timestamp and key findings
• Update Last Updated timestamp

On failure:

• Mark step [!] with error summary
• Try an alternative approach if obvious
• If truly stuck, set Status to paused and note what's needed

Progress Reporting (Cron)

At task start, spawn a cron reporter using exec:

openclaw cron add "task-report-<SLUG>" \
  --schedule "*/15 * * * *" \
  --message "Read .tasks/<SLUG>.md and send a Feishu message to the user with progress update. Include: completed steps, current step, blockers if any. Keep it under 5 sentences. Remove this cron when Status=done or Status=failed." \
  --once-complete

Adjust interval based on task scope:

• Quick task (<30 min): every 10 min
• Medium task (30 min–2 hr): every 15 min
• Long task (>2 hr): every 30 min

On Task Completion

1. Fill in ## Result section with a clear summary
2. Set Status: done
3. Send a final Feishu message: task name, what was accomplished, any caveats
4. Remove the progress cron

On Task Failure / Getting Stuck

1. Set Status: paused
2. Document exactly what was tried and what's blocked
3. Send Feishu message alert immediately (don't wait for cron)
4. Do NOT silently stop — always notify

Resuming a Paused Task

When asked to continue a task:

1. Read .tasks/<SLUG>.md
2. Find the last completed step
3. Continue from there
4. Re-spawn reporter cron if needed

Multi-Task Awareness

If multiple tasks are running, maintain separate files per task. On heartbeat, check .tasks/ for any in_progress tasks and include a brief status in heartbeat responses.

Quick Reference