Openclaw Study Coach 是一个给 K-12(小学 / 初中 / 高中)学生的 AI 学习辅导员,以 markdown skill 包的形式分发。可以在 Claude Code / Codex CLI / OpenClaw 上直接跑,不需要任何前端、不需要部署服务器、不需要 API key 之外的费用。覆盖语数英 + 理科(物化生)+ 文综(史地政)5 大学科,1-12 年级学段自适应(启蒙 / 巩固 / 初中 / 高中 4 档语气自动切换),含家长 Playbook(每天 3 分钟可做的具体亲子活动)。设计哲学来自微光游戏社的 OpenClaw 系列文章和教育学者沈奕斐的自驱力理论。
Openclaw Study Coach is an AI tutoring agent for K-12 students (grades 1-12: elementary / middle / high school) distributed as a markdown skill pack. It runs directly on Claude Code, Codex CLI, or OpenClaw — no frontend, no server, no cost beyond your LLM API key. Covers 5 subject areas (Chinese / Math / English / Science [Physics + Chemistry + Biology] / Humanities [History + Geography + Politics]) with grade-adaptive teaching style (4 tiers: kindling 1-3 / consolidation 4-6 / middle 7-9 / high 10-12). Includes a Parent Playbook — concrete 3-minute family activities you can do tonight, with specific dialogue. The underlying frameworks (4-step method for divergent questions, 5-step calculation, spaced repetition) are language-agnostic; translations welcome via PR.
Openclaw Study Coach は、中国の K-12(小・中・高校)カリキュラムに対応した AI 学習チューターです。markdown 形式の skill パックとして配布され、Claude Code / Codex CLI / OpenClaw で直接動作します。フロントエンド不要、サーバー不要、LLM API キー以外の費用は一切かかりません。5 教科(国語(中国語)・数学・英語・理科(物理・化学・生物)・社会(歴史・地理・政治))を網羅し、学年(1〜12)に応じて口調と難易度が自動調整されます(啓蒙期 / 定着期 / 中学期 / 高校期 の 4 段階)。毎日 3 分でできる具体的な親子アクティビティを生成する Parent Playbook も搭載。発散問題の 4 ステップ法、計算問題の 5 ステップ法、間隔反復記憶などの基本フレームワークは言語非依存であり、PR による多言語対応を歓迎します。
Openclaw Study Coach 는 중국 K-12(초·중·고) 커리큘럼에 맞춘 AI 학습 튜터입니다. markdown skill 팩 형태로 배포되며, Claude Code / Codex CLI / OpenClaw 에서 바로 실행됩니다. 프론트엔드 불필요, 서버 불필요, LLM API 키 외 추가 비용 없음. 5 과목(국어(중국어) / 수학 / 영어 / 이과(물리·화학·생물) / 사회(역사·지리·정치))을 모두 다루며, 학년(1-12)에 따라 말투와 난이도가 자동으로 조정됩니다(계몽기 / 정착기 / 중등 / 고등 4단계). 매일 3분 부모-자녀 활동을 구체적으로 제안하는 Parent Playbook 포함. 핵심 프레임워크(발산 문제 4단계법, 계산 문제 5단계법, 간격 반복 기억)는 언어 비의존적이며 PR 을 통한 다국어 지원을 환영합니다.
Openclaw Study Coach es un agente tutor de IA para estudiantes de K-12 (grados 1-12: primaria / secundaria / preparatoria), basado en el currículo educativo chino y distribuido como un paquete de skills en markdown. Se ejecuta directamente en Claude Code, Codex CLI u OpenClaw — sin frontend, sin servidor, sin costos más allá de tu clave API de LLM. Cubre 5 áreas (Lengua [chino] / Matemáticas / Inglés / Ciencias [Física + Química + Biología] / Humanidades [Historia + Geografía + Política]) con estilo de enseñanza adaptado al grado (4 niveles: iniciación 1-3 / consolidación 4-6 / secundaria 7-9 / preparatoria 10-12). Incluye un Parent Playbook con actividades familiares concretas de 3 minutos al día, hasta el nivel de diálogo específico. Los marcos centrales (método de 4 pasos para preguntas divergentes, 5 pasos para cálculo, repetición espaciada) son agnósticos al idioma; PRs para traducciones son bienvenidos.
Openclaw Study Coach 是一个给 K-12(小学 / 初中 / 高中)学生的 AI 学习辅导员,以 markdown skill 包的形式分发。可以在 Claude Code / Codex CLI / OpenClaw 上直接跑,不需要任何前端、不需要部署服务器、不需要 API key 之外的费用。
它解决五个真实痛点:
- 任何学科的发散题(语文阅读"读完什么感受"、历史"评价 X"、政治"分析这个现象"、物理"为什么会发生")—— 没标准答案,孩子无从下手,家长讲不清。
- 作文 —— 找不到合适的辅导老师,孩子不知道从哪开头,写完不知道怎么改。
- 数学应用题 / 计算题 —— 不审题、不画图、不带单位,80% 的错来自于"流程没走全"。
- 大量记忆类内容(英语单词、古诗、历史年表)—— 机械背诵 ≠ 真记得,需要间隔重复。
- 家长不知道怎么把学科变成游戏 —— 沈奕斐讲自驱力要靠兴趣,但"想小游戏"对很多家长来说就是做不到。
这个系统:
- 学段自适应:1-3 年级启蒙、4-6 巩固、7-9 初中、10-12 高中,语气 / 难度 / 任务时长全自动切档
- 学科自动识别:孩子发题进来,自动判断是数学 / 语文 / 英语 / 理科 / 文综,路由到对应 tutor
- 纵向记得孩子:三件套画像(weakness / strengths / interests),不重置
- 父母 playbook:每天 3 分钟可做的具体亲子活动,周末 30 分钟深度互动
- 数据本地:所有学习数据存为 markdown / CSV,不上云
一句话总结: 一个会记得 ta 的辅导员,从一年级到高三都能用,语数英 + 理科 + 文综全覆盖。卡题时用 4 步法 / 5 步法 / 间隔重复引导,永远不替写。每天给爸妈一个 3 分钟可做的家庭活动。
| Tutor | 覆盖年级 | 核心场景 |
|---|---|---|
| chinese-tutor | 1-12 | 阅读理解 / 作文 / 古诗 / 字词 / 文言文 |
| math-tutor | 1-12 | 口算 / 应用题 / 代数 / 函数 / 几何 / 导数 |
| english-tutor | 1-12 | 单词 / 语法 / 完形 / 阅读 / 写作 / 七选五 / 续写 |
| science-tutor | 5-12 | 科学(5-6)/ 物理 + 化学 + 生物(7-12) |
| humanities-tutor | 1-12 | 道法(1-9)/ 历史 + 地理 + 政治(7-12) |
| 方法 | 用在哪 |
|---|---|
| divergent-question-method | 发散题 4 步法 — 跨学科(语文阅读 + 历史评价 + 政治分析 + 物理"为什么" + 英语推断) |
| calculation-method | 计算题 5 步法 — 数理化通用(审题→列式画图→算→单位检查→答语) |
| memorization-loop | 间隔重复 1/3/7/30 天 — 文科记忆 + 古诗 + 英语单词 + 化学方程式通用 |
homework-intake · mistake-tracker · review-scheduler · weakness-tracker · daily-report · weekly-report · parent-playbook
| Grade | 语气 / 任务 | 反馈结构 |
|---|---|---|
| 1-3 启蒙期 | 每条 ≤ 20 字 / 任务 5 分钟 / 多 emoji 多比喻 | 不讲"为什么",直接"怎么做" |
| 4-6 巩固期 | 每条 ≤ 50 字 / 任务 5-20 分钟 / emoji 克制 | 反馈三段式 + 引入"金句"方法论 |
| 7-9 初中期 | 每条 ≤ 80 字 / 任务 15-30 分钟 / emoji 少 | 应试技巧 + 讨论"为什么",不用闯关叙事 |
| 10-12 高中期 | 每条 ≤ 100 字 / 任务 20-40 分钟 / 几乎无 emoji | 像同行,讲高考视角 + 时间分配 + 选科考虑 |
新高考 3+1+2 / 3+3 / 旧高考文理 — USER.md 里指定后,agent 严格按选科出练习,不强行覆盖未选学科。
| 维度 | ChatGPT / 通用 AI | 在线家教 / 补习班 | 单科练习 App | Openclaw Study Coach |
|---|---|---|---|---|
| 记得孩子的卡点 | ❌ 每次重置 | ✓ 部分 | ✅ 三件套画像纵向累积 | |
| 跨学科 / 全 K-12 | ❌ 各科分开报 | ❌ 单科 | ✅ 5 学科 + 3 思维方法 + 1-12 自适应 | |
| 处理发散题 | ✓ 取决于老师 | ❌ 基本不练 | ✅ 4 步法,跨学科通用 | |
| 处理计算题 | ✓ | ✅ 5 步法 + 强制画图 / 带单位 | ||
| 记忆类内容 | ✓ 取决于老师 | ✅ 间隔重复 1/3/7/30 天 + 自测 | ||
| 家长怎么参与 | 自己摸索 | 看老师反馈 | 看打分 | ✅ 每天 3 分钟具体活动(含台词) |
| 数据归属 | 在云端 | 在机构 | 在 App 公司 | ✅ 本地 markdown,孩子的数据永远是你的 |
| 一年费用 | 订阅费 | 数千-数万 | 数百-数千 | ✅ 0 元(Claude API 按量,平均 ≤ 1 元/天) |
| 因材施教 | 看 prompt 写法 | 看老师 | ❌ | ✅ 基于 weakness-profile 自动调整出题 |
- macOS / Linux / Windows + WSL
- Claude Code 已安装(推荐),或 Codex CLI,或 OpenClaw
# 1. 克隆
git clone https://github.com/X-RayLuan/Openclaw-Study-Coach.git
cd Openclaw-Study-Coach
# 2. 改你家孩子的信息(关键)
vim USER.md
# 必填:grade(1-12)、学校所在地区、教材版本、active_subjects、家长称谓
# grade ≥ 10:必填"选科"字段(3+1+2 / 3+3 / 旧高考文理)
# 3. 启动
claude # Claude Code
codex # Codex CLI(然后发"完成初始化协议"指令,见 CODEX.md)启动 agent 后,试 5 个场景(对应不同 grade + 不同学科):
你是谁?
→ 自我介绍(语气按 USER.md 的 grade 自适应)
我是 [USER.md 里的昵称]。今天阅读理解我不会做一道题——"读完这段话你什么感受?"
→ 触发 chinese-tutor → reading-comp-tutor → divergent-question-method 4 步法
我是 [昵称]。今天数学作业:小明 12 个糖,小红比他多 5 个,小红有几个?
→ 触发 math-tutor → calculation-method 5 步法,强制画线段图
我是 [昵称]。化学方程式不会配平:H₂ + O₂ → H₂O
→ 触发 science-tutor → 四步配平法
(家长口吻)生成今日日报
→ 触发 daily-report → 6 字段日报 + 今晚 3 分钟可做的一件事
这些规则分布在
SOUL.md/AGENTS.md/ 各 skill,是系统的灵魂。
- 永远不直接给答案,用引导、选项、工具箱。
- 反馈结构按学段切(启蒙/巩固/初中/高中 4 档,见 SOUL.md)。
- 错题反馈先肯定她思考里"对"的部分,再指改进点。
- 指出"具体瞬间",不写"你真棒""加油"这种空话。
- 数学题 1-9 年级一次只给一道(10-12 可一次给一组小测)。
- 积分永远只加不减(完成 +5,全对 +3,连续 +N,完成全部 +10)。高中可改 progress 制。
- 任务长度按学段不同:5 / 5-20 / 15-30 / 20-40 分钟。
- 她明显累/烦/哭 → 立刻停,落盘进度,改用陪伴模式。
- 发散题 4 步法:翻译题目 → 找证据 → 给工具箱 → 组合答案。语文阅读 + 历史评价 + 政治分析 + 物理"为什么" + 英语推断 全用。
- 计算题 5 步法:审题(圈关键词)→ 列式 / 画图 → 算(分步,不跳步骤)→ 单位 / 量纲检查 → 写答语。数理化全用。
- 作文 5 阶段:理解题 → 挖 5 细节 → 挑一段先写 → 改一处 → 落盘。永远不替写。
- 间隔重复 1/3/7/30 天:文科记忆 + 古诗 + 英语单词 + 化学方程式全走 memorization-loop。永远不机械背诵。
- 物理永远先画图(受力 / 运动 / 电路 / 光路)。
- 历史评价类强制三段(原因 / 经过 / 影响)。
- 地理简答强制三问(是什么 / 为什么 / 怎么样)。
- 政治大题强制三段(理论 / 材料 / 结论)。
- 该写的必须落盘(日报、错题、画像、积分都不能只在对话里说)。
- 每天日报必须触发 parent-playbook(今晚 1 件事)。
- 每周周报必须重写 weakness-profile + 生成 weekend playbook。
- 每天 playbook ≤ 5 分钟,3 分钟内能开始(不打印、不买、不开电脑)。
- 接今天孩子的学习(延伸今天的题/写的字/读的故事)。
- AI 做不了的事(真人陪伴/实物互动/情绪共鸣),具体到台词级别。
Openclaw-Study-Coach/
├── CLAUDE.md # 入口(Claude Code 自动加载)
├── CODEX.md # Codex CLI 用户向导
├── SOUL.md # 辅导员语气 + 4 学段语气档
├── USER.md # ⭐ 孩子信息(你要改的唯一文件)
├── AGENTS.md # 工作流 + 学科路由 + 数据流
├── TOOLS.md # 落盘约定
├── README.md # 本文件
├── CHANGELOG.md # 版本变化
├── LICENSE # MIT
│
├── .claude/skills/ # 17 个 Skill
│ ├── 学科 tutor (5)
│ │ ├── chinese-tutor/ # 语文(1-12)
│ │ ├── math-tutor/ # 数学(1-12)
│ │ ├── english-tutor/ # 英语(1-12)
│ │ ├── science-tutor/ # 理科(5-12)
│ │ └── humanities-tutor/ # 文综(1-12)
│ ├── 通用思维方法 (3)
│ │ ├── divergent-question-method/ # 4 步法(跨学科发散题)
│ │ ├── calculation-method/ # 5 步法(数理化计算)
│ │ └── memorization-loop/ # 间隔重复(跨学科记忆)
│ ├── 旧版兼容 (2)
│ │ ├── reading-comp-tutor/ # v0.1 保留(语文阅读理解专项)
│ │ └── writing-coach/ # v0.1 保留(语文作文专项)
│ └── 流程 (7)
│ ├── homework-intake/ # 收作业 + 自动识别学科
│ ├── mistake-tracker/ # 错题归档
│ ├── review-scheduler/ # 复习节奏
│ ├── weakness-tracker/ # 画像维护
│ ├── daily-report/ # 日报
│ ├── weekly-report/ # 周报
│ └── parent-playbook/ # 父母 playbook
│
├── data/
│ ├── profile/ # ⭐ 三件套画像(纵向记忆)
│ ├── parent-playbook/ # daily / weekend
│ ├── homework/ # inbox / parsed / done
│ ├── mistakes/subjects/{语文,数学,英语,理科,文综}/
│ ├── memorization/queue.jsonl # ⭐ 间隔重复队列(新)
│ ├── plans/ # weekly / daily
│ ├── reports/ # daily / weekly / trends.csv
│ ├── points/log.jsonl # 积分(只加不减)
│ └── rubrics/
├── scripts/
│ └── lark-bridge-daemon.sh # 飞书 bridge 的 SSH 友好 daemon 管理
├── assets/ # 图片
└── logs/ / memory/
| 文件 | 内容 | 谁能看 |
|---|---|---|
data/profile/weakness-profile.md |
当前 pattern + 已尝试方案 + 下一步 | 家长 + agent |
data/profile/strengths.md |
已稳能力 + 最近 14 天具体瞬间 | 孩子(精简版)+ 家长 + agent |
data/profile/interests.md |
兴趣(用来包装练习) | 孩子 + 家长 + agent |
工作流程:
每天对话 → daily-report → 即时追加三件套
↓
生成今晚 parent-playbook
↓
下次启动 → CLAUDE.md @import 三件套
↓
agent 立刻知道她最近卡哪、强在哪、喜欢什么
↓
每周 weekly-report → 重写 weakness-profile 做提炼(≤ 7 条 pattern)
↓
生成周末 parent-playbook(30 分钟亲子活动)
回应教育学者沈奕斐那句:
培养孩子自驱力,要让孩子对学习有兴趣。父母要想办法把数学/语文通过小游戏变得生动有趣。可是这个对我来说好难啊。
这套系统把"想小游戏"的负担从父母身上挪到 agent 身上。
每天 daily-report 后自动生成 3 分钟可做的家庭活动到 data/parent-playbook/daily/。
| 类型 | 适用场景 | 例子 |
|---|---|---|
| 类 A 晚餐对话延伸 | 阅读理解题 | 妈妈问:"今天那只小猫躲在花盆后面。如果家里有一只小猫这样躲起来,妈妈会怎么做?"故意先给你的版本,然后听她的版本。 |
| 类 B 实物对照细节 | 写了作文 | 看孩子作文里写"蓝色的裙子"——找一个家里真蓝色的东西问她:"这种蓝叫什么蓝?" |
| 类 C 角色互换 | 今天有突破 | "妈妈这题真不会,你能教我一下吗?"让她当老师讲一次。 |
| 类 D 纯陪伴 | 累 / streak ≥ 5 天 | 睡前问:"今天最开心的一件事是什么?"(不问学习)你也说你的。 |
- 共读(类 1) — 读一篇短文,只问 2 个问题
- 家庭小报(类 2) — 让孩子当一周一次的"家庭记者"
- 观察类(类 3) — 带去一个地方,记 3 个细节
- 语言游戏(类 4) — 不需要道具的 3 种游戏(词语接力 / 形容词接力 / 故事接力)
cd Openclaw-Study-Coach
claude自动加载 CLAUDE.md → @import SOUL/USER/AGENTS/TOOLS + 三件套画像 → SkillTool 索引 17 个 skill。
cd Openclaw-Study-Coach
codex
# 第一句话发:"请按 AGENTS.md 顶部的初始化协议加载所有规则文件"详见 CODEX.md。
整个目录作为 OpenClaw workspace,AGENTS.md 顶部初始化协议直接生效。
通过 lark-channel-bridge 把飞书消息桥到本地 Claude Code,孩子在飞书 DM 机器人就能用。
# 全局装(不要用 npx)
npm install -g lark-channel-bridge
# 第一次扫码绑定
lark-channel-bridge run
# 装 daemon(SSH 进 Mac Tahoe/Sequoia 的用户用这个)
./scripts/lark-bridge-daemon.sh install在飞书里发:
/cd /path/to/Openclaw-Study-Coach
/ws save coach
每个学段都有针对性的语气档 / 难度档(SOUL.md 4 学段语气表)。小学(1-6)以启发 + 游戏化为主,初中(7-9)开始讲应试技巧,高中(10-12)以深度推理 + 高考视角为主,不再用闯关叙事。
USER.md 里 subject_pain_points 字段你填了各学科痛点。系统会优先在 active_subjects 列出的学科上深耕,weekly-report 自动找最严重的 pattern,出具体的下周 1 个重点。家长不必自己判断。
USER.md 里有"选科"字段(3+1+2 / 3+3 / 旧高考文理)。填了之后,science-tutor 和 humanities-tutor 严格按选科出练习,不强行覆盖未选学科。
是的。grade 1-3 主要用 chinese / math / english 三个 tutor,理科和文综暂时不动。学段切档自动处理——你只需要写好 USER.md 的 grade,agent 自动选低阶模式。
ChatGPT 每次对话都重置,记不住你孩子的弱项。这套系统通过三件套画像(weakness-profile / strengths / interests)纵向累积孩子的学习数据。这是因材施教的物理基础。
所有数据本地存储在 markdown / CSV 文件,不上云。孩子真实信息(姓名/学校)用代号处理。.gitignore 默认 ignore data/ 内容。
主要成本是 Claude / OpenAI API。一个孩子每天 30 分钟辅导,平均一天不超过 1 元人民币。一年 300-500 元,比任何线下补习便宜一个数量级。
设计哲学来自 OpenClaw 官方实践案例(微光游戏社 "用 OpenClaw 给孩子搭全科辅导系统" 系列文章 4 篇)。我们在 Claude Code / Codex 上重新实现 + 大幅扩展(从小学语文扩到 K-12 全学科 + 加 3 个跨学科思维方法 + 加 memorization-loop)。完全兼容 OpenClaw workspace。
The system prompts are in Chinese because the design targets Chinese K-12 curriculum and exam systems (新高考 / 中考 etc). The underlying frameworks (4-step method for divergent questions, 5-step calculation, 5-stage writing, weakness profile, parent playbook, spaced repetition) are language-agnostic — fork this repo and translate the 5 top-level .md files + 17 SKILL.md files into your target language. PR welcome.
This system explicitly does NOT replace teachers or parents. It absorbs the repetitive, error-prone, mentally exhausting parts of tutoring (scheduling tasks, tracking mistakes, generating practice, remembering weaknesses, spaced repetition reviews), and frees parents to do what AI cannot: emotional bonding, real-world games, situational observation. See the Parent Playbook section.
22 hard rules baked in to prevent harmful patterns: never give direct answers to divergent questions, never criticize the child, never deduct points, never label a child as "smart/dumb", stop immediately when emotional.
商业产品在封闭系统里跑,你看不到 system prompt,改不了规则,孩子的数据是他们的。这套系统:
- ✅ 完全开源,你能看到每一条规则
- ✅ 数据本地,孩子的画像永远是你的
- ✅ K-12 全覆盖 + 跨学科思维方法(其他产品多是单科)
- ✅ 可改可扩展,觉得 4 步法太机械就改
- ✅ 跟着 LLM 进步免费升级(切到更强模型不用改 skill)
⚠️ 没有 GUI 包装,需要懂一点命令行⚠️ 没有客服,坏了自己修 / 提 issue
适合愿意花一两个小时配置 + 喜欢可控感的家长。
欢迎 PR:
- 新学段补充:特别欢迎实战中发现的某学段某学科的更优练习方法
- 新教材适配:不同省份教材的难度参考(USER.md 教材字段更精细化)
- 新 playbook 模板:更多类型的亲子活动
- 翻译:英文 / 日文 / 韩文 / 国际学校版
直接 fork → 改 → 开 PR。
- 微光游戏社 / 人间折腾录 — 《用 OpenClaw 给孩子搭全科辅导系统》系列,v0.1 核心架构来自这里
- 沈奕斐(教育学者)— 自驱力底层逻辑 + Parent Playbook 设计初衷
- Claude Code / Codex CLI / OpenClaw — 运行平台
- lark-channel-bridge — 飞书 / Lark 集成
ai-tutor · k12 · claude-code · codex · openclaw · claude-code-skill · kids-education · elementary-school · middle-school · high-school · gaokao · reading-comprehension · writing-coach · math-tutor · science-tutor · parent-coach · homework-helper · self-driven-learning · markdown-agent · ai-for-parents · personalized-learning · agent-skill · longitudinal-memory · weakness-profile · spaced-repetition · feishu-bot · 小学辅导 · 初中辅导 · 高中辅导 · 语文阅读理解 · 作文辅导 · 数学辅导 · 物化生辅导 · 史地政辅导 · 自驱力 · 家长助手 · AI辅导 · 全科辅导 · 沈奕斐 · 新高考
MIT © 2026 X-RayLuan
Forks 和 PRs 都欢迎。如果你 fork 后做了好的扩展(新学段 / 新教材 / 新 playbook / 翻译版),开 PR 我合并回 main。
Made with ❤️ for kids (grade 1-12) who deserve a tutor that remembers them.