OpenClaw 全平台卸载指南（Mac / Linux / Windows）

OpenClaw 是一款强大的本地运行 AI Agent 系统。无论您是因为需要重新安装、遇到安装错误、清理本地数据，还是由于环境迁移需要卸载 OpenClaw，本指南都将为您提供 Mac、Linux 和 Windows 三大平台的完整卸载方法。

卸载组件概览

OpenClaw 的安装通常包含以下核心组件，彻底卸载需要确保这些组件都被删除：

• OpenClaw CLI：命令行交互工具。
• Gateway 服务：后台运行的核心服务。
• 本地 Agent 数据：Agent 运行过程中产生的数据。
• 配置文件：存储用户偏好和 API 密钥等。
• Docker 容器：如果您采用了 Docker 部署方式。

一、通用卸载方法（所有平台优先推荐）

如果您的系统中仍然可以使用 openclaw 命令，优先使用官方提供的内置卸载工具。这是最简单且最安全的方式。

1. 基本卸载

执行以下命令开始卸载流程：

openclawuninstall

2. 完整卸载（推荐用于自动化或彻底清理）

如果您希望在无需人工干预的情况下删除所有相关组件，请执行：

openclawuninstall--all--yes--non-interactive

该命令会自动处理以下内容：

• 移除 OpenClaw CLI
• 停止并删除 Gateway 服务
• 清除本地配置文件和 Agent 数据
• 终止所有相关的后台进程

注意：如果内置命令由于 CLI 损坏而无法执行，请参考下文针对各平台的手动卸载步骤。

二、Mac 系统手动卸载步骤

Mac 系统通常通过 Node.js 环境运行，并使用 launchd 管理后台服务。

1. 停止并删除服务

首先停止正在运行的 Gateway 服务，并移除其在 launchd 中的注册信息。

• 停止服务：openclaw gateway stop
• 禁用服务：launchctl bootout gui/$UID/ai.openclaw.gateway
• 删除配置文件：rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

2. 卸载 CLI 程序

根据您安装时使用的包管理器，选择对应的卸载命令：

• npm: npm uninstall -g openclaw
• pnpm: pnpm remove -g openclaw
• bun: bun remove -g openclaw

3. 清理配置与数据

删除默认的配置目录以及可能存在的特定 Profile 目录：

rm-rf~/.openclaw

rm-rf~/.openclaw-dev

rm-rf~/.openclaw-prod

4. 移除 Mac App

如果您安装了 GUI 版本的 Mac 应用程序，请将其从应用程序目录中删除：

rm-rf/Applications/OpenClaw.app

三、Linux 系统手动卸载步骤

Linux 系统通常使用 systemd 来管理 OpenClaw 的后台服务。

1. 停止并删除 systemd 服务

执行以下命令以确保服务完全停止并从系统中移除：

openclawgatewaystop

sudosystemctlstopopenclaw-gateway

sudosystemctldisableopenclaw-gateway

sudorm/etc/systemd/system/openclaw-gateway.service

sudosystemctldaemon-reload

2. 卸载 CLI

使用 Node.js 包管理器移除全局安装：

•npm uninstall -g openclaw 或 pnpm remove -g openclaw

3. 删除本地数据

清理 Linux 系统中常见的配置和数据存放路径：

rm-rf~/.openclaw

rm-rf~/.config/openclaw

rm-rf~/.local/share/openclaw

四、Windows 系统手动卸载步骤

Windows 环境下，OpenClaw 通常作为 Windows 服务运行。

1. 停止并删除 Windows 服务

请以管理员身份打开 PowerShell 并执行：

Stop-Serviceopenclaw-gateway

sc delete openclaw-gateway

2. 卸载 CLI

根据您的包管理器执行：

• npm: npm uninstall -g openclaw
• pnpm: pnpm remove -g openclaw

3. 清理配置与缓存

Windows 的配置文件和缓存通常分布在用户目录和 Local AppData 中：

• 删除配置：Remove-Item -Recurse -Force $env:USERPROFILE.openclaw
• 删除缓存：Remove-Item -Recurse -Force $env:LOCALAPPDATA\openclaw

五、Docker 版本卸载（适用于所有平台）

如果您是通过 Docker 部署的 OpenClaw，请按照以下步骤清理容器和镜像：

1. 停止容器：docker stop openclaw
2. 删除容器：docker rm openclaw
3. 删除镜像：先通过 docker images 找到镜像 ID，然后执行 docker rmi。

六、验证卸载是否成功

完成上述步骤后，您可以通过以下命令验证系统是否已完全清理：

检查项

验证标准：如果上述命令均没有任何输出或提示“未找到”，则说明卸载已彻底完成。

七、常见问题排查

1. 卸载后 openclaw 命令仍然存在

这通常是因为 PATH 环境变量中仍残留有 CLI 可执行文件。请使用 which (Mac/Linux) 或 where (Windows) 定位文件路径并手动删除。

2. npm 卸载失败

如果您使用了 nvm、fnm 或 volta 等 Node.js 版本管理工具，请确保您在安装 OpenClaw 时所使用的对应 Node 版本环境下执行卸载命令。

八、总结

彻底卸载 OpenClaw 的核心在于“五个清理”：

4CLI 清理：移除全局安装包。

5服务清理：停止并删除后台注册的服务。

6配置清理：删除 ~/.openclaw 等配置目录。

7数据清理：清除 Agent 内存及本地数据库。

8环境清理：处理 Docker 容器或 Shell 配置文件（如 .zshrc）中的残留项。

完成以上步骤后，您的系统将恢复到安装 OpenClaw 之前的纯净状态。

留言系统类型可以提供一键卸载脚本