OpenClaw中文文档升级迁移与卸载
时间：2026-06-01 13:01
装好了，用了一段时间，这事就算完了？远远没有。新版出来了怎么升，换机器了怎么迁，不用了怎么彻底清干净——这三个问题，几乎每个用户都会遇到。这篇一次性讲透，不绕弯子。 升级 先说升级。最直接的办法，就是重新跑一下安装脚本： curl -fsSL https: openclaw ai install
装好了，用了一段时间，这事就算完了？远远没有。新版出来了怎么升，换机器了怎么迁，不用了怎么彻底清干净——这三个问题，几乎每个用户都会遇到。这篇一次性讲透，不绕弯子。
升级
先说升级。最直接的办法，就是重新跑一下安装脚本：
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
它会自动检测现有安装，原地完成升级，省心。
如果习惯用包管理器，也很直接：
npm i -g openclaw@latest
# 或
pnpm add -g openclaw@latest
对于源码安装的用户，一条命令搞定：
openclaw update
这条命令内部完成了 fetch、rebase、install、build、doctor、restart 全套流程。
升级完之后，有几件事必须做：
openclaw doctor # 迁移配置、检查问题
openclaw gateway restart # 重启网关
openclaw health # 验证
其中
openclaw doctor 尤其重要——它会自动迁移废弃的配置键，检查 DM 策略安全性，千万别跳过去。
自动更新默认是关闭的。想开启的话，在配置里加上：
{
"update": {
"channel": "stable",
"auto": {
"enabled": true
}
}
}
切换频道也很方便：
openclaw update --channel beta
openclaw update --channel stable
万一升级后出了什么问题需要回滚，也有办法：
# npm
npm i -g openclaw@
# 源码（回到某个日期的状态）
git checkout "$(git rev-list -n 1 --before="2026-01-01" origin/main)"
pnpm install && pnpm build
openclaw gateway restart
迁移
迁移这件事，说穿了就是复制两个目录：
~/.openclaw/（状态目录，包含配置、认证、会话、渠道）和
~/.openclaw/workspace/（工作区目录，包含 Agent 文件和记忆）。
操作流程很简单。旧机器上先停掉服务，打包：
openclaw gateway stop
cd ~ && tar -czf openclaw-state.tgz .openclaw
然后到新机器上安装 OpenClaw，解压，修复，重启：
# 装 OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
# 解压
cd ~ && tar -xzf openclaw-state.tgz
# 修复 + 启动
openclaw doctor
openclaw gateway restart
最后用
openclaw status 验证，检查渠道连接、历史会话和工作区文件是否都正常。
这里有几个细节要留心：
- 不要只复制
openclaw.json，凭据在
credentials/ 目录里
- 状态目录包含 API Key 等敏感信息，传输时记得加密
- 如果用了
--profile，状态目录在
~/.openclaw-/
- 远程模式迁移的是网关主机，不是你的笔记本
卸载
卸载同样有最省事的办法：
openclaw uninstall
如果希望在自动化脚本中无交互地执行：
openclaw uninstall --all --yes --non-interactive
手动清理的话，步骤稍微多一点：
openclaw gateway stop
openclaw gateway uninstall
rm -rf ~/.openclaw
npm rm -g openclaw
# macOS 还要删应用
rm -rf /Applications/OpenClaw.app
还有一种情况：CLI 已经删了，但后台服务还在跑。这种情况在 macOS 上可以这样处理：
launchctl bootout gui/$UID/ai.openclaw.gateway
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist
在 Linux 上：
systemctl --user disable --now openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload
好了，关于 OpenClaw 的升级、迁移和卸载，核心要点基本都在这里了。下一期会聊 CLI 入门和向导自动化，感兴趣的话可以留意。
