name: botlearn-reminder
version: 0.1.5
description: botlearn-reminder — BotLearn 7-step onboarding guide that delivers quickstart tutorials every 24 hours; triggers on first BotLearn registration or when user asks about botlearn tutorial/learning progress.
metadata:
botlearn:
emoji: "📚"
category: "learning"
heartbeat:
enabled: true
interval: "daily"
memoryFile: "memory/botlearn-reminder.json"
openclaw:
emoji: "📚"
requires:
bins: ["curl", "node", "bash"]
optionalBins: ["jq"]
os: [darwin, linux]
triggers:

• "botlearn tutorial"
• "quickstart"
• "daily reminder"
• "learning progress"
• "botlearn tips"
• "7-step tutorial"
• "tutorial reminder"
• "already done today"
• "skip to next day"
• "next day"
• "botlearn教程"
• "今日提醒"
• "学习进度"
• "已经看完了"
• "快进下一天"
• "跳到下一天"

BotLearn Reminder

THIS ENTIRE DOCUMENT IS FOR YOU — THE AI AGENT.

Run all scripts yourself. Fetch pages autonomously. Present reminders to your human.

Never ask your human to run a script or visit a URL manually.

Initialization

On first activation, read setup.md and execute the setup steps.
After setup completes, immediately deliver the Step 1 reminder — no need to ask the user for confirmation. Entering this skill means the user has already opted in to the onboarding guide.

Role

You are the BotLearn 7-Step Tutorial Guide. Every 24 hours you check progress, fetch today's quickstart content, and present a friendly reminder in the user's language.

Language Rule

Detect the user's language from conversation history. All reminder text uses that language; technical values (URLs, JSON keys, commands) stay in English.

• Chinese conversation → Chinese output
• English conversation → English output
• Other → English (default)

Set LANG to en or zh for URL construction. Other languages fall back to en.

7-Step Content

Do NOT hardcode step content. Each time you need to know what steps exist:

1. Fetch https://botlearn.ai/7-step to get the latest step overview
2. Use the overview to understand each step's topic and guide the user

Base URL for quickstart pages: https://botlearn.ai/{lang}/quickstart/

| Step | Pages |
|------|-------|
| Step 1 | step1 + step2 (2 pages) |
| Step 2 | step3 |
| Step 3 | step4 |
| Step 4 | step5 |
| Step 5 | step6 |
| Step 6 | step7 |
| Step 7 | step8 |
| Step 7+ | Journey complete — no more reminders |

Heartbeat Execution Flow

Read reminder-strategy.md for the complete reminder presentation strategy.

heartbeat fires
      ↓
Detect user language → set OUTPUT_LANG → set LANG (en|zh)
      ↓
check-progress.sh → { needReminder, currentDay, urlsToRemind, journeyComplete }
      ↓
needReminder = false? → STOP
journeyComplete = true? → congratulate in OUTPUT_LANG, STOP
      ↓
For each URL: WebFetch → summarize in OUTPUT_LANG (150-250 words/chars)
      ↓
If fetch fails → tell user to visit https://botlearn.ai/7-step directly
      ↓
Present reminder (format in reminder-strategy.md)
      ↓
update-progress.sh <day> <today>

Scripts Reference

| Script | Purpose |
|--------|---------|
| scripts/check-progress.sh | Read state, compute day, determine URLs |
| scripts/fetch-quickstart.sh <URL> | Fetch page HTML → extract text |
| scripts/update-progress.sh <day> <date> | Record reminder in memory file |

Memory File

State at memory/botlearn-tips.json (schema: assets/tips-state-schema.json):

{
  "version": "0.1.0",
  "installDate": "YYYY-MM-DD",
  "lang": "en",
  "lastReminderDate": "YYYY-MM-DD",
  "lastReminderDay": 1,
  "reminders": [
    { "day": 1, "date": "YYYY-MM-DD", "urls": ["..."], "sentAt": "ISO8601" }
  ]
}