卸载小龙虾
彻底卸载与清理
本节介绍 OpenClaw（小龙虾）的卸载清理方法。卸载分两种情况：若 openclaw 命令仍可正常执行，走「一键卸载（推荐）」即可；若命令已不可用但服务仍在后台运行，请走「手动兜底清理」。
官方卸载文档：docs.openclaw.ai/zh-CN/install/uninstall，可查看官方提供的卸载说明。
完全卸载
卸载前备份有价值的信息
卸载会删除数据目录下的全部数据。默认数据目录为 $env:USERPROFILE\.openclaw；若安装时通过环境变量 OPENCLAW_STATE_DIR 指定了其他目录（如 D:\.openclaw），数据则实际位于该目录。下方路径请按实际数据目录替换。若其中有值得保留的内容（如技能、工作区文件、配置），请先备份。核心目录如下：
- 技能目录：$env:USERPROFILE\.openclaw\skills（全局共享技能，仅安装过全局技能后才会出现）与 $env:USERPROFILE\.openclaw\workspace\skills（工作区技能）
- 工作区：$env:USERPROFILE\.openclaw\workspace（含对话记忆、智能体文件等）
- 配置文件：$env:USERPROFILE\.openclaw\openclaw.json（含模型与密钥等配置）
备份示例（复制整个 .openclaw 目录到桌面备份文件夹）：
# 若安装时指定了其他数据目录，请将源路径替换为实际目录（如 D:\.openclaw）
Copy-Item -Recurse -Force "$env:USERPROFILE\.openclaw" "$env:USERPROFILE\Desktop\openclaw-backup"备份文件同样包含密钥等敏感信息，请妥善保管，切勿上传到公开仓库或分享给他人。若曾绑定模型厂商的密钥，卸载后建议到对应平台删除旧密钥并重新生成，避免密钥继续被调用产生费用。
一键卸载（推荐）
只要 openclaw 命令仍可正常执行，就优先使用官方内置的卸载程序：它会自动停止网关服务、移除开机自启，并清理状态数据。
# 1. 先预览将移除哪些内容（安全，不会真正删除任何数据）
openclaw uninstall --dry-run --all
# 2. 确认无误后执行全量卸载
openclaw uninstall --all --yes --non-interactive
# 3. 卸载 CLI 工具（脚本安装方式通过 npm 全局安装）
npm uninstall -g openclaw- --all 会一次性移除网关服务、状态数据、工作区和应用；如只想移除其中一部分，可分别用 --service、--state、--workspace、--app 指定
- 移除状态数据时会默认保留已配置的工作区目录，只有同时选中 --workspace 才会一并删除工作区（含对话记忆、智能体文件）
- --yes --non-interactive 表示全程不再询问确认，适合自动化脚本或 npx 场景，执行前请务必确认作用范围
卸载完成后建议重启电脑，确保所有后台进程彻底关闭。
手动兜底清理（命令失效时）
若 openclaw 命令已不可用，但后台服务或开机自启可能仍在运行，可在以管理员身份打开的 PowerShell 中手动完成剩余清理。若你安装时指定了其他数据目录，请将下方 $env:USERPROFILE\.openclaw 替换为实际目录（如 D:\.openclaw）。
# 若安装时指定了其他数据目录，请将下方 $env:USERPROFILE\.openclaw 替换为实际目录（如 D:\.openclaw）
# 1. 删除开机自启计划任务（使用 profile 时任务名为 "OpenClaw Gateway (<profile>)")
schtasks /Delete /F /TN "OpenClaw Gateway"
# 2. 删除自启脚本（gateway.vbs 会再调用 gateway.cmd，两者都要删除）
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd" -ErrorAction SilentlyContinue
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.vbs" -ErrorAction SilentlyContinue
# 3. 删除配置与数据目录
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
# 4. 清理 npm 全局残留
npm uninstall -g openclaw