主机格调
本文目录
隐藏
OpenClaw 2026.3.11 是一次高风险升级，包含多个 Breaking Changes。本文提供从备份到验证的完整升级流程，确保你的系统平稳升级。不按这个流程走，升级等于冒险！
🚨 为什么必须谨慎升级
OpenClaw 2026.3.11 包含以下重大变更：
- Cron 通知收紧：定时任务无法发送通知，自动化任务可能静默失败
- WebSocket 安全加固：浏览器连接需来源验证，浏览器工具可能连不上
- iOS/macOS 大量更新：移动端用户需重新配置，App功能可能异常
📋 第一阶段：完整备份（10分钟）
一键备份脚本：
#!/bin/bash
BACKUP_DIR="$HOME/openclaw-backup-$(date +%Y%m%d-%H%M%S)"
mkdir -p "$BACKUP_DIR"
# 备份主配置文件
cp "$HOME/.openclaw/openclaw.json" "$BACKUP_DIR/"
# 备份完整配置目录
cp -r "$HOME/.openclaw" "$BACKUP_DIR/openclaw-full-config"
# 备份工作区
cp -r "$HOME/.openclaw/workspace" "$BACKUP_DIR/"
# 备份自定义技能
cp -r "$HOME/.openclaw/skills" "$BACKUP_DIR/" 2>/dev/null || true
# 记录版本和状态
openclaw --version > "$BACKUP_DIR/version.txt"
openclaw config get > "$BACKUP_DIR/config-snapshot.json"
echo "✅ 备份完成！位置: $BACKUP_DIR"
备份内容清单：
- openclaw.json - 主配置文件
- openclaw-full-config/ - 完整配置目录
- workspace/ - 工作区文件
- skills/ - 自定义技能
- version.txt - 版本信息
- config-snapshot.json - 配置快照
🔍 第二阶段：升级前检查（15分钟）
检查1：Cron 任务（最关键！）
# 列出所有 cron 任务
openclaw cron list
# 检查 cron 配置
openclaw config get cron
⚠️ 重点：3.11 版本会收紧 Cron 通知机制，必须记录哪些任务依赖通知。
检查2：Gateway Auth（3.7+ 要求）
# 检查当前 auth 配置
openclaw config get gateway.auth
# 如未设置，立即修复
openclaw config set gateway.auth.mode token
# 或
openclaw config set gateway.auth.mode password
检查3：Tools Profile
# 检查当前 profile
openclaw config get tools.profile
# 如果不是 coding 或 full，立即修改
openclaw config set tools.profile coding
检查4：Browser 配置（WSL2/远程用户特别注意）
# WSL2 用户必须设置
openclaw config set browser.relayBindHost "0.0.0.0"
🚀 第三阶段：执行升级（10分钟）
步骤1：停止 Gateway
# 优雅停止
openclaw gateway stop
# 等待确认停止
sleep 10
# 如有残留，强制停止
pkill -f openclaw-gateway
步骤2：执行升级
# 方式A：官方脚本（推荐）
curl -fsSL https://openclaw.ai/install.sh | bash
# 方式B：npm
npm i -g openclaw@latest
步骤3：关键修复（3.11 必须！）
# 这是 3.11 升级的关键步骤！
# 修复 Cron 配置迁移、兼容性问题
openclaw doctor --fix
# 查看详细输出
openclaw doctor --verbose
⚠️ 警告：漏了这一步，定时任务可能无法发送通知！
步骤4：启动 Gateway
openclaw gateway start
# 或确保干净启动
openclaw gateway restart
✅ 第四阶段：升级后验证（15分钟）
基础验证
# 1. 版本确认
openclaw --version
# 期望输出: openclaw 2026.3.11
# 2. 健康检查
openclaw health
# 3. 配置验证
openclaw config validate
Cron 任务验证（3.11 重点！）
# 列出所有 cron 任务
openclaw cron list
# 手动触发一次测试
openclaw cron run <job-id>
# 确认收到通知（Telegram/Discord等）
验证清单
- [ ] 版本号 = 2026.3.11
- [ ] openclaw health = 全绿
- [ ] File 工具可用
- [ ] Exec 工具可用
- [ ] Cron 任务通知正常
- [ ] 频道连接正常
🔴 常见问题及解决方案
问题1：Gateway 启动失败
症状：Error: cron delivery configuration incompatible
解决：
# 必须运行 doctor
openclaw doctor --fix
# 如仍失败，检查日志
openclaw logs --lines 50
问题2：Cron 任务不发送通知
解决：
# 手动修复
openclaw config patch '{"cron": {"delivery": {"mode": "direct"}}}'
# 重启 Gateway
openclaw gateway restart
问题3：Browser 工具连不上
# 检查配置
openclaw config set browser.relayBindHost "127.0.0.1"
# WSL2 用户
openclaw config set browser.relayBindHost "0.0.0.0"
🔙 快速回滚方案
如果升级后问题无法解决：
# 1. 停止
openclaw gateway stop
# 2. 安装旧版本（替换为你的旧版本号）
npm i -g [email protected]
# 3. 恢复配置
cp ~/openclaw-backup-*/openclaw.json ~/.openclaw/
cp -r ~/openclaw-backup-*/openclaw-full-config/* ~/.openclaw/
# 4. 启动
openclaw gateway start
# 5. 验证
openclaw --version
openclaw health
📊 3.11 新功能速览
- OpenRouter 临时模型：Hunter Alpha、Healer Alpha 免费试用
- iOS 首页改进：实时 Agent 概览，优化连接指示器
- macOS 聊天升级：模型选择器，思维链级别保存
- Ollama 一键配置：完整设置向导，智能模型推荐
- 多模态记忆索引：支持图像和音频索引（实验性）
- Discord 自动归档：可配置 1小时/1天/3天/1周
- ACP 会话恢复：resumeSessionId 参数支持
🎯 一句话总结
备份 → 检查 Cron/Auth → 升级 → doctor --fix → 验证
不按这个流程走，升级等于冒险！
参考链接：
- 官方文档：https://docs.openclaw.ai/install/updating
- GitHub Releases：https://github.com/openclaw/openclaw/releases
- 社区支持：https://discord.gg/clawd
精准关键词：OpenClaw 3.11、OpenClaw升级、OpenClaw备份 长尾关键词：OpenClaw 3.11升级教程、OpenClaw备份脚本、Cron通知修复 问题关键词：OpenClaw升级失败怎么办、openclaw doctor --fix怎么用、OpenClaw如何回滚
未经允许不得转载：主机格调 » OpenClaw 3.11升级完全教程：从备份到验证的完整指南
