教程同步：OpenClaw v2026.6.8 → v2026.9.3

日期：2026-09-10（上海时区）
官方包版本校验：npm view openclaw version → 2026.9.3
官方发布页：https://docs.openclaw.ai/releases/2026.9.3
GitHub Release：https://github.com/openclaw/openclaw/releases/tag/v2026.9.3（发布于 2026-09-08）

为什么要同步

本仓库上一轮主线校对停在 v2026.6.8。中间经过 v2026.7.1、v2026.8.1（OpenClaw 2.0）、v2026.8.2、v2026.9.1/9.2，到 v2026.9.3。对新手影响最大的不是“又多了几个按钮”，而是几条会让旧命令直接失效或误导的变化。

复制前先做的升级步骤（推荐）

# 0) 升级 Node（硬性要求）
# 需要：Node 24.16+ 或 Node 26.1+（推荐 26）
node -v

# 1) 备份
cp -r ~/.openclaw ~/.openclaw.backup-$(date +%Y%m%d-%H%M%S)

# 2) 升级 OpenClaw
openclaw update --tag 2026.9.3 --yes
# 或：npm install -g openclaw@2026.9.3 --allow-scripts=openclaw

# 3) 迁移/修复（跨大版本必做）
openclaw update repair
openclaw doctor --fix

# 4) 验证
openclaw --version
openclaw gateway status
openclaw models status
openclaw channels status

官方安装入口仍推荐：

curl -fsSL https://openclaw.ai/install.sh | bash

对教程步骤有实质影响的 Breaking / 迁移

1) Node 运行时抬高（v2026.9.3）

• 引擎要求：>=24.16.0 <25 || >=26.1.0
• Node 22、旧 24.x / 未达标的 26.x 不再支持
• 先升 Node，再升 OpenClaw，可避免 SQLite 文本截断等问题

2) 会话与转录进入 SQLite（v2026.8.1）

• 升级前务必备份 ~/.openclaw
• 迁移后的新会话，在旧版本上可能不可见——不要随便降级

3) OpenAI 路由迁移（v2026.8.1）

• 旧写法：codex/*、openai-codex/*
• 新主线：openai/*
• 处理：openclaw doctor --fix
• 登录示例：

openclaw models auth login --provider openai --set-default
# API Key 场景：
openclaw models auth login --provider openai --method api-key

具体模型 ID 以 openclaw models list / Control UI 为准，不要死记过期型号。

4) OpenProse 移除（v2026.8.1）

• 内置 OpenProse 插件与 /prose 已移除
• 先：openclaw doctor --fix 清理残留配置
• 若仍需要 prose 工作流：按官方文档安装上游 Agent Skill（不是恢复内置插件）
• 参考：https://docs.openclaw.ai/prose

5) Skills / Workshop（v2026.8 → v2026.9.3）

• 优先：openclaw skills list|check|…
• Workshop：每个 Agent 一份可写技能集合；旧 skills.workshop.allowSymlinkTargetWrites 已退役
• 教程里出现的整串 clawhub install …：历史参考，不要当成 2026.9 默认入门步骤

6) Doctor 与更新恢复（v2026.9.x）

• 检查：openclaw doctor
• 修复：openclaw doctor --fix（--repair 同义）
• 只读巡检：openclaw doctor --lint
• 更新可预演/恢复；可用 openclaw update status 查看报告

本仓库本次已同步的内容

• README.md：版本徽章、基线说明、差异表、重要版本提示
• 关键章节：1/2/5/7/8/10~15（安装升级、模型认证、自动化提示、媒体/实战基线）
• appendix/A-command-reference.md：OpenAI 登录示例；clawhub 标为历史参考
• 本更新说明：updates/2026-09-10-v2026.9.3.md

仍可能带历史味道、请带着标签阅读的章节

• 第 3/4/6/9 章：部分截图、渠道步骤与案例仍可能偏旧；思路可参考，命令请先对照官方文档
• tutorials/ 下一键部署文：第三方面板/镜像版本可能滞后，以面板实际版本为准
• 纸质书：系统重写版，不等同于本仓库即时 npm 基线

官方阅读入口

• Releases 索引：https://docs.openclaw.ai/releases/
• 安装：https://docs.openclaw.ai/install
• Doctor：https://docs.openclaw.ai/cli/doctor
• Models：https://docs.openclaw.ai/cli/models
• OpenAI provider：https://docs.openclaw.ai/providers/openai