若卸载不彻底导致重装失败，需依次验证CLI和服务清除、强制终止gateway进程、删除残留路径、重置npm环境，再按原渠道重装。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已完成 OpenClaw 卸载但需重新安装，却遇到命令残留、配置冲突或服务未终止等问题，则可能是卸载不彻底导致新安装失败。以下是确保干净重装的完整操作路径：
一、确认 OpenClaw 已完全卸载
重装前必须验证 CLI 命令、后台服务及配置目录均已清除，否则新安装可能复用旧状态，引发权限异常、端口占用或 workspace 混乱。
1、在终端中执行：which openclaw，若返回空行则 CLI 未注册；
2、执行：openclaw --version，若提示 command not found 则 CLI 已移除；
3、检查用户级 LaunchAgent：执行 ls ~/Library/LaunchAgents/ | grep -i openclaw，若无输出说明网关 plist 文件已删除；
4、确认状态目录不存在：执行 ls -d ~/.openclaw 2>/dev/null，若无输出则配置与工作区目录已清空。
二、强制终止残留 gateway 进程
即使 CLI 不可用，OpenClaw 的 gateway 服务仍可能以守护进程形式持续运行，占用 3000 端口或读取旧配置，阻碍重装初始化。
1、列出所有匹配进程：执行 ps aux | grep -i 'gateway\|openclaw'；
2、获取进程 PID 并强制终止：对每个疑似进程执行 kill -9 [PID]；
3、如使用 launchd 管理，执行：launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/ai.openclaw.gateway.plist 2>/dev/null；
4、验证端口释放：执行 lsof -i :3000 | grep LISTEN，若无输出则 3000 端口已空闲。
三、清除全部残留路径（macOS）
OpenClaw 在 macOS 上可能分散写入多个位置，仅删应用本体无法覆盖其自动生成的运行时文件与符号链接。
1、删除主配置目录：rm -rf ~/.openclaw；
将 iPhone 的 Apple Health 数据同步到 OpenClaw。只需扫描一次二维码，无需手动配置。支持 Mac、Linux 和 VPS。
2、删除 Homebrew 安装痕迹（如曾通过 brew）：rm -f /opt/homebrew/bin/openclaw /usr/local/bin/openclaw；
3、清理 npm 全局链接残留：find /usr/local/lib/node_modules -name "*openclaw*" -prune -exec rm -rf {} + 2>/dev/null；
4、清除 shell 初始化片段：检查 ~/.zshrc 或 ~/.bash_profile 中是否含 export PATH=...openclaw... 行，如有则手动删除并执行 source ~/.zshrc。
四、重装前环境重置（推荐）
Node.js 缓存、npm 权限错误或全局模块损坏可能导致重装失败，需同步清理开发环境依赖层。
1、清空 npm 缓存：npm cache clean --force；
2、重置 npm 权限（避免 EACCES 错误）：sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}；
3、卸载所有相关包名变体：npm rm -g openclaw @qingchencloud/openclaw-zh openclaw-zh；
4、验证全局模块清洁度：执行 npm list -g --depth=0 | grep -i openclaw，应无任何输出。
五、选择对应方式重装 OpenClaw
根据原始安装渠道选择匹配重装方式，避免混合安装路径引发符号链接冲突或版本错位。
1、若原为官方脚本安装：执行 curl -fsSL https://openclaw.ai/install.sh | bash；
2、若原为 npm 安装中文版：执行 npm install -g @qingchencloud/openclaw-zh@latest；
3、若原为 Homebrew 安装：执行 brew install openclaw（需先确认 tap 已添加）；
4、若需跳过交互式 onboard：安装后立即执行 openclaw onboard --install-daemon --yes --non-interactive。
