OpenClaw Quickstart
Guides new users through 8 hands-on tasks covering OpenClaw's core features. Each task takes under 5 minutes and produces something immediately useful.
Task List
| # | Task (中文) | Task (EN) | Reference |
|---|
| 1 | 给 AI 取个名字 | Initialize AI Identity | references/task-01-identity.md |
| 2 |
让 AI 记住你 | Save Your Preferences | references/task-02-memory.md |
| 3 | 查今天天气 | Check the Weather | references/task-03-weather.md |
| 4 | 写一篇日报 | Generate a Report | references/task-04-report.md |
| 5 | 建一个日历提醒 | Set a Reminder | references/task-05-reminder.md |
| 6 | 用浏览器收集信息 | Browser Info Gathering | references/task-06-browser.md |
| 7 | 让 AI 做一张 PPT | Generate a PPT | references/task-07-ppt.md |
| 8 | 安装一个新 Skill | Install a Skill from ClawHub | references/task-08-skill.md |
Workflow
0. Auto-Install on First Activation
Before doing anything else, check if this is the first time the skill is running:
CODEBLOCK0
If the result is fresh (no progress file yet) → silently run the installer first:
CODEBLOCK1
Do not ask the user — just run it. The installer is idempotent and safe. After it completes, proceed normally.
1. Check Progress
Always start by running:
CODEBLOCK2
Parse JSON output to get current task status and next_task.
2. Show Status & Orient User
Display current progress:
CODEBLOCK3
Ask if they want to do the next task now, or jump to a specific one.
3. Guide Each Task
- 1. Read the task's reference file
- Walk the user through it step by step — do it with them, don't just explain
- After the task action succeeds → immediately call
mark_done.js (see below) - Confirm completion, then offer the next task
4. First-Run Setup (Installation)
On first activation (no .quickstart-progress.json yet), run the installer immediately:
CODEBLOCK4
The installer does two things in one shot:
- 1. HEARTBEAT.md — appends a quickstart progress-check block (runs every 30 min via heartbeat)
- Cron — creates
quickstart-reminder (daily 9 AM push notification for pending tasks)
Optional: customize reminder time:
CODEBLOCK5
Preview without applying:
CODEBLOCK6
Note: The installer is idempotent — safe to run multiple times. It skips steps already done.
Auto-Mark Completion Rules
After performing any of the following actions, immediately run mark_done.js:
CODEBLOCK7
| Task | Trigger condition |
|---|
| 1 | SOUL.md or IDENTITY.md written with AI name/rules |
| 2 |
USER.md updated with user's name/preferences |
| 3 | Weather query successfully returned results to user |
| 4 | A report/daily-log file saved to workspace |
| 5 | A cron/reminder successfully created |
| 6 | browser tool used and returned scraped content |
| 7 | A .pptx file saved to workspace |
| 8 | A skill successfully installed via clawhub |
If all_done: true is returned → immediately run:
CODEBLOCK8
Then send the graduation message (see below).
Heartbeat Cron Behavior (quickstart-heartbeat, every 30 min)
CODEBLOCK9
- -
--mark-done flag: auto-persists newly detected completions to progress.json - If
all_done: true → run cleanup_crons.js + send graduation message - If
newly_completed has entries → send brief completion notification - Otherwise → stay silent (no message)
Daily Reminder Format (quickstart-reminder, 9 AM)
CODEBLOCK10
Graduation Message (all tasks done)
Send this, then run cleanup_crons.js:
CODEBLOCK11
Key Principles
- - Do, don't just explain — actively help complete each task
- Mark immediately — call
mark_done.js right after task success, don't wait - Heartbeat is silent — only speak up when something changes or all done
- Cleanup on finish — all crons must be removed when INLINECODE15
OpenClaw 快速入门
引导新用户完成8个动手任务,涵盖OpenClaw的核心功能。每个任务用时不超过5分钟,并能立即产生实用成果。
任务列表
| # | 任务 | 英文任务 | 参考文件 |
|---|
| 1 | 给 AI 取个名字 | Initialize AI Identity | references/task-01-identity.md |
| 2 |
让 AI 记住你 | Save Your Preferences | references/task-02-memory.md |
| 3 | 查今天天气 | Check the Weather | references/task-03-weather.md |
| 4 | 写一篇日报 | Generate a Report | references/task-04-report.md |
| 5 | 建一个日历提醒 | Set a Reminder | references/task-05-reminder.md |
| 6 | 用浏览器收集信息 | Browser Info Gathering | references/task-06-browser.md |
| 7 | 让 AI 做一张 PPT | Generate a PPT | references/task-07-ppt.md |
| 8 | 安装一个新 Skill | Install a Skill from ClawHub | references/task-08-skill.md |
工作流程
0. 首次激活时自动安装
在执行任何操作之前,检查是否为该技能首次运行:
bash
检查是否已安装
test -f ~/.openclaw/workspace/.quickstart-progress.json && echo installed || echo fresh
如果结果为 fresh(尚无进度文件)→ 先静默运行安装程序:
bash
node {baseDir}/scripts/install.js --workspace ~/.openclaw/workspace
无需询问用户——直接运行即可。安装程序是幂等的且安全的。完成后,正常继续。
1. 检查进度
始终从运行以下命令开始:
bash
node scripts/check_progress.js --workspace ~/.openclaw/workspace
解析JSON输出以获取当前任务状态和 next_task。
2. 显示状态并引导用户
显示当前进度:
📋 你的 OpenClaw 新手任务进度(3/8)
✅ 任务1:给 AI 取个名字
✅ 任务2:让 AI 记住你
✅ 任务3:查今天天气
⬜ 任务4:写一篇日报 ← 下一步
⬜ 任务5:建一个日历提醒
⬜ 任务6:用浏览器收集信息
⬜ 任务7:让 AI 做一张 PPT
⬜ 任务8:安装一个新 Skill
询问他们是否现在要做下一个任务,或者跳转到特定任务。
3. 引导每个任务
- 1. 阅读任务的参考文件
- 逐步引导用户完成——与他们一起做,而不仅仅是解释
- 任务操作成功后→立即调用 mark_done.js(见下文)
- 确认完成,然后提供下一个任务
4. 首次运行设置(安装)
首次激活时(尚无 .quickstart-progress.json),立即运行安装程序:
bash
node scripts/install.js --workspace ~/.openclaw/workspace
安装程序一次性完成两件事:
- 1. HEARTBEAT.md — 追加一个快速入门进度检查块(通过心跳每30分钟运行一次)
- Cron — 创建 quickstart-reminder(每天上午9点推送待办任务通知)
可选:自定义提醒时间:
bash
node scripts/install.js --workspace ~/.openclaw/workspace --hour 9 --minute 30
预览而不应用:
bash
node scripts/install.js --workspace ~/.openclaw/workspace --dry-run
注意: 安装程序是幂等的——多次运行是安全的。它会跳过已完成的步骤。
自动标记完成规则
执行以下任何操作后,立即运行 mark_done.js:
bash
node scripts/mark_done.js --task --workspace ~/.openclaw/workspace
| 任务 | 触发条件 |
|---|
| 1 | 已写入包含AI名称/规则的SOUL.md或IDENTITY.md |
| 2 |
已更新包含用户名/偏好的USER.md |
| 3 | 天气查询成功返回结果给用户 |
| 4 | 报告/日志文件已保存到工作区 |
| 5 | 已成功创建cron/提醒 |
| 6 | 已使用浏览器工具并返回抓取内容 |
| 7 | .pptx文件已保存到工作区 |
| 8 | 已通过clawhub成功安装技能 |
如果返回 all_done: true → 立即运行:
bash
node scripts/cleanup_crons.js
然后发送毕业消息(见下文)。
心跳Cron行为(quickstart-heartbeat,每30分钟)
bash
node scripts/check_progress.js --mark-done --workspace ~/.openclaw/workspace
- - --mark-done 标志:自动将新检测到的完成情况持久化到progress.json
- 如果 alldone: true → 运行 cleanupcrons.js + 发送毕业消息
- 如果 newly_completed 有条目 → 发送简短的完成通知
- 否则 → 保持静默(不发送消息)
每日提醒格式(quickstart-reminder,上午9点)
🦐 嗨!你的 OpenClaw 新手任务还有 N 个待完成:
✅ 任务1:给 AI 取个名字
✅ 任务2:让 AI 记住你
⬜ 任务3:查今天天气 ← 今天来试试?
直接说「帮我完成任务3」就开始了!
毕业消息(所有任务完成)
发送此消息,然后运行 cleanup_crons.js:
🎓 恭喜!你已完成全部 8 个新手任务!
OpenClaw 你玩明白了 🦐
以后有任何问题,随时问我。
(每日提醒和自动检测已自动关闭)
关键原则
- - 动手做,而不仅仅是解释 — 积极帮助完成每个任务
- 立即标记 — 任务成功后立即调用 markdone.js,不要等待
- 心跳保持静默 — 仅在发生变化或全部完成时发言
- 完成后清理 — 当 alldone: true 时,必须移除所有cron