夜雨聆风OpenClaw 用久了，你可能会遇到这些需求：想换一台机器重装、调试过程中配置有点乱、网关服务一直在后台跑、或只是单纯想彻底清掉所有本地状态。
这篇给你一份 全平台卸载清单（macOS / Linux / Windows / Docker），并把“只停服务”“删配置”“删工作区”三种级别讲清楚，避免误删。
开始前先选一个“卸载级别”
建议你先确认你想达到哪种效果：
仅停止运行：不卸载，只是让网关不再后台运行 卸载网关服务 + 清理本地状态：把服务、配置、缓存、会话等清掉（CLI 仍可保留） 完全移除：在上一步基础上，再卸载 CLI、删除工作区（相当于恢复到从未安装过）
如果你不确定，建议先走“卸载网关服务 + 清理本地状态”，且先做一次备份。
先备份（可选，但强烈建议）
如果你还想保留当前配置、技能、会话记录或工作区，先做备份：
openclaw backup create
情况 A：CLI 还在（推荐走一键卸载）
如果你的机器上还能运行 openclaw 命令，这是最省心的方式。
1）先做一次演练（不会真的删除）
openclaw uninstall --dry-run
2）执行卸载
openclaw uninstall
3）需要更彻底（全清）
openclaw uninstall --all --yes
它会优先处理网关服务与本地状态目录。
情况 B：CLI 不在了，但网关服务还在跑（手动卸载服务）
这种情况常见于：你先删了 CLI，或者 PATH/Node 版本变了，但 launchd/systemd 仍在拉起网关。
macOS：launchd 手动卸载
默认服务标签通常是 ai.openclaw.gateway（如果你有 profile，可能是 ai.openclaw.<profile>）。
launchctl bootout gui/$UID/ai.openclaw.gateway
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist
Linux：systemd（用户级）手动卸载
默认 unit 名通常是 openclaw-gateway.service。
systemctl --user disable --now openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload
Windows：Scheduled Task 手动卸载
默认任务名通常是 OpenClaw Gateway（如果你有 profile，会带括号）。
schtasks /Delete /F /TN "OpenClaw Gateway"
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"
清理本地状态（配置/缓存/会话）
OpenClaw 的本地状态目录默认在：
macOS / Linux： ~/.openclawWindows： %USERPROFILE%\.openclaw
如果你想把本地状态彻底清掉（包括配置、会话、缓存等），按下面方式删除（注意：这会移除本地状态）：
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
如果你用过 profile（例如 --profile），可能还有 ~/.openclaw-<profile> 这类目录，需要分别清理。
工作区要不要删？（可选）
工作区里通常是你的文章草稿、素材、生成的文件、以及 agent 的工作产物。
想保留内容：不要删工作区 想彻底归零：再删除工作区目录
示例（按你的实际路径调整）：
rm -rf ~/.openclaw/workspace
卸载 CLI（完全移除才需要）
如果你是用包管理器安装的 CLI，可以在确认“网关服务已卸载、状态已清理”后再移除 CLI：
npm rm -g openclaw
# 或 pnpm remove -g openclaw
# 或 bun remove -g openclaw
如果你安装过 macOS 应用，也可以按需移除应用目录。
Docker/容器方式安装：怎么卸载
如果你是 Docker 部署，思路是：先停容器，再决定是否删除 volume 与挂载目录。
你一般会遇到两类数据：
Bind mount（宿主机目录挂载）：配置和工作区就在宿主机目录里，删容器不会删数据 Named volume：容器删了，volume 仍会保留，除非你手动删
建议流程：
停止并删除容器（按你的 compose/脚本执行） 如果你使用了 named volume，确认不需要后再删除 volume 如果你使用 bind mount，按需删除宿主机目录（相当于删除本地状态与工作区）
卸载后自查清单（避免“看似卸载，其实还在跑”）
本机不再监听网关端口（比如 18789） 后台没有 OpenClaw Gateway 相关进程 ~/.openclaw（或 profile 目录）按你的目标被保留或清理你如果希望“完全移除”，则工作区与 CLI 也已处理
常见问题
1）我只想换一个干净的配置，但保留工作区内容
只清理状态目录即可（不要删工作区）。
2）我卸载后还是能连上 Dashboard
多半是服务没卸载干净（macOS 的 launchd / Linux 的 systemd / Windows 的计划任务还在）。按上面的“手动卸载服务”再查一遍。
3）我不确定自己是不是在远程机器上跑网关
如果你的网关其实跑在另一台服务器/树莓派上，你需要在那台机器上执行停止与清理。
