昨天把 OpenClaw 从 v2.1 升级到 v2.3，记录下过程和遇到的问题。
升级方法
docker pull openclaw/openclaw:v2.3
docker-compose down && docker-compose up -d
简单粗暴，但建议先备份 data 目录。
主要变化
- 新的 Skill API：v2.3 改了 Skill 的注册方式，旧的
skill.yaml格式不兼容。如果你有自定义 Skill，需要按新格式改一下 - 性能提升：官方说提升 30%，实际体感确实快了一些，特别是 Skill 的调度速度
- 安全修复：修了那个 Gateway 未授权访问的漏洞（CVE-2026-25253），强烈建议升级
- 新增 Gemini 2.0 支持：可以用 Gemini 2.0 Flash了
踩坑
1. 配置文件迁移
v2.3 的 config.yaml 格式变了，llm 部分从扁平结构改成了嵌套结构。旧配置能用但会有 warning，建议手动迁移。
2. Skill 不兼容
我写的代码审查 Skill 挂了，因为 context.llm.chat() 的参数变了。花了一个小时改好。
3. 数据库迁移
升级后第一次启动会自动迁移数据库，如果数据量大可能要等几分钟。千万别中途 kill。
总体来说 v2.3 是一个值得升级的版本，但要做好备份和测试。