WeCom Reminder Skill

Create scheduled reminder tasks that reliably deliver messages to WeCom (Enterprise WeChat).

Problem Context

When creating cron tasks through natural language in WeCom, tasks may execute (status: ok) but fail to deliver messages because of missing delivery configuration parameters.

Solution

Always use the complete openclaw cron add command with all delivery parameters.

Command Template

openclaw cron add \
  --name '<task-name>' \
  --cron '<cron-expression>' \
  --tz 'Asia/Shanghai' \
  --session isolated \
  --agent default \
  --message '<reminder-message>' \
  --deliver \
  --channel wecom \
  --to wangrui

Required Parameters

• •--name: Descriptive task name (e.g., "每日报告提醒")
• •--cron: Cron expression (e.g., "50 8 * * *" for daily 8:50 AM)
• •--tz: Timezone, always use 'Asia/Shanghai' for Beijing time
• •--session isolated: Use isolated session to avoid interfering with main session
• •--agent default: Use default agent (NOT main)
• •--message: The reminder message text
• •--deliver: Critical - Enables message delivery
• •--channel wecom: Specifies WeCom as the delivery channel
• •--to wangrui: Recipient username

Cron Expression Guide

Common patterns:

• •Daily at specific time: M H * * * (e.g., 50 8 * * * = 8:50 AM daily)
• •Weekdays only: M H * * 1-5 (e.g., 0 9 * * 1-5 = 9:00 AM Mon-Fri)
• •Specific days: M H * * 1,3,5 (e.g., 30 14 * * 1,3,5 = 2:30 PM Mon/Wed/Fri)
• •Multiple times: 0 9,14,18 * * * (9 AM, 2 PM, 6 PM daily)

Format: minute hour day month weekday

• •minute: 0-59
• •hour: 0-23 (24-hour format)
• •day: 1-31
• •month: 1-12
• •weekday: 0-7 (0 and 7 are Sunday)

Usage Workflow

When a user requests a reminder:

1. •

   Parse the request to extract:

   • •What to remind about (message)
   • •When to remind (cron schedule)
2. •

   Construct the command using the template above with extracted values

3. •

   Execute the command via the Bash tool

4. •

   Confirm with the user that the task was created and when it will run

Examples

User request: "每天早上9点提醒我开会"

Extract:

• •Message: "⏰ 开会时间到了！"
• •Schedule: "0 9 * * *"

Command:

openclaw cron add \
  --name '每日开会提醒' \
  --cron '0 9 * * *' \
  --tz 'Asia/Shanghai' \
  --session isolated \
  --agent default \
  --message '⏰ 开会时间到了！' \
  --deliver \
  --channel wecom \
  --to wangrui

User request: "工作日下午5点半提醒我下班"

Extract:

• •Message: "⏰ 该下班了！"
• •Schedule: "30 17 * * 1-5"

Command:

openclaw cron add \
  --name '下班提醒' \
  --cron '30 17 * * 1-5' \
  --tz 'Asia/Shanghai' \
  --session isolated \
  --agent default \
  --message '⏰ 该下班了！' \
  --deliver \
  --channel wecom \
  --to wangrui

What NOT to Do

❌ Never create tasks without --deliver --channel wecom --to wangrui ❌ Never use --agent main (use --agent default instead) ❌ Never use --session main (use --session isolated instead)

Verification

After creating a task, verify it was created correctly:

openclaw cron list --json | grep -A20 '<task-id>'

Check that the JSON includes:

"payload": {
  "deliver": true,
  "channel": "wecom",
  "to": "wangrui"
}

Troubleshooting

If messages aren't being delivered:

1. •Check task status: openclaw cron list
2. •Verify deliver config: openclaw cron list --json | grep -A20 '<task-id>'
3. •Check gateway logs: tail -100 /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log