夜雨聆风副标题： 别再盲目折腾了！这份“彻底重装手册”，专治各种不服，建议全文背诵
大家好 。
作为一个刚接触 AI 没多久的小白，我平时对代码一窍不通，连命令行长啥样都认不全。 只要不涉及敲代码，我就是个快乐的普通人。
但今天下午，我遇到了一个不讲武德的对手——OpenClaw 本地部署。
起因很简单：我的阿里云百炼 Coding Plan 更新了最新的大模型 Qwen 3.6-PLUS！
云服务器上的 OpenClaw 已经能无缝用上这个最新模型了，听说更聪明了！
但是，本地部署默认不能直接更新到这个版本！
我心痒痒："不行！我也要在本地电脑上整一个！让我家的小龙虾（本地机器人）也用上最新的模型，体验一把更新后的爽感！"
结果？ 我经历了人生中最"过山车"的一个下午：从自信满满 → 怀疑人生 → 气哭 → 最后笑醒！
现在，我把这段血泪史浓缩成了这份《OpenClaw 彻底卸载及全新重装操作手册》。
如果你也把配置改乱了、满屏报错不知道咋办……别犹豫，别修了！ 跟着这篇来，10 分钟带你满血复活！🚀
💣 第一阶段：我是怎么把自己坑惨的？
一开始，我觉得这简直太简单了。
不就是装个软件吗？跟装微信有啥区别？
装好之后，日志满屏绿色，机器人秒回。 那时候的我：
"就这？我是不是个技术天才？这也太容易了吧！"😎
然后，手痒开始了。
我看日志里显示的是默认模型，心想："不行，我要换成最新的 3.6-PLUS 版本！"
于是，我干了一件"作死"的事：手动修改配置文件（openclaw.json）。
我凭着一点点直觉，自信满满地把名字改成了新模型。
保存，重启！
结果，它给了我一记响亮的耳光：
• ❌ 满屏飘红！ • ❌ 报错： Unknown model（未知模型）• ❌ 甚至连飞书都连不上了！
那时候的我：
"没事没事，肯定是哪个标点符号没写对，我再改改……"
😭 第二阶段：越改越乱，彻底崩溃
接下来的一个小时，我陷入了死循环：
1. 改代码 -> 重启 -> 报错 2. 查资料 -> 搜论坛 -> 看不懂 3. 再改代码 -> 重启 -> 继续报错
最离谱的是，我不小心把飞书的配置也弄乱了。
日志里连个 [feishu] 的字眼都找不到，机器人直接"装死"不回消息了。
那时候的我：
"呜呜呜，我到底做错了什么？我就是想升个级啊！我不玩了！"
🚀 第三阶段：破而后立（附保姆级重装指南）
就在我准备把电脑砸了的时候，我的 AI 助手丢给我一个终极绝招：
"别改了，把配置文件删掉，让它重生！"
对！既然修不好，咱们就彻底推翻重来！
下面是我总结的《OpenClaw 彻底卸载及全新重装操作手册》，建议全文背诵！
🧹 第一部分：OpenClaw 彻底卸载流程
卸载分为标准卸载（保留配置）和彻底卸载（清空所有残留，推荐重装前使用）。 优先选择彻底卸载，避免旧配置冲突导致重装异常。
一、标准卸载（保留个人配置与工作区）
适合临时卸载、后续需恢复原有配置的场景，不会删除自定义配置和智能体文件。
1. 停止网关服务：终止当前运行的 OpenClaw 网关进程，避免服务占用导致卸载失败 openclaw gateway stop2. 卸载系统服务：移除开机自启和系统服务关联 openclaw gateway uninstall3. 执行基础卸载：卸载 CLI 命令工具 openclaw uninstall
二、彻底卸载（清空所有残留，重装必选）
适合解决配置异常、权限报错、版本冲突问题。会删除所有配置、缓存、服务残留、配对信息。
⚠️ 操作前如需备份，请提前复制 ~/.openclaw/workspace 目录（核心工作区文件）。
1. 一键彻底清理命令（通用首选） # 停止并卸载网关服务
openclaw gateway stop
openclaw gateway uninstall
# 无交互彻底清理所有残留（无需手动确认）
openclaw uninstall --all --yes --non-interactive2. 命令失效兜底方案（CLI 已删除无法执行） # 用 npx 强制执行清理（无需提前安装 CLI）
npx -y openclaw uninstall --all --yes --non-interactive
# 手动删除核心残留目录（兜底清理）
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
三、分系统手动清理残留（服务/进程未彻底删除）
针对卸载后仍有进程占用、开机自启残留的情况，按对应系统执行命令：
1. 🐧 Linux（systemd）
systemctl --user disable --now openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload
rm -rf ~/.openclaw2. 🍎 macOS（launchd）
launchctl bootout gui/$UID/ai.openclaw.gateway
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist
rm -rf ~/.openclaw3. 🪟 Windows（PowerShell 管理员模式执行）
schtasks /Delete /F /TN "OpenClaw Gateway"
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"四、CLI 工具单独卸载
按最初安装包管理器选择对应命令，彻底移除命令行工具：
# npm 安装
npm rm -g openclaw
# pnpm 安装
pnpm remove -g openclaw
# bun 安装
bun remove -g openclaw五、卸载完成验证
执行以下命令，无结果返回即为卸载干净：
# macOS/Linux
which openclaw
ls -la ~/.openclaw
# Windows
Get-Command openclaw
dir "$env:USERPROFILE\.openclaw"💡 卸载注意事项：
1. Windows 系统必须用管理员身份打开终端执行，否则权限不足无法清理。 2. 彻底卸载会清空所有飞书配对、API 密钥、智能体配置，请提前备份重要文件。 3. 配对码、用户 ID 等临时信息会一并清除，重装后需重新配对。
🚀 第二部分：OpenClaw 全新重装流程
卸载干净后执行。推荐官方一键安装脚本，自动适配系统、安装依赖（Node.js），无需手动配置环境。
一、安装前置要求
• 系统支持：macOS、Linux、Windows 10 及以上、WSL2 • 依赖要求：自动安装 Node.js ≥22.x，无需提前手动安装 • 权限要求：Windows 用管理员终端，macOS/Linux 必要时加 sudo
二、官方一键安装（推荐，全系统通用）
1. 🍎 macOS / 🐧 Linux / WSL2
# 标准安装（含初始化向导，新手首选）
curl -fsSL https://openclaw.ai/install.sh | bash
# 跳过初始化（自动化部署，无引导步骤）
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard2. 🪟 Windows（PowerShell 管理员执行）
# 标准安装
iwr -useb https://openclaw.ai/install.ps1 | iex
# 跳过初始化
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard三、手动安装（已有 Node.js 环境）
# 全局安装最新版 CLI
npm install -g openclaw@latest
# 首次安装初始化网关 + 安装系统服务
openclaw onboard --install-daemon四、重装后验证与启动
1. 查看版本，确认安装成功： openclaw --version2. 检查网关运行状态： openclaw gateway status3. 手动启动网关（未自动启动时）： openclaw gateway start
💡 重装注意事项：
1. 国内网络卡顿可切换镜像安装，避免下载失败。 2. 默认端口 18789，若端口冲突，可修改 ~/.openclaw/config.json中port字段，或启动时指定端口：openclaw gateway start --port 自定义端口。3. 重装后需重新完成飞书配对、密钥配置，恢复之前备份的工作区文件。
4️⃣ 第四步：初始化配置（盯紧屏幕！）
装好后，如果是跳过初始化的安装，记得手动运行：
openclaw configure这时候它会问你问题，请务必看仔细！
• 飞书账号： 照实填。 • 模型选择（重中之重！）： • 💣 避坑预警： 看到带 3.6或者coding的字眼，千万别选！• ✅ 正确做法： 选列表里的 dashscope/qwen-plus或者 第一个。• (听我的，先求稳！等以后本地适配好了再升级！)
🚑 常见问题急救包（FAQ）
Q1：提示权限不足（Permission denied）？A： Windows 用户请务必用管理员身份运行 PowerShell！右键点击 PowerShell 图标 -> 以管理员身份运行。
Q2：飞书机器人不回消息？A： 检查 AppID 填对没？还有，一定要主动先给机器人发一句话！ 飞书有防骚扰机制，你不理它，它就不理你。
Q3：启动报错说端口被占用？A： 说明之前的进程没杀干净。打开任务管理器，找到 node.exe 或者 openclaw，强制结束任务，再重新启动。
Q4：配置文件改乱了怎么办？A： 别修了！回到第一部分，彻底卸载，重新来过！这比修代码快 100 倍！
💡 写在最后：给小白的真心话
今天下午，我从一个自信满满的"AI 大师"，变成了一个被报错折磨哭的"小白"，最后又变成了一个笑出声的"折腾家"。
这个过程让我明白了一件事： AI 时代，不懂代码没关系，但你要有一颗不怕折腾的心。
遇到报错别怕，"彻底卸载 + 重装"往往比你去查代码找错误更有效！
如果你也在折腾 OpenClaw，欢迎在评论区告诉我你的"血泪史"，让我知道我不是一个人！😂
觉得这篇文章有用吗？
👍 点赞
🔄 转发给身边想搞 AI 的朋友（帮他们避雷）
🌟 收藏备用（万一哪天你的 AI 也抽风了呢？）
(关注我，一个正在努力学 AI 的小白！)
