# 升级OpenClaw版本 OpenClaw社区版本处于快速更新迭代的阶段，为了能让用户尽快体验最新版本的OpenClaw，L实例提供的OpenClaw应用镜像支持升级至与当前L实例能力相匹配的稳定的OpenClaw版本。您可以参考本文档升级OpenClaw版本。 ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png) L实例当前支持升级的OpenClaw最新版本请以界面提示为准。 #### 约束限制 - OpenClaw网关状态为运行中时，才支持自动升级版本。 - 用户自行安装的OpenClaw版本不支持自动升级版本，请参考[手动升级版本]操作。 - 购买L实例OpenClaw镜像后，如果修改过默认的OpenClaw部署目录，则不支持自动升级版本，请参考[手动升级版本]操作。 - 2026.1.30及之前的OpenClaw镜像版本，不支持自动升级版本，请参考[手动升级版本]操作。 #### 操作须知 - 自动升级版本预计需要1-15分钟不等，请您耐心等待。升级期间，OpenClaw网关服务暂停，已配置的机器人将不可正常对话，应用管理页面暂不可操作。升级后模型(Models)、通道(Channels)、技能(Skills)和记忆均不会丢失。 - 自动升级版本可能会失败，失败后系统会自动回退至旧版本，若回退失败将导致OpenClaw不可用，请参考[手动升级版本]操作或者[提交工单](https://console.huaweicloud.com/ticket/?&locale=zh-cn#/ticketindex/createIndex)。 - 请确保磁盘空间充足，空间不足时会导致自动升级版本失败。 - 请勿在自动升级版本过程中进行重复升级版本的操作，可能会导致版本升级失败。 - 请勿在自动升级版本过程中对L实例进行其他操作，如关机、创建镜像、重置密码等，可能会导致自动升级版本失败。 - 请勿在自动升级版本过程中，在操作系统内对OpenClaw进行修改配置等操作，可能会导致自动升级版本失败。 #### 前提条件 已购买安装了OpenClaw应用镜像的Flexus L实例。 #### 自动升级版本 1. 登录[Flexus应用服务器L实例控制台](https://console.huaweicloud.com/smb/?/resource/list)。 2. 单击目标L实例资源卡片上的"立即配置"，进入应用详情页面。 如果页面未显示"立即配置"，请单击资源卡片，进入资源详情页面，在左侧列表中单击"应用详情"。 3. 单击OpenClaw应用管理中的"版本升级"。 ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png) OpenClaw网关状态为运行中，且"版本升级"按钮置灰时，表示当前版本已经是最新版本。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002586537641.png "点击放大") 4. 确认升级版本后单击"确定"，请耐心等待升级完成。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002555857838.png "点击放大") 5. 升级完成后，可以查看到OpenClaw版本已升级至最新版本。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002555698506.png "点击放大") #### 手动升级版本 您也可以通过重装系统的方式，将L实例的OpenClaw版本升级至系统支持的最新版本。 ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/caution_3.0-zh-cn.png) - 重装操作系统会清除系统盘数据，包括系统盘上的系统分区和所有其它分区，请做好数据备份。 - 在重装操作系统前，如果您需要保留当前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实例控制台](https://console.huaweicloud.com/smb/?/resource/list)。 2. 重置L实例密码。 L实例无初始密码，创建L实例后，如需登录云主机，请先设置L实例的密码。如果已经设置过密码，请跳过此步骤。 在资源卡片上，单击![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002568749715.png)图标，单击"重置密码"，根据界面提示设置L实例的密码。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002586377957.png) 更多详情请参见[重置Flexus L实例密码](https://support.huaweicloud.com/usermanual-flexusl/instance_admin_0002.html)。 3. 单击资源卡片上的"远程登录"按钮，在弹出的登录窗口中，单击"CloudShell登录"。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002555698314.png) 更多登录方式请参见[登录方式概述](https://support.huaweicloud.com/usermanual-flexusl/server_login_0001.html)。 4. 根据界面提示，输入用户名密码登录Flexus L实例。用户名为root，密码为步骤[1.b]设置的L实例密码。此处以公网连接方式为例。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002568665297.png "点击放大") **请确认安全组中来源为CloudShell代理IP的远程端口（SSH默认端口为22）已经放开。** 各区域的CloudShell代理IP可能不同，请以CloudShell配置界面显示为准**。** - 如果未放开，请执行步骤[1.e]后再单击"连接"。 - 如果已放开，单击"连接"，连接成功后执行步骤[1.f]。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002537749978.png "点击放大") 更多CloudShell登录详情请参见[通过CloudShell登录Linux系统Flexus L实例](https://support.huaweicloud.com/usermanual-flexusl/server_login_0003.html)。 5. 在L实例资源卡片上，单击![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002568669697.png)图标，单击"配置安全组规则 \> 添加规则"。添加一条规则，允许来自CloudShell代理IP的流量通过22端口。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002586539017.png "点击放大") 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' ``` ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png) 如果您的文件目录不是默认的OpenClaw镜像目录，请根据实际情况对以上命令进行修改。 7. 在左侧目录树中选择srv目录，选择workspace.zip文件，单击鼠标右键，单击"下载"，选择本地路径进行备份。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002568666573.png) 8. 在浏览器下载列表中，可以查看已下载的备份文件。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002568750075.png "点击放大") 2. 保存机器人别名，以备重装系统后再次配置。如果机器人没有别名，则跳过此步骤。 1. 登录[Flexus应用服务器L实例控制台](https://console.huaweicloud.com/smb/?/resource/list)。 2. 单击目标L实例资源卡片上的"立即配置"，进入应用详情页面。 如果页面未显示"立即配置"，请单击资源卡片，进入资源详情页面，在左侧列表中单击"应用详情"。 3. 在通道配置下，保存所有已配置机器人的别名。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002586379665.png "点击放大") 3. 重装L实例操作系统。 1. 登录[Flexus应用服务器L实例控制台](https://console.huaweicloud.com/smb/?/resource/list)。 2. 在资源卡片上单击![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002537909924.png)图标，单击"重装系统"，根据界面提示勾选"立即关机"并设置登录凭证。阅读并勾选协议后单击"确定"。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002555860270.png "点击放大") 3. 当L实例再次为运行中时，表示重装系统已完成。进入应用配置页面，待OpenClaw网关状态为运行中时，可以查看当前OpenClaw版本已升级为最新版本。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002586380497.png "点击放大") 4. 重装系统后需要**重新配置对接的模型和通道** ，详情请参考[配置OpenClaw应用](https://support.huaweicloud.com/bestpractice-flexusl/flexusl_bp_0007.html)。 ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/caution_3.0-zh-cn.png) 如果重装系统前的机器人有别名，那么新配置的机器人别名必须和重装系统前的机器人别名相同，否则记忆恢复会失败。 4. 恢复OpenClaw记忆数据。 1. 再次使用CloudShell方式登录L实例。 2. 在左侧目录树中，选择srv目录，单击鼠标右键，单击"上传文件"，将步骤[1.g]中保存到本地的备份文件上传至srv目录下。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002537908160.png) 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"' ``` ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png) 如果您的文件目录不是默认的OpenClaw镜像目录，请根据实际情况对以上命令进行修改。 4. 返回L实例控制台的应用管理页面，单击"重启"，使OpenClaw网关重新加载workspace目录。 请耐心等待，待网关状态再次变为运行中时，记忆恢复完成。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002555700878.png "点击放大") 5. 验证记忆恢复效果。 您可以在机器人聊天对话框中询问一个与记忆相关的问题，如果机器人回答正确则记忆恢复正常。此处以钉钉机器人为例。 ![](https://support.huaweicloud.com/bestpractice-flexusl/zh-cn_image_0000002538108524.png) #### 常见问题 - 自动升级版本时，报错"升级失败，回退成功"。 自动升级版本失败后系统会自动回退至旧版本，您可以远程登录L实例云主机，执行以下命令查看升级日志，确认失败原因。 ``` vi /var/log/openclaw-upgrade.log ``` 若回退失败将导致OpenClaw不可用，请参考[手动升级版本]操作或者[提交工单](https://console.huaweicloud.com/ticket/?&locale=zh-cn#/ticketindex/createIndex)。 - 自动升级版本时，报错"升级前备份失败"。 升级版本过程中.openclaw文件备份失败，可能是系统盘空间不足，您可以通过升级规格的方式，扩大系统盘容量之后再执行升级版本。 - 自动升级版本时，报错"升级工具pnpm安装失败"。 升级版本过程中发现pnpm工具缺失，并且安装失败。您可以远程登录L实例云主机，执行以下命令查看升级日志，确认失败原因，或者[提交工单](https://console.huaweicloud.com/ticket/?&locale=zh-cn#/ticketindex/createIndex)。 ``` vi /var/log/openclaw-upgrade.log ``` ![](https://support.huaweicloud.com/bestpractice-flexusl/public_sys-resources/note_3.0-zh-cn.png) - Flexus L实例无初始密码，创建Flexus L实例后，**如需登录云主机，请先设置Flexus L实例的密码。** 更多详情请参见[重置Flexus L实例密码](https://support.huaweicloud.com/usermanual-flexusl/instance_admin_0002.html)。 - Flexus L实例登录方式请参见[登录方式概述](https://support.huaweicloud.com/usermanual-flexusl/server_login_0001.html)。