维护
卸载
本节介绍如何完全卸载 OpenClaw。有两种路径：
- 简单路径：如果
openclaw仍已安装。 - 手动服务移除：如果 CLI 已删除但服务仍在运行。
简单路径（CLI 仍已安装）
推荐使用内置卸载程序：
openclaw uninstall
非交互式（自动化 / npx）：
openclaw uninstall --all --yes --non-interactive
npx -y openclaw uninstall --all --yes --non-interactive
手动步骤（效果相同）：
- 停止网关服务：
openclaw gateway stop
- 卸载网关服务（launchd/systemd/schtasks）：
openclaw gateway uninstall
- 删除状态 + 配置：
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
如果你将 OPENCLAW_CONFIG_PATH 设置为状态目录之外的自定义位置，也请删除该文件。
- 删除工作空间（可选，会移除智能体文件）：
rm -rf ~/.openclaw/workspace
- 移除 CLI 安装（选择你使用的方式）：
npm rm -g openclaw
pnpm remove -g openclaw
bun remove -g openclaw
- 如果你安装了 macOS 应用：
rm -rf /Applications/OpenClaw.app
注意：
- 如果你使用了配置文件（
--profile/OPENCLAW_PROFILE），请为每个状态目录重复步骤 3（默认为~/.openclaw-<profile>）。 - 在远程模式下，状态目录位于网关主机上，因此也需要在那里运行步骤 1-4。
手动服务移除（CLI 未安装）
如果网关服务持续运行但 openclaw 已丢失，请使用此方法。
macOS（launchd）
默认标签为 ai.openclaw.gateway（或 ai.openclaw.<profile>；旧版 com.openclaw.* 可能仍然存在）：
launchctl bootout gui/$UID/ai.openclaw.gateway
rm -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.service
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --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。
正常安装 vs 源码检出
正常安装（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 ...）：
- 在删除仓库之前卸载网关服务（使用上述简单路径或手动服务移除）。
- 删除仓库目录。
- 如上所述移除状态 + 工作空间。