更新OpenClaw版本

约束限制

• UniAgent状态或者网关状态非运行中时，不支持自动更新版本。
• 用户自行安装的OpenClaw版本不支持自动更新版本，请参考手动更新版本操作。
• 购买L实例OpenClaw镜像后，如果修改过默认的OpenClaw部署目录，则不支持自动更新版本，请参考手动更新版本操作。
• 2026.1.30及之前的OpenClaw镜像版本，不支持自动更新版本，请参考手动更新版本操作。

操作须知

• 自动更新版本预计需要1-15分钟不等，请您耐心等待。更新期间，OpenClaw网关服务暂停，已配置的机器人将不可正常对话，应用管理页面暂不可操作。更新后模型(Models)、通道(Channels)、技能(Skills)和记忆均不会丢失。
• 自动更新版本可能会失败，失败后系统会自动回退至旧版本，若回退失败将导致OpenClaw不可用，请参考手动更新版本操作或者提交工单。
• 请确保磁盘空间充足，空间不足时会导致自动更新版本失败。
• 请勿在自动更新版本过程中进行重复更新版本的操作，可能会导致版本更新失败。
• 请勿在自动更新版本过程中对L实例进行其他操作，如关机、创建镜像、重置密码等，可能会导致自动更新版本失败。
• 请勿在自动更新版本过程中，在操作系统内对OpenClaw进行修改配置等操作，可能会导致自动更新版本失败。

前提条件

已购买安装了OpenClaw应用镜像的Flexus L实例。

自动更新版本

1. 登录Flexus应用服务器L实例控制台。
2. 单击目标L实例资源卡片上的“立即配置”，进入应用管理页面。

   如果页面未显示“立即配置”，请单击资源卡片，进入资源详情页面，在左侧列表中单击“应用管理”。

3. 单击基础信息中OpenClaw版本号右侧的“更新版本”。
   

   当UniAgent状态和网关状态均为运行中，且没有“更新版本”按钮时，表示当前版本已经是最新版本。

   

4. 确认更新版本后单击“确定”，请耐心等待更新完成。

   

5. 更新完成后，可以查看到OpenClaw版本已更新至最新版本。

   

手动更新版本

您也可以通过重装系统的方式，将L实例的OpenClaw版本更新至系统支持的最新版本。

• 重装操作系统会清除系统盘数据，包括系统盘上的系统分区和所有其它分区，请做好数据备份。
• 在重装操作系统前，如果您需要保留当前OpenClaw的记忆，请务必对OpenClaw的记忆等数据进行备份，方便重装之后进行恢复。

  如果无需保留OpenClaw记忆，可以直接执行步骤3。

• 在重装操作系统后，需要重新配置模型、通道等信息。
• 2026.1.30及之前的OpenClaw镜像版本，升级后无法恢复OpenClaw记忆，请谨慎操作。如果无需保留OpenClaw记忆，可以直接执行步骤3，通过重装系统的方式升级版本并重新配置OpenClaw。

正常情况下，OpenClaw会把有价值的记忆保存在OpenClaw的workspace目录下，包含以下重要文件：

• 机器人设：SOUL.md
• 日常记录：memory/YYYY-MM-DD.md
• 长期记忆：MEMORY.md（如有）
• 技能目录：skills

因此在重装系统前，需要把整个workspace文件夹先下载到本地备份，以便重装系统后恢复记忆数据。此处通过CloudShell的文件管理功能实现数据的上传下载。

1. 备份及OpenClaw记忆数据。
   1. 登录Flexus应用服务器L实例控制台。
   2. 重置L实例密码。

      L实例无初始密码，创建L实例后，如需登录云主机，请先设置L实例的密码。如果已经设置过密码，请跳过此步骤。

      在资源卡片上，单击图标，单击“重置密码”，根据界面提示设置L实例的密码。

      

      更多详情请参见重置Flexus L实例密码。

   3. 单击资源卡片上的“远程登录”按钮，在弹出的登录窗口中，单击“CloudShell登录”。

      

      更多登录方式请参见登录方式概述。

   4. 根据界面提示，输入用户名密码登录Flexus L实例。用户名为root，密码为步骤1.b设置的L实例密码。此处以公网连接方式为例。

      

      请确认安全组中来源为CloudShell代理IP的远程端口（SSH默认端口为22）已经放开。各区域的CloudShell代理IP可能不同，请以CloudShell配置界面显示为准。

      • 如果未放开，请执行步骤1.e后再单击“连接”。
      • 如果已放开，单击“连接”，连接成功后执行步骤1.f。

      

      更多CloudShell登录详情请参见通过CloudShell登录Linux系统Flexus L实例。

   5. 在L实例资源卡片上，单击图标，单击“配置安全组规则 > 添加规则”。添加一条规则，允许来自CloudShell代理IP的流量通过22端口。

      

   6. 执行以下命令，将workspace目录整体压缩备份到/srv/workspace目录下。

      sudo bash -c '[ -d "/home/openclaw" ] && SOURCE_DIR="/home/openclaw/.openclaw" || SOURCE_DIR="/root/.openclaw"; if ! command -v zip >/dev/null 2>&1; then echo "Installing zip..."; apt-get update -qq && apt-get install -y -qq zip || { echo "ERROR: Failed to install zip."; exit 1; }; fi; if [ -d "$SOURCE_DIR" ]; then echo "Source directory found: $SOURCE_DIR"; sudo mkdir -p /srv/workspace; sudo rm -rf /srv/workspace/*; for dir in "$SOURCE_DIR/workspace"*; do [ -d "$dir" ] && sudo cp -r "$dir" /srv/workspace/; done; if [ -d "/srv/workspace" ] && [ "$(ls -A /srv/workspace)" ]; then cd /srv && zip -r workspace.zip workspace && echo "Backup completed: /srv/workspace.zip"; else echo "No workspace directories found to backup."; exit 1; fi; else echo "Source directory not found: $SOURCE_DIR"; exit 1; fi'

      

      如果您的文件目录不是默认的OpenClaw镜像目录，请根据实际情况对以上命令进行修改。

   7. 在左侧目录树中选择srv目录，选择workspace.zip文件，单击鼠标右键，单击"下载"，选择本地路径进行备份。

      

   8. 在浏览器下载列表中，可以查看已下载的备份文件。

      

2. 保存机器人别名，以备重装系统后再次配置。如果机器人没有别名，则跳过此步骤。
   1. 登录Flexus应用服务器L实例控制台。
   2. 单击目标L实例资源卡片上的“立即配置”，进入应用管理页面。

      如果页面未显示“立即配置”，请单击资源卡片，进入资源详情页面，在左侧列表中单击“应用管理”。

   3. 在通道配置下，保存所有已配置机器人的别名。

      

3. 重装L实例操作系统。
   1. 登录Flexus应用服务器L实例控制台。
   2. 在资源卡片上单击图标，单击“重装系统”，根据界面提示勾选“立即关机”并设置登录凭证。阅读并勾选协议后单击“确定”。

      

   3. 当L实例再次为运行中时，表示重装系统已完成。进入应用配置页面，待UniAgent状态和网关状态均为运行中时，可以查看当前OpenClaw版本已更新为最新版本。

      

   4. 重装系统后需要重新配置对接的模型和通道，详情请参考配置OpenClaw应用。
      

      如果重装系统前的机器人有别名，那么新配置的机器人别名必须和重装系统前的机器人别名相同，否则记忆恢复会失败。

4. 恢复OpenClaw记忆数据。
   1. 再次使用CloudShell方式登录L实例。
   2. 在左侧目录树中，选择srv目录，单击鼠标右键，单击“上传文件”，将步骤1.g中保存到本地的备份文件上传至srv目录下。

      

   3. 执行以下命令，使用备份的workspace目录替换新版本OpenClaw的空白workspace目录。

      sudo bash -c 'if ! command -v unzip >/dev/null 2>&1; then echo "Installing unzip..."; apt-get update -qq && apt-get install -y -qq unzip || { echo "ERROR: Failed to install unzip."; exit 1; }; fi; if [ ! -f "/srv/workspace.zip" ]; then echo "Error: /srv/workspace.zip not found."; exit 1; fi; echo "Extracting workspace.zip..."; mkdir -p /tmp/workspace-extract && unzip -q "/srv/workspace.zip" -d "/tmp/workspace-extract" || { echo "ERROR: Failed to extract workspace.zip."; exit 1; }; if [ ! -d "/tmp/workspace-extract/workspace" ]; then echo "Warning: No 'workspace' directory found in archive."; exit 1; fi; SOURCE_DIR="/tmp/workspace-extract/workspace"; TARGET_DIR="/home/openclaw/.openclaw"; if [ ! -d "$TARGET_DIR" ]; then echo "Target directory does not exist: $TARGET_DIR"; exit 1; fi; echo "Replacing workspace directories in $TARGET_DIR..."; for dir in $SOURCE_DIR/workspace*; do [ -d "$dir" ] && { echo "Copying $dir to $TARGET_DIR"; sudo cp -r "$dir" "$TARGET_DIR" --remove-destination; }; done; echo "All workspace directories replaced successfully."; rm -rf "/tmp/workspace-extract"'

      

      如果您的文件目录不是默认的OpenClaw镜像目录，请根据实际情况对以上命令进行修改。

   4. 返回L实例控制台的应用管理页面，单击“重启”，使OpenClaw网关重新加载workspace目录。
   5. 请耐心等待，待网关状态再次变为运行中时，记忆恢复完成。

      

5. 验证记忆恢复效果。

   您可以在机器人聊天对话框中询问一个与记忆相关的问题，如果机器人回答正确则记忆恢复正常。此处以钉钉机器人为例。

   

常见问题

• 自动更新版本时，报错“升级失败，回退成功”。

  自动更新版本失败后系统会自动回退至旧版本，您可以远程登录L实例云主机，执行以下命令查看升级日志，确认失败原因。

  vi /var/log/openclaw-upgrade.log

  若回退失败将导致OpenClaw不可用，请参考手动更新版本操作或者提交工单。

• 自动更新版本时，报错“升级前备份失败”。

  更新版本过程中.openclaw文件备份失败，可能是系统盘空间不足，您可以通过升级规格的方式，扩大系统盘容量之后再执行更新版本。

• 自动更新版本时，报错“升级工具pnpm安装失败”。

  更新版本过程中发现pnpm工具缺失，并且安装失败。您可以远程登录L实例云主机，执行以下命令查看升级日志，确认失败原因，或者提交工单。

  vi /var/log/openclaw-upgrade.log

• Flexus L实例无初始密码，创建Flexus L实例后，如需登录云主机，请先设置Flexus L实例的密码。更多详情请参见重置Flexus L实例密码。
• Flexus L实例登录方式请参见登录方式概述。