如何卸载OpenClaw ?

卸载 OpenClaw 助手不只是删除一个文件夹。它通常会在系统后台运行服务(Daemon)、占用特定端口,并在隐藏目录中存储敏感的 API 密钥和聊天记录 。

为了确保彻底停用并防止隐私泄露,建议按照以下步骤操作。

1. 使用内置命令卸载(首选方案)

如果你的终端还能运行 openclaw 命令,这是最省事的办法。它会自动尝试关掉后台服务并清理配置 。

在终端输入:openclaw uninstall

系统会询问你是否要删除所有数据。如果想彻底告别,建议选“全部删除” 。
如果你想在脚本中静默执行,可以使用强制参数:

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

如果 openclaw 命令已经失效:
你可以利用 npx 直接调用官方最新的卸载脚本,无需安装:

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

2. 各平台手动清理步骤

如果自动化工具没能清理干净,或者你之前是手动安装的,请根据你的系统进行以下操作。

Linux / WSL2

OpenClaw 在 Linux 上通常作为一个用户级的 systemd 服务运行 。

  • 停用服务:

    1
    systemctl --user disable --now openclaw-gateway.service 
  • 删除服务文件:

    1
    rm -f ~/.config/systemd/user/openclaw-gateway.service
  • 然后运行

    1
    systemctl --user daemon-reload 

WSL2 用户注意:如果发现端口依然被占用,建议在 Windows 的 PowerShell 里运行 wsl –shutdown 彻底重置环境 。

macOS

macOS 除了命令行工具,可能还安装了带有系统权限的 OpenClaw.app 菜单栏应用 。

  • 卸载后台服务:
    1
    2
    launchctl bootout gui/$UID/ai.openclaw.gateway
    rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist
  • 移除应用:直接把 /Applications/OpenClaw.app 移进废纸篓 。
  • 清理权限:在“系统设置”->“隐私与安全性”中,检查并移除 OpenClaw 曾获得的辅助功能、屏幕录制等授权 。

Windows (原生)

如果你是在 Windows 上直接运行,它通常通过“任务计划程序”启动 。
删除计划任务:以管理员身份打开 PowerShell,运行

1
schtasks /Delete /F /TN "OpenClaw Gateway"

清理启动脚本:删除 %USERPROFILE%\.openclaw\gateway.cmd 文件 。

3. 彻底抹除敏感数据

OpenClaw 会在你的用户目录下创建一个隐藏文件夹 .openclaw(部分旧版本可能叫 .clawdbot),这里是数据残留的“重灾区” 。
需要手动删除的路径:

  • 状态目录:~/.openclaw。这里存有 openclaw.json 主配置,里面经常能看到明文的 API 密钥 。
  • 工作区:~/.openclaw/workspace。这里存有 AI 的记忆文件(MEMORY.md)和性格设定(SOUL.md) 。
  • 登录凭据:~/.openclaw/credentials/。这里面可能有 WhatsApp 或 Telegram 的登录 Session,不删掉的话,相当于在该机器上留下了账号后门 。
    直接运行删除命令:
    rm -rf ~/.openclaw(如果用了多配置文件,记得检查 ~/.openclaw-* 格式的文件夹)

4.安全审计:撤销云端授权

这一步最重要,但经常被忽略。 删掉本地代码并不能终止云端 API 的计费或账号连接 。

  • 撤销 API Key:去 OpenAI、Anthropic (Claude) 或 Google Gemini 的后台,把给 OpenClaw 专用的那个 API Key 直接删掉或禁用。
  • 解除聊天平台连接:WhatsApp:在手机端打开 WhatsApp,点击“已连接的设备”,找到“OpenClaw”或对应的浏览器图标,手动登出 。Telegram:找 @BotFather 撤销机器人 Token 。
  • 检查网络隧道:如果你开了 Tailscale 穿透,记得在 Tailscale 控制台把对应的节点移除 。

5. 卸载检查清单

操作完成后,可以用这些命令确认系统已经变干净了:

检查项目 命令 预期结果
程序是否还在 openclaw –version command not found
端口是否释放 `netstat -ano findstr :18789 (Win) / sudo lsof -i :18789` (Mac/Linux)
服务是否彻底停用 `ps aux grep openclaw`
数据是否删除 ls -d ~/.openclaw No such file or directory

如果一切正常,OpenClaw 就已经从你的电脑中彻底退役了。