文章总结： Openclaw3.22版本更新后出现UI界面缺失问题，作者建议暂勿升级，并提供了从旧版复制文件、版本降级及源码构建三种修复方案。同时，文章详述了针对macOS、Linux及Windows系统的卸载与服务移除操作指南，涵盖内置卸载命令与手动清理服务、配置文件的具体步骤，为遇到故障的用户提供了实用的排查与解决路径。 综合评分： 84 文章分类： 实战经验,解决方案,安全工具

Openclaw最新版本3.22翻车，是研究下卸载和降级的时候了

网安杂谈 网安杂谈

网安杂谈

2026年3月24日 10:51 山东

昨天捣鼓想重装一下openclaw，正好3.22版本更新了，结果装完以后UI界面都看不到了。一开始还以为是自己哪配置错了，捣鼓一晚上也没解决。后来发现原来问题出在3.22版本身上，坑太多了。在此提醒，一定不要着急升级！那这一次就研究下怎么彻底删除和降级吧。

一、3.22版本修补

方案一：从旧版本文件包中复制缺失文件

这个方案不需要装任何构建工具，直接从 v2026.3.13的包里把缺失的文件复制过来，重启后，Dashboard 应该就回来了。

cd /tmpnpm pack [email protected] -xzf openclaw-2026.3.13.tgzcp -r package/dist/control-ui $(npm prefix -g)/lib/node_modules/openclaw/dist/openclaw gateway restart

方案二：版本降级

鉴于新版本问题很多，最直接的办法是降级，降级不会丢失配置，数据和设置是独立的。

npm install -g [email protected] gateway restart

方案三：从源码构建

如果想用最新版，又想自己修：

git clone --depth 1 https://github.com/openclaw/openclaw.git tmp/openclaw-srccd /tmp/openclaw-srcpnpm installpnpm ui:buildcp -r /tmp/openclaw-src/dist/control-ui ~/.npm-global/lib/node_modules/openclaw/dist/openclaw gateway restart

不过这个方案需要本地有 Node.js 环境，执行时间也长一些。

二、卸载方法

两种方式：

• 如果 openclaw 仍已安装，使用简单方式。
• 如果 CLI 已删除但服务仍在运行，使用手动服务移除。

#

(一)简单方式（CLI 仍已安装）

推荐：使用内置卸载程序：

openclaw uninstall

非交互式（自动化 / npx）：

openclaw uninstall --all --yes --non-interactivenpx -y openclaw uninstall --all --yes --non-interactive

手动步骤（效果相同）：

1. 停止 Gateway 网关服务：

openclaw gateway stop

2. 卸载 Gateway 网关服务（launchd/systemd/schtasks）：

openclaw gateway uninstall

3. 删除状态 + 配置：

rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

如果将OPENCLAW_CONFIG_PATH 设置为状态目录外的自定义位置，也请删除该文件。

4.删除工作区（可选，移除智能体文件）：

rm -rf ~/.openclaw/workspace

5.移除 CLI 安装（选择你使用的那个）：

npm rm -g openclawpnpm remove -g openclawbun remove -g openclaw

6. 如果安装了 macOS 应用：

rm -rf /Applications/OpenClaw.app

注意事项：

• 如果使用了配置文件（--profile / OPENCLAW_PROFILE），对每个状态目录重复步骤 3（默认为 ~/.openclaw-<profile>）。
• 在远程模式下，状态目录位于 Gateway 网关主机上，因此也需要在那里运行步骤 1-4。

（二）手动服务移除（CLI 未安装）

如果 Gateway 网关服务持续运行但openclaw缺失，请使用此方法。

macOS（launchd）

默认标签是bot.molt.gateway（或bot.molt.<profile>；旧版 com.openclaw.* 可能仍然存在）：

launchctl bootout gui/$UID/bot.molt.gatewayrm -f ~/Library/LaunchAgents/bot.molt.gateway.plist

如果使用了配置文件，请将标签和 plist 名称替换为 bot.molt.<profile>。如果存在任何旧版 com.openclaw.* plist，请将其移除。

Linux（systemd 用户单元）

默认单元名称是 openclaw-gateway.service（或 openclaw-gateway-<profile>.service）：

systemctl --user disable --now openclaw-gateway.servicerm -f ~/.config/systemd/user/openclaw-gateway.servicesystemctl --user daemon-reload

Windows（计划任务）

默认任务名称是 OpenClaw Gateway（或 OpenClaw Gateway (<profile>)）。 任务脚本位于你的状态目录下。

schtasks /Delete /F /TN "OpenClaw Gateway"Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"

如果使用了配置文件，请删除匹配的任务名称和 ~\.openclaw-<profile>\gateway.cmd。

免责声明：

本文所载程序、技术方法仅面向合法合规的安全研究与教学场景，旨在提升网络安全防护能力，具有明确的技术研究属性。

任何单位或个人未经授权，将本文内容用于攻击、破坏等非法用途的，由此引发的全部法律责任、民事赔偿及连带责任，均由行为人独立承担，本站不承担任何连带责任。

本站内容均为技术交流与知识分享目的发布，若存在版权侵权或其他异议，请通过邮件联系处理，具体联系方式可点击页面上方的联系我。

本文转载自：网安杂谈 网安杂谈 网安杂谈《Openclaw最新版本3.22翻车，是研究下卸载和降级的时候了》