BotLearn Reminder

---

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.

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" }
  ]
}