One-time delayed tasks

MetaBot Scheduler

Persistent server-side scheduler. Use this when:

• The schedule needs to outlive the current Claude session.
• Another bot or operator may need to list, pause, or cancel it.
• You want it to run inside MetaBot's PM2 process (not Claude's).

For ad-hoc, session-scoped scheduling, prefer the Claude Code native tools CronCreate and /loop instead — they're faster, in-process, and need no MetaBot server call.

Quick Commands (metabot CLI)

The metabot CLI is pre-installed and handles auth automatically.

# One-time delayed tasks
metabot schedule list                                       # List all scheduled tasks
metabot schedule add <bot> <chatId> <delaySec> <prompt>     # Schedule a one-time future task
metabot schedule cancel <id>                                # Cancel a scheduled task

# Recurring (cron)
metabot schedule cron <bot> <chatId> '<cronExpr>' <prompt>  # Create recurring task
metabot schedule pause <id>                                 # Pause a recurring task
metabot schedule resume <id>                                # Resume a paused recurring task

Cron format: minute hour day month weekday (5 fields). Examples:

• 0 8 * * * → daily at 8am
• 0 8 * * 1-5 → weekdays at 8am
• */30 * * * *→ every 30 minutes Default timezone: Asia/Shanghai.

API Reference

Auth header: -H "Authorization: Bearer $METABOT_API_SECRET" Base URL: !echo http://localhost:${METABOT_API_PORT:-9100}

Create one-time scheduled task:

curl -s -X POST http://localhost:${METABOT_API_PORT:-9100}/api/schedule \
  -H "Authorization: Bearer $METABOT_API_SECRET" \