卸载与常见问题

卸载清理与常见问题

本节介绍 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"
备份文件同样包含密钥等敏感信息，请妥善保管，切勿上传到公开仓库或分享给他人。若曾绑定模型厂商的密钥，卸载后建议到对应平台删除旧密钥并重新生成，避免密钥继续被调用产生费用。

一键卸载（推荐）

  1. 执行官方全量卸载命令，自动停止服务、移除自启并清理核心配置
  2. 卸载 CLI 工具（脚本安装方式通过 npm 全局安装）
  3. 重启电脑，确保所有后台进程彻底关闭
openclaw uninstall --all --yes --non-interactive
npm uninstall -g openclaw

手动兜底清理（命令失效时）

若 openclaw 命令已不可用，说明 CLI 已部分删除，可在以管理员身份打开的 PowerShell 中手动完成剩余清理。若你安装时指定了其他数据目录，请将下方 $env:USERPROFILE\.openclaw 替换为实际目录（如 D:\.openclaw）。

# 若安装时指定了其他数据目录，请将下方 $env:USERPROFILE\.openclaw 替换为实际目录（如 D:\.openclaw）

# 1. 删除开机自启计划任务
schtasks /Delete /F /TN "OpenClaw Gateway"

# 2. 删除自启脚本
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"

# 3. 删除配置与数据目录
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"

# 4. 清理 npm 全局残留
npm uninstall -g openclaw

常见问题

Q：执行安装命令后没有反应？

  • 确认已以管理员身份运行 PowerShell
  • 确认网络可正常访问 openclaw.ai
  • 脚本安装会先检测并安装 Node.js 等依赖，请耐心等待

Q：提示密钥无效？

  • 确认密钥前后没有多余空格
  • 确认选择的模型厂商与密钥所属厂商一致
  • 确认密钥有可用额度，未被厂商禁用

Q：如何更换模型厂商？

执行 openclaw config 打开配置文件，修改模型厂商与对应密钥后重启 OpenClaw 即可。

Q：如何重启 OpenClaw？

修改配置或遇到偶发异常时，建议重启服务使配置生效：

# 一键重启（推荐）
openclaw restart

# 或手动重启网关服务
openclaw gateway restart

# 重启后确认服务状态；仍有问题可运行健康检查
openclaw status
openclaw doctor

Q：运行 openclaw 命令提示「无法加载 openclaw.ps1，因为在此系统上禁止运行脚本」？

这是 Windows 的执行策略限制：部分电脑默认禁止运行 PowerShell 脚本，而 npm 安装的 openclaw 命令正是以 .ps1 脚本形式提供的，因此被系统拦截。该问题与安装本身无关，执行下方命令允许运行本地脚本即可解决（仅对当前用户生效，无需管理员权限）：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
请以该命令为主，执行一次后长期有效：后续所有 openclaw 命令、网关启动以及开机自启（自启任务会在系统启动时新开 PowerShell 会话）都依赖此设置——OpenClaw 的网关启动脚本内部同样会调用 .ps1 脚本，即使通过 gateway.cmd 启动也会被策略拦截。

以下两种方式仅适用于当前会话或手动执行命令，<strong>不能</strong>覆盖网关启动与开机自启：① 直接输入 openclaw.cmd 运行（npm 同时生成了 cmd 版本命令，可绕过 npm 生成的 openclaw.ps1 拦截，适合手动执行 openclaw config、openclaw dashboard 等命令）；② 在当前窗口临时放行：Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process（窗口关闭即失效，重新打开后需再次执行）。