OpenClaw 卸载指南

完整卸载OpenClaw,包括Gateway服务、状态目录和配置

简单方式(CLI仍已安装)

如果 OpenClaw CLI 仍然可用,使用内置卸载程序是最简单的方法:

交互式卸载

bash
openclaw uninstall

非交互式卸载(自动化/npx)

bash
openclaw uninstall --all --yes --non-interactive
⚠️ 注意事项

非交互式模式会跳过所有确认提示,请确保你知道自己在做什么。

🛠️ 手动步骤(效果相同)

如果你需要更精细的控制,或 CLI 不可用,可以按照以下步骤手动卸载:

  1. 停止 Gateway 服务
    bash
    openclaw gateway stop
  2. 卸载 Gateway 服务

    根据系统不同,移除 launchd/systemd/schtasks 服务:

    bash
    openclaw gateway uninstall
  3. 删除状态+配置目录
    bash
    rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
  4. 删除工作区(可选)
    bash
    rm -rf ~/.openclaw/workspace
  5. 移除 CLI 安装

    根据你使用的包管理器选择对应命令:

    bash
    # npm
    npm rm -g openclaw
    
    # pnpm
    pnpm remove -g openclaw
    
    # bun
    bun remove -g openclaw
  6. 删除 macOS 应用(如有)
    bash
    rm -rf /Applications/OpenClaw.app

🔧 手动服务移除(CLI未安装)

如果 CLI 已卸载但需要清理残留的服务,请根据操作系统执行以下操作:

macOS(launchd)

bash
# 停止并移除服务
launchctl bootout user/$(id - u)/com.openclaw.gateway

# 删除 plist 文件
rm ~/Library/LaunchAgents/com.openclaw.gateway.plist

Linux(systemd)

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

# 删除 service 文件
rm ~/.config/systemd/user/openclaw-gateway.service

Windows(计划任务)

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

# 删除 gateway.cmd(如有)
del "%LOCALAPPDATA%\openclaw\gateway.cmd"

📦 普通安装 vs 源码检出

普通安装(install.sh/npm/pnpm/bun)

通过包管理器安装的 OpenClaw,使用以下命令移除:

bash
npm rm -g openclaw

源码检出(git clone)

从源码构建安装的 OpenClaw,按以下顺序清理:

  1. 先卸载服务:openclaw gateway uninstall
  2. 再删除仓库目录:rm -rf /path/to/openclaw
  3. 最后移除状态+工作区:rm -rf ~/.openclaw
⚠️ 清理顺序很重要

务必先卸载服务,再删除文件。如果顺序颠倒,可能导致系统残留无效的服务配置。