卸载

先移除服务并删除选定的本地数据，然后再移除任何剩余的 CLI 安装。删除 state（状态数据）时也会移除该目录内嵌套的安装文件。请选择：

简易路径：如果 openclaw 仍已安装。
手动移除服务：如果 CLI 已不存在但服务仍在运行。

简易路径（CLI 仍已安装）¶

该命令会尝试独立执行所请求的清理范围，如果有任何范围失败或被阻止，则返回非零状态。服务拆除仍是删除 state 和工作区的安全闸门；如果该闸门失败，则会保留这些数据范围，同时仍会尝试应用清理。部分清理会被明确报告，绝不会随后给出无条件的完成结果。

openclaw uninstall

交互式提示默认只预选 Gateway 服务。如需完整本地移除，请在提示中同时选择 state、工作区和应用，或运行 openclaw uninstall --all。除非你同时选择 --workspace，否则移除 state 会保留已配置的工作区目录。

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

openclaw uninstall --dry-run --all

非交互式（自动化 / npx）。请谨慎使用，并仅在确认清理范围后使用：

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

标志：--service、--state、--workspace、--app 分别选择单个范围；--all 选择全部四个。

与 openclaw uninstall --state 不同，手动删除 state 不会保留工作区。在删除文件之前，请先成功停止并卸载服务。在手动删除 state 或 prefix 之前，将你想保留的任何配置移动到该目录之外。

停止 gateway 服务：

openclaw gateway stop

卸载 gateway 服务（launchd/systemd/schtasks）：

openclaw gateway uninstall

决定是否保留工作区。

在手动删除之前，将所有你想保留的已配置工作区（包括 ~/.openclaw/workspace）移动到 state 目录之外。否则，该目录内的工作区会随之一并删除；它们无需单独删除。

删除 state 和配置：

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

如果你将 OPENCLAW_CONFIG_PATH 设置为 state 目录之外的自定义位置，也请删除该文件。在重新创建父目录后恢复保留的工作区，或在重新安装时配置它们的新路径。

仅当你还想删除外部工作区中的 agent 文件时，才删除该工作区：

rm -rf /path/to/external/workspace

按照下面的安装所有者移除 CLI。
如果你安装了 macOS 应用：

rm -rf /Applications/OpenClaw.app

如果你使用了 profile（--profile / OPENCLAW_PROFILE），请针对每个 state 目录重复步骤 3-4（默认目录为 ~/.openclaw-<profile>）。
在远程模式下，state 目录位于 gateway 主机上，因此也需要在该主机上执行步骤 1-4。

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

如果 gateway 服务仍在运行但 openclaw 不存在，请使用此方法。

macOS (launchd)¶

默认标签为 ai.openclaw.gateway（使用 profile 时为 ai.openclaw.<profile>）：

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

如果你使用了 profile，请将标签和 plist 文件名替换为 ai.openclaw.<profile>。

Linux（systemd 用户单元）¶

默认单元名称为 openclaw-gateway.service（或 openclaw-gateway-<profile>.service）。在从非常旧的安装升级而来的机器上，可能仍存在重命名前的 clawdbot-gateway.service 单元；openclaw uninstall / openclaw gateway uninstall 会自动检测并移除它。

systemctl --user disable --now openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-gateway.service{,.bak}
systemctl --user daemon-reload

Windows（计划任务）¶

默认任务名称为 OpenClaw Gateway（或 OpenClaw Gateway (<profile>)）。该任务会在你的 state 目录下启动一个无窗口的 gateway.vbs 脚本，该脚本进而运行 gateway.cmd；请同时删除两者。

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

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

移除 CLI ¶

请先移除 Gateway 服务，然后再删除 checkout（源码检出）、启动器或 prefix。首先检查解析出的命令及其目标；如果所有权不明确，请保留原位。有关自定义 checkout 和 prefix 选项，请参阅安装器内部机制。

安装方式	CLI 所有者及移除方式
全局 npm（`install.sh` / `install.ps1` 默认）	使用拥有此安装的 npm/prefix 运行 `npm rm -g openclaw`。
全局 pnpm 或 Bun	仅运行匹配的命令：`pnpm remove -g openclaw` 或 `bun remove -g openclaw`。
`install.sh --install-method git`	检查 `~/.local/bin/openclaw`；仅当该启动器指向预期的检出目录时才将其移除，然后移除该检出目录。
`install.ps1 -InstallMethod git`	检查 `%USERPROFILE%\.local\bin\openclaw.cmd`；仅当该启动器指向预期的检出目录时才将其移除，然后移除该检出目录。
`install-cli.sh`（npm 或 Git）	检查 `<prefix>/bin/openclaw`。前缀默认为 `~/.openclaw`；`--prefix` / `OPENCLAW_PREFIX` 可覆盖它。仅在保留数据后才移除专用前缀；Git 模式还需要单独移除其检出目录。
直接源码检出	仅移除你自己添加的包装器/符号链接，然后移除检出目录。保留由其他安装所拥有的垫片（shim）。

Git 检出默认位于 ~/openclaw（Windows 上为 %USERPROFILE%\openclaw）；请以启动器的实际目标为准，包括自定义的 --git-dir / -GitDir 或 OPENCLAW_GIT_DIR。在 POSIX 系统上，OPENCLAW_HOME 可以更改默认检出目录。仅按上文所选方式移除状态/工作区。

在删除前缀之前，请将你想保留的任何状态、配置和工作区移到其外部。切勿整体删除共享前缀：只移除经过验证的 OpenClaw 文件，保留共享的 Node 运行时、包和工具。

如果已安装补全功能，请仅从所选 shell 配置文件中移除其 # OpenClaw Completion 代码块和 OpenClaw 的 source 行。仅当旧式 openclaw completion 的 source/eval 行不含其他命令时才移除它；保留周围内容。

仅当没有其他命令使用安装程序添加的 PATH 条目时才移除它。保留共享的 bin 目录，如 ~/.local/bin。在 Windows 上，同样的规则适用于 %LOCALAPPDATA%\OpenClaw\deps 下的便携式 Node/MinGit 及其 PATH 条目。

打开一个新的 shell，然后检查 command -v openclaw（PowerShell：Get-Command openclaw -ErrorAction SilentlyContinue）。如果命令仍然能被解析，请检查它：可能是第二次安装或外部包装器残留。

安装概览
迁移指南
openclaw uninstall — 命令参考与标志

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw

卸载