乐于分享
好东西不私藏

不懂 AI 的小白折腾记:我被 OpenClaw 气哭又笑醒的下午(附保姆级重装指南)》

不懂 AI 的小白折腾记:我被 OpenClaw 气哭又笑醒的下午(附保姆级重装指南)》

副标题: 别再盲目折腾了!这份“彻底重装手册”,专治各种不服,建议全文背诵

大家好 

作为一个刚接触 AI 没多久的小白,我平时对代码一窍不通,连命令行长啥样都认不全。 只要不涉及敲代码,我就是个快乐的普通人。

但今天下午,我遇到了一个不讲武德的对手——OpenClaw 本地部署

起因很简单:我的阿里云百炼 Coding Plan 更新了最新的大模型 Qwen 3.6-PLUS
云服务器上的 OpenClaw 已经能无缝用上这个最新模型了,听说更聪明了!
但是,本地部署默认不能直接更新到这个版本!

我心痒痒:"不行!我也要在本地电脑上整一个!让我家的小龙虾(本地机器人)也用上最新的模型,体验一把更新后的爽感!"

结果? 我经历了人生中最"过山车"的一个下午:从自信满满 → 怀疑人生 → 气哭 → 最后笑醒!

现在,我把这段血泪史浓缩成了这份《OpenClaw 彻底卸载及全新重装操作手册》

如果你也把配置改乱了、满屏报错不知道咋办……别犹豫,别修了! 跟着这篇来,10 分钟带你满血复活!🚀


💣 第一阶段:我是怎么把自己坑惨的?

一开始,我觉得这简直太简单了。
不就是装个软件吗?跟装微信有啥区别?

装好之后,日志满屏绿色,机器人秒回。 那时候的我:

"就这?我是不是个技术天才?这也太容易了吧!"😎

然后,手痒开始了。
我看日志里显示的是默认模型,心想:"不行,我要换成最新的 3.6-PLUS 版本!"

于是,我干了一件"作死"的事:手动修改配置文件(openclaw.json)。

我凭着一点点直觉,自信满满地把名字改成了新模型。
保存,重启!

结果,它给了我一记响亮的耳光:

  • • ❌ 满屏飘红!
  • • ❌ 报错:Unknown model(未知模型)
  • • ❌ 甚至连飞书都连不上了!

那时候的我:

"没事没事,肯定是哪个标点符号没写对,我再改改……"


😭 第二阶段:越改越乱,彻底崩溃

接下来的一个小时,我陷入了死循环:

  1. 1. 改代码 -> 重启 -> 报错
  2. 2. 查资料 -> 搜论坛 -> 看不懂
  3. 3. 再改代码 -> 重启 -> 继续报错

最离谱的是,我不小心把飞书的配置也弄乱了。
日志里连个 [feishu] 的字眼都找不到,机器人直接"装死"不回消息了。

那时候的我:

"呜呜呜,我到底做错了什么?我就是想升个级啊!我不玩了!"


🚀 第三阶段:破而后立(附保姆级重装指南)

就在我准备把电脑砸了的时候,我的 AI 助手丢给我一个终极绝招

"别改了,把配置文件删掉,让它重生!"

对!既然修不好,咱们就彻底推翻重来!

下面是我总结的《OpenClaw 彻底卸载及全新重装操作手册》,建议全文背诵

🧹 第一部分:OpenClaw 彻底卸载流程

卸载分为标准卸载(保留配置)和彻底卸载(清空所有残留,推荐重装前使用)。 优先选择彻底卸载,避免旧配置冲突导致重装异常。

一、标准卸载(保留个人配置与工作区)

适合临时卸载、后续需恢复原有配置的场景,不会删除自定义配置和智能体文件。

  1. 1. 停止网关服务:终止当前运行的 OpenClaw 网关进程,避免服务占用导致卸载失败
    openclaw gateway stop
  2. 2. 卸载系统服务:移除开机自启和系统服务关联
    openclaw gateway uninstall
  3. 3. 执行基础卸载:卸载 CLI 命令工具
    openclaw uninstall

二、彻底卸载(清空所有残留,重装必选)

适合解决配置异常、权限报错、版本冲突问题。会删除所有配置、缓存、服务残留、配对信息。
⚠️ 操作前如需备份,请提前复制 ~/.openclaw/workspace 目录(核心工作区文件)。

  1. 1. 一键彻底清理命令(通用首选)
    # 停止并卸载网关服务
    openclaw gateway stop
    openclaw gateway uninstall
    # 无交互彻底清理所有残留(无需手动确认)

    openclaw uninstall --all --yes --non-interactive
  2. 2. 命令失效兜底方案(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 ~/.openclaw

2. 🍎 macOS(launchd)

launchctl bootout gui/$UID/ai.openclaw.gateway
rm
 -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist
rm
 -rf ~/.openclaw

3. 🪟 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. 1. Windows 系统必须用管理员身份打开终端执行,否则权限不足无法清理。
  2. 2. 彻底卸载会清空所有飞书配对、API 密钥、智能体配置,请提前备份重要文件
  3. 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-onboard

2. 🪟 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. 1. 查看版本,确认安装成功:
    openclaw --version
  2. 2. 检查网关运行状态
    openclaw gateway status
  3. 3. 手动启动网关(未自动启动时):
    openclaw gateway start

💡 重装注意事项:

  1. 1. 国内网络卡顿可切换镜像安装,避免下载失败。
  2. 2. 默认端口 18789,若端口冲突,可修改 ~/.openclaw/config.json 中 port 字段,或启动时指定端口:openclaw gateway start --port 自定义端口
  3. 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 的小白!)