← 返回 Skills 市场
calvinxhk

botlearn-reminder

作者 邢怀康 · GitHub ↗ · v1.0.5
darwinlinux ⚠ suspicious
481
总下载
1
收藏
8
当前安装
3
版本数
在 OpenClaw 中安装
/install botlearn-reminder
功能描述
botlearn-reminder — BotLearn 7-step onboarding guide that delivers quickstart tutorials every 24 hours; triggers on first BotLearn registration or when user...
使用说明 (SKILL.md)

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 \x3Cday> \x3Ctoday>

Scripts Reference

Script Purpose
scripts/check-progress.sh Read state, compute day, determine URLs
scripts/fetch-quickstart.sh \x3CURL> Fetch page HTML → extract text
scripts/update-progress.sh \x3Cday> \x3Cdate> 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" }
  ]
}
安全使用建议
This skill appears to do what it says (daily reminders fetched from botlearn.ai) and does not request secrets, but review a few things before installing: 1) The skill will create and write a memory file under $OPENCLAW_HOME/memory (default ~/.openclaw/memory) — check/backup that location if needed. 2) On first activation it intends to immediately send Step 1 (auto-opt-in) — if you don't want messages sent without confirmation, don't enable/activate until you inspect the scripts. 3) setup.md asks to append a block to a workspace HEARTBEAT.md (i.e., modify files outside the skill) — make sure you are comfortable allowing that change or perform the registration step manually. 4) There is a small inconsistency in naming the memory file (SKILL.md metadata references memory/botlearn-reminder.json while scripts and manifest use botlearn-tips.json) — this should be clarified to avoid duplicated or misplaced state files. 5) The scripts fetch live content from https://botlearn.ai, use Node for extraction, and run curl; inspect scripts locally to satisfy yourself they perform only the described actions. If you want higher assurance: run the scripts in a sandbox or review/modify them to avoid auto-send and to avoid modifying workspace files without explicit consent.
功能分析
Package: @botlearn/botlearn-reminder (xpi) Version: 0.1.5 Description: BotLearn 7-Step Quickstart Tutorial Reminder — heartbeat-driven reminders every 24 hours that dynamically fetch and summarize botlearn.ai quickstart pages, track progress, and present tips in the user's own language The package is a tutorial reminder tool for the BotLearn platform, designed to run within the OpenClaw agent framework. It tracks a 7-day onboarding process by maintaining a local state file, fetching educational content from the official botlearn.ai website, and presenting summaries to the user. The code consists of shell scripts and Node.js logic that perform transparent state management and content retrieval without any malicious behavior, obfuscation, or unauthorized data exfiltration.
能力评估
Purpose & Capability
Name/description, required binaries (curl, node, bash), and the scripts (fetch, check, update) align with a reminder that fetches and summarizes botlearn.ai quickstart pages. Network access to botlearn.ai is expected and justified.
Instruction Scope
SKILL.md instructs the agent to execute setup steps autonomously and 'immediately deliver the Step 1 reminder' on first activation (effectively auto-opt-in). setup.md asks the agent/user to append a block to a workspace HEARTBEAT.md — this modifies a workspace file outside the skill's own directory. There's also a small contradiction: setup.md suggests a manual initial run while SKILL.md says 'Never ask your human to run a script', creating ambiguity about who should perform setup actions. These are scope/behavior concerns (auto-sending messages and writing to arbitrary workspace files).
Install Mechanism
No install spec (instruction-only + shipped scripts) — lowest install risk. The included scripts are plain bash+Node and are not downloaded from arbitrary URLs during install.
Credentials
No secrets or credentials requested. The skill uses OPENCLAW_HOME (non-secret) for memory storage; manifest lists primaryEnv: OPENCLAW_HOME while registry metadata shows no required env vars — minor inconsistency but not a secret. Optional BOTLEARN_LANG can influence which botlearn.ai locale is fetched.
Persistence & Privilege
always: false (no forced global presence). The skill writes state to the agent memory directory (~/.openclaw/memory by default), which is normal. However, setup.md's instruction to append to a workspace HEARTBEAT.md means it will modify another file in the user's workspace — this is a privilege/side-effect the user should expect and explicitly allow.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install botlearn-reminder
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /botlearn-reminder 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.5
botlearn-reminder 1.0.5 - Onboarding flow revised: users now receive the Step 1 reminder immediately after setup, with no extra confirmation needed. - All step content and topics are now dynamically fetched from https://botlearn.ai/7-step; step details are no longer hardcoded. - New reminder flow and formatting strategies are documented in README.md and reminder-strategy.md. - Content fallback now instructs the user to visit https://botlearn.ai/7-step directly if page fetch fails; old fallback files removed. - Asset and test files cleaned up for clarity and maintenance.
v1.0.4
- Updated tutorial URL structure to use "step1" through "step8" (instead of "day0" through "day7") - Base tutorial URL now uses `{lang}` placeholder for dynamic language support; falls back to English if not supported - Added explicit language code handling in memory schema and reminder generation - Memory schema updated to include `"lang"` field and to use new URL pattern - Small adjustments to description and initialization to match new structure and language handling
v1.0.0
- Initial release of BotLearn Reminder with daily heartbeat-driven 7-day tutorial guidance - Auto-detects user’s conversation language and delivers reminders in the same language - Fetches and summarizes live quickstart content for each day; provides a fallback if offline - Tracks user progress and prevents duplicate or obsolete reminders; stops after Day 7 - Easily integrates on macOS and Linux, requiring bash, node, curl (jq optional)
元数据
Slug botlearn-reminder
版本 1.0.5
许可证
累计安装 8
当前安装数 8
历史版本数 3
常见问题

botlearn-reminder 是什么?

botlearn-reminder — BotLearn 7-step onboarding guide that delivers quickstart tutorials every 24 hours; triggers on first BotLearn registration or when user... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 481 次。

如何安装 botlearn-reminder?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install botlearn-reminder」即可一键安装,无需额外配置。

botlearn-reminder 是免费的吗?

是的,botlearn-reminder 完全免费(开源免费),可自由下载、安装和使用。

botlearn-reminder 支持哪些平台?

botlearn-reminder 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(darwin, linux)。

谁开发了 botlearn-reminder?

由 邢怀康(@calvinxhk)开发并维护,当前版本 v1.0.5。

💬 留言讨论