这篇解决什么：卸载与残留，不是迁移或更新通道
搜「OpeClaw 卸载」「干净卸载残留」的人，多半是不再用、要重装清场，或卸完发现设置还在、启动项还在。
本文只讲：标准卸载顺序、常见配置残留位置（以 AppData / Application Support 为例）、重装前怎么核对、以及和备份迁移、更新失败、打不开怎么分流。换机要带走工作流 → 配置备份迁移；检查更新失败或更新后异常 → 更新失败文；双击没反应 → 打不开排查。
目录字段、卸载入口名称一律以当前版本设置为准；下文路径只是常见示例，不替代你本机实际文件夹名。
卸载前先决定：扔掉还是带走
若以后还要同一套 Provider、Skills 来源说明或工作区路径列表，先按配置备份迁移文做完整备份（或设置页导出，若当前版本提供），再进入卸载。密钥建议抄进密码管理器，勿明文丢进聊天群。
若目标就是本机清零、不再恢复旧配置，仍建议至少记下关于页版本号与平台，方便对照下载页重装。删目录不可逆，项目文件在工作区真实路径里，一般不会随配置目录一起消失——别把工作区当「残留」误删。
发布包从哪下、该装哪一构建，先看下载页。卸载目的是清客户端与本地配置一致性，不是顺便换不明安装源。
- 要保留工作流 → 先备份，再卸载。
- 要彻底清场 → 备份可跳过，但删前确认没有误选到项目目录。
- 仍卡在更新通道 → 先读更新失败文，不要把「整盘卸载」当唯一手段。
标准卸载：先退出，再走系统入口
固定顺序：完全退出客户端（含托盘/后台助手，若当前版本有）→ 用系统自带的「应用与功能」/「卸载」或 macOS 把应用移到废纸篓 → 确认主程序目录已不在。不要在进程仍占用文件时强删安装目录。
公司机若由 IT 统一管控安装，按策略走卸载工单，不要关安全软件硬删。卸载向导若提供「同时删除用户数据」勾选项，以向导文案为准；未勾选时配置目录通常仍会留下。
主程序没了但桌面快捷方式还在，删快捷方式即可，不等于配置已清。
残留配置：AppData / Application Support 常见位置
干净卸载要额外核用户数据目录。常见示例：Windows `%AppData%/OpeClaw`（资源管理器地址栏可粘贴），macOS `~/Library/Application Support/OpeClaw`。若你机器上名称不同、或多一层厂商文件夹，以当前版本文档或设置里「打开配置目录」类入口为准，不要照搬第三方脚本写死的路径。
退出客户端后再删或重命名该目录。重命名（例如加 `.bak`）比直接删除更稳：重装后若发现问题还能对照。缓存、日志子目录若单独存在，同样以当前版本实际结构为准，不要猜「一定叫 cache」。
LocalAppData、临时目录或安装目录旁的 updater 残留，偶发会留下半截更新文件；若你刚经历更新失败，清这类残留前可并读更新失败文，避免和「主动卸干净」步骤搅在一起。
重装前核对：干净不等于「随便装一包」
确认：主程序已卸、配置目录已按你的目标处理（删/改名/保留备份）、没有残留进程占用旧路径。再到下载页取与平台匹配的当前构建，装完先看关于页版本，再发一条短测。
重装后若设置全空——说明残留确实清掉了，属预期；要把旧工作流找回，用事先做好的备份按迁移文恢复，而不是从不明网盘捞「旧配置包」。
重装后双击无反应、闪退、杀毒隔离 → 打不开排查。界面正常但 401/429 → API Key 文。代理环境连不上 → 代理排查。
和备份迁移 / 更新失败 / 打不开怎么分流
主动卸干净、重装前清残留、确认 AppData / Application Support 示例路径下无旧配置 → 留在本文。
换机、重装后要找回工作流、导出/拷贝配置 → 配置备份迁移；清残留前若仍需配置，先走那边。
检查更新失败、更新后异常、半截包 → 更新失败与干净重装。从未启动成功、杀毒/运行库/Gatekeeper → 打不开排查。空闲仍占满 CPU/内存、怀疑残留进程 → CPU/内存占用排查。安装包入口 → 下载页；场景与边界 → FAQ。
卸载与残留对照表（不新增结论）
下表只归纳上文顺序；不改变「路径以当前版本为准」「迁移先备份再卸载」，以及更新通道问题仍走更新失败文的分流。
| 现象 | 优先动作 | 常见误操作 |
|---|---|---|
| 只想卸干净不再用 | 系统卸载 + 核配置目录残留 | 以为卸主程序等于配置已删 |
| 卸完还想找回工作流 | 先走备份迁移再卸载 | 先删 AppData 再后悔 |
| 更新失败后「顺便全删」 | 先读更新失败文，备份后清残留 | 不备份连删 Key 与半截包 |
| 重装后双击无反应 | 打不开排查 | 只反复卸装不查杀毒/运行库 |
| 不知装哪一版 | 对照下载页发布状态 | 用聊天群「卸载专用清理包」 |
菜单名与真实配置路径以当前客户端为准；本文示例路径不保证与你本机文件夹名一字不差。
干净卸载与残留清理常见问题
系统卸载程序删掉了，配置是不是也一起没了？
不一定。许多桌面客户端只卸主程序，AppData / Application Support 下的配置目录仍会留下。要干净卸载，需在完全退出后按当前版本路径核残留；路径名以你机器上实际目录为准。
干净卸载和「更新失败清残留」有什么区别？
更新失败清残留是为了修好仍要继续用的客户端；本文是主动卸干净、或卸完再重装前的清理。更新通道卡死、半截包、版本对不上 → 走更新失败排查，不要把「先整盘删配置」当成唯一修复手段。
想换机保留工作流，该不该先干净卸载？
不该先删。换机或重装后要找回 Provider、提示词路径、Skills 备注，先走配置备份迁移文完成拷贝/导出，再卸载。卸载后再备份，配置可能已经不完整。
卸干净后从哪里重装？
回本站下载页核对当前平台发布状态与安装包，避免聊天群短链。重装后若双击无反应，转打不开排查；场景与权限边界见 FAQ。