卸载

两种路径：

• 如果仍安装了 openclaw，使用简单路径。
• 如果 CLI 已不存在但服务仍在运行，使用手动移除服务。

简单路径（CLI 仍已安装）

推荐：使用内置卸载器：

openclaw uninstall

使用 CLI 时，状态移除会保留已配置的工作区目录，除非你同时选择 --workspace。

预览将被移除的内容（安全）：

openclaw uninstall --dry-run --all

非交互式（自动化 / 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 设置到了状态目录之外的自定义位置，也请删除该文件。 如果你想保留状态目录中的工作区，例如 ~/.openclaw/workspace，请先将它移到别处，再运行 rm -rf，或者选择性删除状态内容。

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）

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

launchctl bootout gui/$UID/ai.openclaw.gatewayrm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

如果你使用了配置档，请将标签和 plist 名称替换为 ai.openclaw.<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>)）。 任务脚本位于你的状态目录下，名为 gateway.cmd；当前安装也可能创建一个无窗口的 gateway.vbs 启动器，任务计划程序会运行它，而不是直接打开 gateway.cmd。

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

如果你使用了配置档，请删除匹配的任务名称，以及 ~\.openclaw-<profile> 下的 gateway.cmd / gateway.vbs 文件。

常规安装与源码检出

常规安装（install.sh / npm / pnpm / bun）

如果你使用了 https://openclaw.ai/install.sh 或 install.ps1，CLI 是通过 npm install -g openclaw@latest 安装的。 用 npm rm -g openclaw 移除它（如果你是用对应方式安装的，也可以用 pnpm remove -g / bun remove -g）。

源码检出（git clone）

如果你从仓库检出运行（git clone + openclaw ... / bun run openclaw ...）：

1. 在删除仓库之前先卸载 Gateway 网关服务（使用上面的简单路径或手动移除服务）。
2. 删除仓库目录。
3. 按上文所示移除状态 + 工作区。

相关内容

• 安装概览
• 迁移指南