docs: refresh tutorial for OpenClaw v2026.4.11

Author: Maynor996

README.md

@@ -6,7 +6,7 @@
 [![GitHub stars](https://img.shields.io/github/stars/xianyu110/awesome-openclaw-tutorial?style=social)](https://github.com/xianyu110/awesome-openclaw-tutorial)
 [![GitHub forks](https://img.shields.io/github/forks/xianyu110/awesome-openclaw-tutorial?style=social)](https://github.com/xianyu110/awesome-openclaw-tutorial)
 [![License](https://img.shields.io/badge/license-GPL--3.0-blue.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-v2026.3.24-green.svg)](https://github.com/xianyu110/awesome-openclaw-tutorial)
+[![Version](https://img.shields.io/badge/version-v2026.4.11-green.svg)](https://github.com/xianyu110/awesome-openclaw-tutorial)
 [![Status](https://img.shields.io/badge/status-完成-success.svg)](PROJECT-SUMMARY.md)
 [![CSDN](https://img.shields.io/badge/CSDN-博客-c32136?style=for-the-badge&logo=csdn)](https://blog.csdn.net/xianyu120)
 [![Bilibili](https://img.shields.io/badge/Bilibili-B站-fb7299?style=for-the-badge&logo=bilibili)](https://space.bilibili.com/399102586)
@@ -16,6 +16,8 @@
 
 > 📖 **纸质书《OpenClaw超级个体实操手册》已上市！** 清华大学出版社出版，在开源教程基础上全面重写+逐条验证。🛒 [京东专属购买链接（¥42，原价¥59.8）](https://item.jd.com/14669463.html)
 
+> 🔄 **2026-04-13 更新说明**：本仓库现按 **OpenClaw v2026.4.11（稳定版）** 校对；`v2026.4.12-beta.1` 仅作预发布参考。第 1/2/5/7 章已补当前主线，第 10-15 章已增加高风险提示与新版入口，动手前请优先参考官方文档。
+
 ---
 
 ## 🚀 30秒快速选择：哪种部署方式适合你？
@@ -43,20 +45,20 @@
 
 ### 🔥 核心功能（实战）
 - 📁 [第4章：文件管理](docs/02-core-features/04-file-management.md) - 效率提升81%
-- 🧠 [第5章：知识库](docs/02-core-features/05-knowledge-management.md) - 第二大脑系统
+- 🧠 [第5章：知识库](docs/02-core-features/05-knowledge-management.md) - 第二大脑系统 + Active Memory / Dreaming 补充
 - 📅 [第6章：日程管理](docs/02-core-features/06-schedule-management.md) - AI自动创建日程
-- ⚙️ [第7章：自动化](docs/02-core-features/07-automation-workflow.md) - 24小时为你工作
+- ⚙️ [第7章：自动化](docs/02-core-features/07-automation-workflow.md) - 定时任务 + Task Flow / Webhooks 更新
 
 ### 💎 进阶技能（提升）
 - 🔌 [第8章：Skills扩展](docs/03-advanced/08-skills-extension.md) - 1800+技能
 - 🤖 [第9章：多平台集成](docs/03-advanced/09-multi-platform-integration.md) - 飞书/企微/钉钉/QQ/微信
-- 🔗 [第10章：API集成](docs/03-advanced/10-api-integration.md) - 绘图/视频/语音
+- 🔗 [第10章：API集成](docs/03-advanced/10-api-integration.md) - 官方 infer / 媒体生成主路线
 - ⚙️ [第11章：高级配置](docs/03-advanced/11-advanced-configuration.md) - 性能优化
 
 ### 🎯 实战案例（直接套用）
 - 👔 [第12章：5类人群实战](docs/04-practical-cases/12-personal-productivity.md) - 效率提升85%
 - 🔗 [第13章：高级自动化](docs/04-practical-cases/13-advanced-automation.md) - ROI 9000%-15900%
-- 🎨 [第14章：创意应用](docs/04-practical-cases/14-creative-applications.md) - AI绘画/视频/翻译
+- 🎨 [第14章：创意应用](docs/04-practical-cases/14-creative-applications.md) - 以官方媒体能力与 ComfyUI 为主
 - 🚀 [第15章：超级个体](docs/04-practical-cases/15-solo-entrepreneur-cases.md) - 一人顶一个团队
 
 ### 📚 附录工具（速查）
@@ -165,20 +167,28 @@ openclaw gateway restart
 
 ---
 
-### 🆕 v2026.3.24 更新（2026年3月26日，当前最新）
+### 🆕 v2026.4.11 稳定版更新（2026年4月12日）
+
+**当前基线**
+- **稳定版**：`v2026.4.11`
+- **预发布参考**：`v2026.4.12-beta.1`（2026年4月13日）
+- **推荐运行时**：`Node 24`；如继续走兼容路径，建议至少 `Node 22.16+`
 
-**重要变更**
-- **Node.js 最低版本要求提升**：macOS 现在要求 Node >= 22.16.0（Linux/Windows 要求 >= 22.14.0），如安装失败请先检查 Node 版本
-- 多平台（Discord / Telegram / Slack / 飞书）频道稳定性修复
-- exec approvals 安全策略多处收紧
+**2026.4 主线变化**
+- **Active Memory**：回复前自动拉取相关偏好、上下文和历史细节
+- **Dreaming + Memory Wiki**：长期记忆、结构化 `claim/evidence`、矛盾/新鲜度管理成为主线能力
+- **Task Flow + Webhooks**：自动化从“定时任务”升级到“持久化流程 + 外部事件触发”
+- **`openclaw infer`**：统一 `model / image / audio / tts / video / web / embedding` CLI 入口
+- **内建媒体能力**：官方 `video_generate` / `music_generate` 与 `ComfyUI` provider/plugin 已可直接使用
+- **Control UI**：新增多语言与富内容 `[embed ...]` 展示能力
 
 **升级命令**：
 ```bash
-npm install -g openclaw@latest
-openclaw --version  # 确认版本为 2026.3.24
+npm install -g openclaw@2026.4.11
+openclaw --version  # 确认版本为 2026.4.11
 ```
 
-> ⚠️ **WSL/Linux 安装提示**：如升级后提示缺少 UI 资产，请确认 Node 版本 >= 22.14，然后重新执行 `npm install -g openclaw@latest`
+> ⚠️ **新手建议**：如果你的目标是“按教程稳定跑通”，优先使用 `v2026.4.11`。`v2026.4.12-beta.1` 适合尝鲜验证，不建议直接作为默认教程基线。
 
 ---
 
@@ -325,7 +335,7 @@ openclaw --version  # 确认版本为 2026.3.24
 ## 📈 项目进度
 
 - ✅ **v1.6**（2026-03-18）：新增一键部署教程（8个平台）
-- ✅ **v1.7**（2026-03-27）：同步 OpenClaw v2026.3.12 ~ v2026.3.24 版本更新内容，追加多版本重要提示
+- ✅ **v1.8**（2026-04-13）：同步 OpenClaw `v2026.4.11` 稳定版能力地图，补充记忆系统、Task Flow、Webhooks 与官方媒体主路线提示
 - ✅ **v1.9**（2026-04-04）：同步橙皮书 v1.3~v1.4 更新——新增微信ClawBot、腾讯全家桶、浏览器渠道、GLM-5-Turbo、安全漏洞统计
 - 🔄 **v1.8**（进行中）：优化内容质量，补充实战案例
 
@@ -352,7 +362,7 @@ openclaw --version  # 确认版本为 2026.3.24
 **最后更新**：2026年4月4日
 **教程版本**：v1.9
 **总字数**：408,000字（15章节 + 15附录）
-**适用OpenClaw版本**：2026.3.24（推荐最新版）
+**适用OpenClaw版本**：2026.4.11（稳定版） / 2026.4.12-beta.1（预发布参考）
 
 🎉 **教程已完成 | 支持续优化 | 完全免费** 🎉
 🚀 **一个人 + OpenClaw = 无限可能** 🚀

docs/01-basics/01-introduction.md

@@ -4,9 +4,9 @@
 
 > 在开始使用 OpenClaw之前，先了解它是什么，为什么要用它，以及它能带来什么。
 
-> ⚠️ **版本说明**：由于 OpenClaw 仍在快速开发中，本教程基于 **2026.3.2** 版本编写，已同步更新至 **2026.4.2** 版本命令与功能。该版本经过充分验证，稳定可靠。
+> ⚠️ **版本说明**：截至 **2026-04-13**，本教程按 **OpenClaw v2026.4.11（稳定版）** 校对；`v2026.4.12-beta.1` 仅作预发布参考。如果你只想稳定跑通教程，请优先使用稳定版。
 
-> 💡 **重要前提**：OpenClaw 预装了 **49个内置技能（Skills）**，本教程中的大部分功能演示都基于这些内置技能。这些技能涵盖文件管理、知识管理、日程管理、自动化等核心场景，开箱即用。如果某些功能无法使用，请先确认相关技能是否已启用（详见[第8章：Skills扩展](../03-advanced/08-skills-extension.md)）。
+> 💡 **重要前提**：OpenClaw 现在的主线能力不只来自 Skills，还包括官方内建的记忆系统、Task Flow、媒体生成工具、Webhooks 和 `infer` CLI。教程中凡是遇到“第三方 Skill 安装失败”或“命令找不到”，优先按官方主路线排查。
 
 ---
 
@@ -22,11 +22,22 @@ OpenClaw 是一个**开源的 AI 智能体 Gateway 网关**，让你可以在本
 
 ### 核心能力
 
-- 🏠 **本地部署**：在你的电脑上运行，数据隐私有保障
-- 📁 **文件访问**：可以搜索、读取、编辑你电脑上的文件
-- 🔌 **无限扩展**：通过 Skills（技能）系统扩展功能
-- 💬 **多平台使用**：支持飞书、企微、钉钉、QQ、Telegram、Discord等
-- 💰 **成本可控**：使用自己的 API，费用透明
+- 🏠 **本地/云端部署**：在你的电脑或服务器上运行，数据和配置可控
+- 📁 **文件与工作区操作**：可以搜索、读取、编辑本地文件并执行自动化任务
+- 🧠 **记忆系统升级**：支持 Active Memory、Dreaming、Memory Wiki 等长期记忆能力
+- ⚙️ **自动化主线**：除了定时任务，还支持 Task Flow 和 Webhooks 驱动的持久化流程
+- 🎬 **媒体生成内建化**：官方支持图片、视频、音乐生成以及 ComfyUI 工作流接入
+- 💬 **多平台使用**：支持飞书、企微、钉钉、QQ、Telegram、Discord 等
+- 💰 **成本可控**：使用自己的 API 或本地能力，自行控制成本与安全边界
+
+### 2026.4 版本你需要知道的新主线
+
+- **Active Memory**：在主回复前自动回忆用户偏好、上下文和历史细节
+- **Dreaming**：通过 light / deep / REM 三阶段，把高价值短期信息提升为长期记忆
+- **Memory Wiki**：把知识库从“普通笔记”升级为带 `claim / evidence`、矛盾检测和新鲜度排序的结构化知识层
+- **Task Flow + Webhooks**：把自动化从“定时触发”扩展为“可恢复、可追踪、可被外部系统驱动”的工作流
+- **`openclaw infer`**：统一模型、图片、音频、TTS、视频、网页搜索和 embedding 的 CLI 入口
+- **Control UI 多语言**：当前官方已支持简中、繁中、日语、韩语、法语、德语、西语等多语言界面
 
 ### 工作原理
 

docs/01-basics/02-installation.md

@@ -4,6 +4,8 @@
 
 > 本章节将手把手教你安装 OpenClaw。
 
+> ⚠️ **当前基线**：截至 **2026-04-13**，本教程推荐使用 **OpenClaw v2026.4.11（稳定版）**；`v2026.4.12-beta.1` 仅作为预发布参考。运行时优先使用 **Node 24**。
+
 ![OpenClaw 安装界面](https://upload.maynor1024.live/file/1771085321300_installation-interface.png)
 
 
@@ -108,7 +110,7 @@ OpenClaw在Mac上体验最好，因为：
 - 推荐 macOS 14 Sonoma 或 macOS 15 Sequoia
 
 **前置软件**：
-- Node.js 22.0.0+（会自动安装）
+- Node.js 24（推荐）/ 22.16+（兼容路径，会自动安装）
 - Homebrew（可选，用于安装依赖）
 
 ### 安装步骤
@@ -143,7 +145,7 @@ curl -fsSL https://openclaw.ai/install.sh | bash
 ```bash
 openclaw --version
 ```
-如果显示版本号（如 `2026.3.2`），说明安装成功！
+如果显示版本号（如 `2026.4.11`），说明安装成功！
 
 #### 第四步：初始化配置
 
@@ -296,7 +298,7 @@ openclaw uninstall
 - Windows 10 或 Windows 11
 
 **前置软件**：
-- Node.js 22.0.0+
+- Node.js 24（推荐）/ 22.16+（兼容路径）
 
 ### 部署方式选择
 
@@ -349,16 +351,16 @@ sudo apt update && sudo apt upgrade -y
 sudo apt install -y curl git wget build-essential
 ```
 
-#### 第四步：安装Node.js 22+
+#### 第四步：安装Node.js 24（推荐）
 
 ```bash
 # 添加NodeSource仓库
-curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
+curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
 
 # 安装Node.js
 sudo apt install -y nodejs
 
-# 验证版本（必须≥22.x）
+# 验证版本（推荐 v24.x）
 node -v
 npm -v
 ```
@@ -411,12 +413,12 @@ openclaw gateway run --port 18789
 
 适合不想使用WSL2的纯Windows用户。
 
-#### 第一步：安装Node.js 22+
+#### 第一步：安装Node.js 24（推荐）
 
 **方法一：官网下载安装**
 
 1. 访问 https://nodejs.org/zh-cn
-2. 下载Windows安装包（LTS版本22.x）
+2. 下载Windows安装包（推荐 24.x 版本）
 3. 运行安装程序，勾选「自动安装必要的工具」
 
 #### 第二步：验证Node.js安装
@@ -596,7 +598,7 @@ openclaw config set channels.feishu '{"enabled":true,"appId":"cli_xxx","appSecre
 
 ```bash
 # Ubuntu/Debian
-curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
+curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
 sudo apt-get install -y nodejs
 
 # 验证安装
@@ -744,7 +746,7 @@ openclaw onboard
    openclaw --version
    ```
 
-   如果显示版本号（如 `2026.3.2`），说明OpenClaw已预装成功。
+   如果显示版本号（如 `2026.4.11`），说明OpenClaw已预装成功。
 
 ![OpenClaw镜像](https://upload.maynor1024.live/file/1770742213992_02-openclaw-image.png)
 
@@ -1010,7 +1012,7 @@ openclaw onboard
 ### 前置要求
 
 **必需环境**：
-- Node.js 22.0.0+（必需）
+- Node.js 24（推荐）/ 22.16+（兼容路径）（必需）
 - pnpm（可选，推荐用于源码构建）
 
 **推荐配置**：
@@ -3123,11 +3125,13 @@ openclaw config set gateway.port 18790
 
 > 🔄 **保支持最新**：定期升级OpenClaw以获得新功能、性能优化和安全修复。
 
-> ⚠️ **重要提示**：目前推荐使用 **2026.3.2** 版本。2026.2.12 版本存在已知 bug（[Issue #15141](https://github.com/openclaw/openclaw/issues/15141)），会导致 heartbeat 和消息处理功能异常。
+> ⚠️ **重要提示**：目前推荐使用 **2026.4.11（稳定版）**。如果你只是想稳定跑通本教程，请不要直接把 `v2026.4.12-beta.1` 当默认基线。
+
+> 📝 **历史问题版本**：`2026.2.12` 存在已知 bug（[Issue #15141](https://github.com/openclaw/openclaw/issues/15141)），会导致 heartbeat 和消息处理功能异常。
 
 ### 推荐版本
 
-**当前推荐版本**：2026.3.2
+**当前推荐版本**：2026.4.11
 
 **已知访问题版本**：
 - ❌ 2026.2.12：Session 路径验证 bug，影响 heartbeat 和 Telegram/飞书消息处理
@@ -3202,13 +3206,13 @@ which openclaw  # 应该没有输出
 **第四步：安装新版本**
 
 ```bash
-# 安装推荐版本 2026.3.2（需要使用--force参数）
-npm install -g openclaw@2026.3.2 --force
+# 安装推荐版本 2026.4.11（需要使用--force参数）
+npm install -g openclaw@2026.4.11 --force
 ```
 > ⚠️ **版本选择说明**：  
-> - 推荐安装 2026.3.2 版本（稳定）
-> - 避免安装 2026.2.12 版本（存在 session 路径 bug）
-> - 如果需要最新功能，等待 2026.2.13+ 版本修复后再升级
+> - 教程默认按 `2026.4.11` 稳定版编写
+> - `2026.4.12-beta.1` 是预发布版，适合尝鲜和验证新能力
+> - 如果你只想稳定跑通教程，优先使用稳定版，不要把 beta 当默认基线
 
 > ⚠️ **为什么需要--force？**  
 > npm会检测到已存在的文件，使用`--force`强制覆盖。
@@ -3250,7 +3254,7 @@ openclaw channels status
 ```
 成功的输出应该显示：
 ```
-2026.3.2
+2026.4.11
 
 Runtime: running (pid xxxxx, state active)
 RPC probe: ok
@@ -3272,7 +3276,7 @@ Dashboard: http://127.0.0.1:18789/
 
 ![升级完成验证](https://upload.maynor1024.live/file/1770949103492_image-20260213101814142.png)
 
-*图：升级完成，版本更新到2026.3.2*
+*图：升级完成，版本更新到2026.4.11*
 
 ### 方式二：官方脚本升级
 
@@ -3370,7 +3374,7 @@ npm error EEXIST: file already exists
 **解决方案**：
 ```bash
 # 使用--force参数强制覆盖
-npm install -g openclaw@2026.3.2 --force
+npm install -g openclaw@2026.4.11 --force
 ```
 
 #### 访问题2：Gateway启动失败
@@ -3402,8 +3406,8 @@ current version is 2026.2.1-zh.3
 
 **解决方案**：
 ```bash
-# 升级到推荐版本 2026.3.2
-npm install -g openclaw@2026.3.2 --force
+# 升级到推荐版本 2026.4.11
+npm install -g openclaw@2026.4.11 --force
 openclaw doctor --fix
 ```
 
@@ -3508,7 +3512,7 @@ openclaw gateway restart
 
 1. **使用--force参数**：
    ```bash
-   npm install -g openclaw@2026.3.2 --force
+   npm install -g openclaw@2026.4.11 --force
    ```
 
 2. **运行doctor修复**：
@@ -3577,17 +3581,17 @@ openclaw gateway restart
 
 **解决方案**：
 1. **不要升级到 2026.2.12**
-2. **如果已升级，回退到 2026.3.2**：
+2. **如果已升级，回退到 2026.4.11**：
    ```bash
    openclaw gateway stop
    npm uninstall -g openclaw
-   npm install -g openclaw@2026.3.2 --force
+   npm install -g openclaw@2026.4.11 --force
    openclaw doctor --fix
    openclaw gateway restart
    ```
 
 **推荐做法**：
-- 使用 2026.3.2 版本（当前最稳定）
+- 使用 2026.4.11 版本（当前最稳定）
 - 等待 2026.2.13+ 版本修复后再升级
 - 关注官方 GitHub Issues 获取最新信息
 
@@ -3690,13 +3694,13 @@ curl -s https://api.github.com/repos/openclaw/openclaw/releases/latest
    - Discord社区
    - 飞书群组
 
-### 升级案例：2026.2.1-zh.3 → 2026.3.2
+### 升级案例：2026.2.1-zh.3 → 2026.4.11
 
 以下是一次真实的升级案例，供参考。
 
 **升级背景**：
 - 原版本：2026.2.1-zh.3（中文版）
-- 目标版本：2026.3.2（推荐稳定版）
+- 目标版本：2026.4.11（推荐稳定版）
 - 升级原因：获取新功能和性能优化
 
 **升级过程**：
@@ -3718,7 +3722,7 @@ curl -s https://api.github.com/repos/openclaw/openclaw/releases/latest
 
 4. **安装新版本**：
    ```bash
-   npm install -g openclaw@2026.3.2 --force
+   npm install -g openclaw@2026.4.11 --force
    ```
 
 5. **修复配置**：
@@ -3733,7 +3737,7 @@ curl -s https://api.github.com/repos/openclaw/openclaw/releases/latest
 
 7. **验证升级**：
    ```bash
-   openclaw --version  # 显示：2026.3.2
+   openclaw --version  # 显示：2026.4.11
    openclaw gateway status  # 显示：running
    ```
 

docs/02-core-features/05-knowledge-management.md

@@ -4,6 +4,8 @@
 
 > 💡 **本章节目标**：学会使用 OpenClaw构建个人知识库系统，实现网页文章节存档、GitHub项目管理、论文笔记整理和跨设备同步。
 
+> 🔄 **2026.4+ 补充说明**：本章正文仍以网页归档、GitHub整理、论文笔记为主，但最新版 OpenClaw 的“知识库”主线已经升级为三层：**Active Memory（回复前回忆）**、**Dreaming（短期转长期）**、**Memory Wiki（结构化 claim/evidence + 矛盾/新鲜度管理）**。如果你正在搭建“第二大脑”，建议把本章与官方记忆文档一起阅读。
+
 ## 📚 本章节内内容
 
 - 5.1 网页文章节存档

docs/02-core-features/07-automation-workflow.md

@@ -4,6 +4,8 @@
 
 > 💡 **本章节目标**：学会使用 OpenClaw构建自动化工作流，实现定时任务、网站监控、日报推送和循环任务配置。
 
+> 🔄 **2026.4+ 补充说明**：本章的 cron / heartbeat 例子仍然有参考价值，但官方自动化主线已扩展为 **Task Flow + Webhooks**。现在更推荐把自动化拆成三层：**定时触发**、**持久化流程**、**外部事件驱动**。如果你要做长期运行或多步骤自动化，请优先参考 Task Flow 与 Webhooks。
+
 ## 🤖 本章节内内容
 
 - 7.1 定时任务设置