qqbot-remind-absolute

Manage QQBot reminders through real OpenClaw cron jobs with explicit per-user timezone settings. Use when a QQ user asks for reminders, alarms, timed notific...

Security Scan

The skill's files and runtime instructions are coherent with its purpose: it stores per-user timezones locally and uses the OpenClaw CLI to create real cron jobs for QQ reminders, and it does not request unrelated credentials or perform unexpected I/O.

Purpose & Capability

The name/description (QQBot reminders via OpenClaw cron jobs) matches the included script and SKILL.md: the script reads/writes a local timezone JSON and invokes the openclaw cron CLI to schedule, list, and remove jobs. Requiring an OpenClaw CLI is reasonable for this purpose.

Instruction Scope

SKILL.md instructs running the bundled script with clear flags; the script performs only the stated actions: manage data/user_timezones.json and call openclaw cron commands. It does not read arbitrary system files or access environment variables beyond normal process state.

Install Mechanism

No install spec or external downloads are present; the skill is instruction-only with one local Python script. Nothing is fetched from external URLs or written to unusual system paths by an installer.

Credentials

The skill declares no environment variables or credentials. The script invokes the local openclaw CLI (expected for scheduling) and stores timezones in a local JSON file; no unrelated secrets or services are requested.

Persistence & Privilege

always is false and the skill does not modify other skills or global agent settings. It persists only a small per-target timezone file under data/ and relies on OpenClaw cron for delivery, which is consistent with its stated function.

Assessment

This skill appears to do exactly what it says: maintain per-user timezones and create real OpenClaw cron jobs for QQ reminders. Before installing, ensure you trust the local openclaw binary (the script calls it via subprocess) and are comfortable with cron jobs being created under your OpenClaw environment. The skill stores timezones in data/user_timezones.json in cleartext and will schedule messages using the provided reminder text — verify you trust sources of reminder content so nothing sensitive is scheduled unintentionally. If you run on a non-Windows host, confirm openclaw is available under a name the script can find or adjust find_openclaw_cmd accordingly.

Use this skill for QQ reminder workflows.

Core rules

1. Do not promise reminders verbally. Always create or manage real cron jobs.
2. Before a user's first reminder is created, require an explicit timezone.
3. Store timezone per QQ target and allow later updates.
4. Parse reminder time locally, then convert it into either an absolute datetime or a cron expression.
5. Keep query and cancellation in the same skill.

Required flow

First-time reminder setup

If the user has never set a timezone, do not create the reminder yet. Ask them to explicitly provide one, for example:

• Asia/Shanghai
• Asia/Tokyo
• America/Los_Angeles

Then run:

• python scripts/schedule_reminder.py set-timezone --to "<qq-target>" --timezone "<IANA timezone>"

Change timezone later

Run:

• python scripts/schedule_reminder.py set-timezone --to "<qq-target>" --timezone "<IANA timezone>"

Check timezone

Run:

• python scripts/schedule_reminder.py get-timezone --to "<qq-target>"

Add reminders

Use one of these:

• One-shot absolute: python scripts/schedule_reminder.py add --content "抢票" --to "<qq-target>" --at "2026-04-22 21:30"
• One-shot natural language: python scripts/schedule_reminder.py add --content "喝水" --to "<qq-target>" --at "今晚11点"
• Relative: python scripts/schedule_reminder.py add --content "喝水" --to "<qq-target>" --in 5
• Recurring cron: python scripts/schedule_reminder.py add --content "打卡" --to "<qq-target>" --cron "0 8 * * *"
• Recurring Chinese phrase: python scripts/schedule_reminder.py add --content "喝水" --to "<qq-target>" --at "每天早上8点"

List reminders

Run:

• python scripts/schedule_reminder.py list --to "<qq-target>"

Remove reminders

Run:

• python scripts/schedule_reminder.py remove --id "<job-id>"

Time handling

The script supports:

• 21:30
• 21.30
• 21点30
• 今晚11点
• 明天早上8点
• 每天早上8点
• 工作日9点
• 周六晚上10点

The script stores timezone per target in data/user_timezones.json.

Reply style

Keep replies short and direct.

Examples:

• 先告诉我你的时区，例如 Asia/Shanghai，我再给你建提醒。
• ⏰ 好，今晚十一点提醒你。
• ⏰ 好，我会每天早上八点提醒你。
• ✅ 时区已经改成 Asia/Tokyo。
• 📋 这是你当前的提醒列表。
• ✅ 已帮你取消这个提醒。

Notes

• Delivery still relies on real openclaw cron jobs.
• Timezone is mandatory on first use because reminder meaning depends on the user's locale.
• Query and cancel are part of the same reminder system and should stay in this skill.