OpenClaw 完整卸载指南

在使用 OpenClaw 的过程中，你可能因为各种原因需要将其完全卸载：可能是切换到其他 AI Agent 工具，或者是想清理环境重新安装。无论原因是什么，彻底卸载 OpenClaw 并非简单的删除应用那么简单——它会在系统中留下多个组件，包括 CLI 工具、Gateway 后台服务、配置文件以及工作区数据。本文将详细介绍在不同操作系统上如何完整、彻底地卸载 OpenClaw。

卸载前的准备工作

在开始卸载之前，建议先确认你的安装方式和使用的平台。OpenClaw 支持多种安装方式：官方安装脚本（install.sh）、npm/pnpm/bun 全局安装、或者直接从 GitHub 源码运行。不同的安装方式对应的卸载步骤略有不同，但核心思路是一致的——先停止服务，再清理相关文件。

另外，如果你使用了多配置文件（通过 --profile 参数或 OPENCLAW_PROFILE 环境变量），每个配置文件都有独立的状态目录，卸载时需要分别处理。建议先回忆一下是否使用过自定义配置文件，这会影响后续的清理步骤。

方案一：CLI 还在时的推荐卸载方式

如果你的系统中 OpenClaw CLI 仍然可以正常使用，那么推荐使用官方内置的卸载工具，这是最简单、最安全的方式。

自动卸载

打开终端，执行以下命令即可完成全部卸载操作：

openclaw uninstall

这个命令会自动停止 Gateway 服务、卸载系统服务、删除配置和状态文件。整个过程是交互式的，卸载程序会提示你确认每个步骤。

非交互式卸载（适用于自动化脚本）

如果你在编写自动化脚本，或者想在 CI/CD 环境中无人值守卸载，可以使用非交互式参数：

openclaw uninstall --all --yes --non-interactive

或者使用 npx 方式（适用于尚未全局安装的情况）：

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

参数说明：--all 表示卸载所有配置文件（如果你使用了 profile），--yes 自动确认所有提示，--non-interactive 以非交互模式运行。

手动分步卸载

如果你想更精细地控制卸载过程，也可以按照以下步骤手动操作：

第一步：停止 Gateway 服务

openclaw gateway stop

第二步：卸载 Gateway 服务（根据你的操作系统）

openclaw gateway uninstall

在 macOS 上这会卸载 launchd 服务，在 Linux 上会移除 systemd 用户单元，在 Windows 上会删除计划任务。

第三步：删除状态和配置文件

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

这里使用了环境变量回退机制：如果没有设置 OPENCLAW_STATE_DIR，默认删除 ~/.openclaw 目录。

如果你在 OPENCLAW_CONFIG_PATH 设置了自定义配置文件路径（且该路径在状态目录之外），也需要手动删除该文件。

第四步：删除工作区（可选）

如果你想保留配置但删除 agent 文件，可以只删除工作区目录：

rm -rf ~/.openclaw/workspace

第五步：卸载 CLI 工具

根据你当初的安装方式，选择对应的卸载命令：

# npm 安装
npm rm -g openclaw

# pnpm 安装
pnpm remove -g openclaw

# bun 安装
bun remove -g openclaw

第六步：删除 macOS 应用（如果你使用了 macOS 桌面版）

rm -rf /Applications/OpenClaw.app

方案二：CLI 已删除但服务仍在运行

有时候你可能已经通过其他方式删除了 OpenClaw CLI，但 Gateway 后台服务仍在系统后台运行。此时需要使用系统级工具手动清理服务。

macOS（使用 launchd）

首先查看正在运行的服务：

launchctl list | grep openclaw

默认的服务标签是 ai.openclaw.gateway。如果使用了自定义配置文件，可能是 ai.openclaw.<profile>。也可能有遗留的旧版本标签 com.openclaw.*。

停止并卸载服务：

# 停止服务
launchctl bootout gui/$UID/ai.openclaw.gateway

# 删除启动代理配置文件
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

如果使用了配置文件，需要将标签和配置文件名替换为对应的 profile 名称。同时建议检查并清理任何遗留的旧版 com.openclaw.* 配置文件。

Linux（使用 systemd）

查看用户级服务：

systemctl --user list-units | grep openclaw

默认的服务名是 openclaw-gateway.service，自定义 profile 可能是 openclaw-gateway-<profile>.service。

卸载服务：

# 停止并禁用服务
systemctl --user disable --now openclaw-gateway.service

# 删除服务配置文件
rm -f ~/.config/systemd/user/openclaw-gateway.service

# 重新加载 systemd
systemctl --user daemon-reload

Windows（使用计划任务）

查看计划任务：

schtasks /Query | findstr "OpenClaw"

默认任务名是 OpenClaw Gateway，自定义 profile 是 OpenClaw Gateway (<profile>)。

删除任务：

# 删除计划任务
schtasks /Delete /F /TN "OpenClaw Gateway"

# 删除网关脚本
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"

如果使用了 profile，需要删除对应的任务名和脚本文件。

不同安装方式的额外清理

官方安装脚本安装

如果你使用的是 curl -fsSL https://openclaw.ai/install.sh | bash 或 iex 安装脚本，CLI 实际上是通过 npm install -g openclaw@latest 安装的。按照上述 npm 卸载步骤即可。

源码安装

如果你通过 git clone 克隆了 OpenClaw 仓库，然后直接运行 openclaw 或使用 bun run openclaw：

在删除仓库之前，先按照「方案一」卸载 Gateway 服务
删除克隆的仓库目录
按照上述步骤删除状态目录和工作区

多配置文件（Profile）的清理

如果你使用了多配置文件功能（通过 --profile myprofile 或设置 OPENCLAW_PROFILE=myprofile），每个 profile 都有独立的状态目录。默认位置如下：

无 profile：~/.openclaw
有 profile：~/.openclaw-<profile>

在卸载时需要分别删除每个状态目录：

# 查看所有 OpenClaw 相关目录
ls -la ~ | grep openclaw

# 逐一删除
rm -rf ~/.openclaw
rm -rf ~/.openclaw-work
rm -rf ~/.openclaw-dev  # 假设 profile 名为 "dev"

远程模式的清理

如果你使用了远程 Gateway 模式（通过 SSH 连接到远程服务器运行 OpenClaw），状态目录实际上保存在远程主机上。这种情况下需要在远程服务器上执行同样的卸载步骤：

连接到远程服务器
按照上述步骤停止 Gateway 服务
删除远程服务器上的状态目录
如果远程服务器也不再需要使用 OpenClaw，可以完全卸载远程端的 CLI

验证卸载结果

完成卸载后，建议验证一下是否还有遗留文件：

# 检查状态目录是否还存在
ls -la ~/.openclaw

# 检查 CLI 是否已移除
which openclaw

# 检查服务是否已停止（macOS）
launchctl list | grep openclaw

# 检查服务是否已停止（Linux）
systemctl --user list-units | grep openclaw

# 检查计划任务是否已删除（Windows）
schtasks /Query | findstr "OpenClaw"

如果上述命令都没有输出，说明卸载基本完成。

常见问题

问：卸载后重新安装会有影响吗？

答：只要你按照上述步骤完整删除了状态目录（~/.openclaw），重新安装不会受到任何影响。但如果你想保留配置以便后续恢复，可以只删除工作区目录，保留配置文件。

问：卸载后数据可以恢复吗？

答：一旦删除状态目录，数据将无法恢复。如果有重要数据，建议在卸载前备份 ~/.openclaw 目录。

问：为什么服务卸载后还会自动启动？

答：这通常是系统启动项没有被清理干净。请再次检查 launchd（macOS）、systemd（Linux）或计划任务（Windows）中是否还有 OpenClaw 相关的条目。

问：我想删除 OpenClaw 但保留 API 密钥供其他应用使用怎么办？

答：API 密钥通常存储在状态目录的配置文件或环境变量中。如果只是不想使用 OpenClaw，可以不卸载，只是停止服务即可。API 密钥不会因为卸载 CLI 而自动删除。

总结

OpenClaw 的完整卸载涉及多个层面：停止后台服务、卸载系统服务、删除配置文件、清理工作区、以及移除 CLI 工具。按照本文的步骤操作，你可以确保系统中的 OpenClaw 组件被彻底清除，不留任何痕迹。

如果你是通过官方安装脚本安装的，推荐使用 openclaw uninstall 命令自动完成卸载；如果是手动安装或 CLI 已被删除，则需要根据你的操作系统使用对应的系统工具手动清理服务。切记不要遗漏状态目录的清理，这是最容易被忘记但又最重要的步骤。

本文基于 OpenClaw 官方文档编写，整理时间为 2026 年 4 月。