# 教程同步：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**。对新手影响最大的不是“又多了几个按钮”，而是几条**会让旧命令直接失效或误导**的变化。

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

```bash
# 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
```

官方安装入口仍推荐：

```bash
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`
- 登录示例：

```bash
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