简要总结
Migration Guide
这页说明书是教你如何把 OpenClaw 这个“智能小助手”从一个电脑搬到另一个新电脑上，就像帮你的玩具搬家一样。搬家时，我们不想重新教它认识你、记住你的朋友，所以要用一个特别的方法。这页就是教你这个方法的步骤，适合你在换新电脑或者想把小助手挪个地方的时候看。
五岁小孩版解释
搬家前，我们先要知道要搬走哪些“小盒子”。OpenClaw 有两个最重要的盒子：一个是“状态盒子”，里面装着它的设置、记住的密码和聊天记录；另一个是“工作盒子”，里面装着它学到的知识和记忆。搬家就是要把这两个盒子完整地搬到新电脑上。
第一步：在旧电脑上，先找到要搬的盒子
- 找到“状态盒子”的家。它通常藏在
~/.openclaw/这个文件夹里。你可以把它想成是小助手在旧电脑上的“小房间”。如果你不确定，可以在旧电脑上打开一个叫“终端”的窗口，输入openclaw status这个命令，看看它告诉你房间在哪里。 - 找到“工作盒子”。它通常就在“状态盒子”的家里，在一个叫
workspace的小房间里，路径像~/.openclaw/workspace/。这里面有MEMORY.md这样的文件，是小助手的记忆本。
第二步：在旧电脑上，打包行李（做备份） 在开始搬之前，我们要先让小助手停下来，这样它就不会在打包时乱动东西了。
- 让小助手睡觉：在终端里输入
openclaw gateway stop。 - 把两个盒子打包：我们可以用
tar这个工具，像用胶带把盒子封好一样。在终端里，你可以输入：tar -czf openclaw-state.tgz .openclaw（打包状态盒子）tar -czf openclaw-workspace.tgz .openclaw/workspace（打包工作盒子） 这样你就得到了两个打包好的文件：openclaw-state.tgz和openclaw-workspace.tgz。
第三步：在新电脑上，准备新家 在新电脑上，你需要先按照普通的安装方法，把 OpenClaw 这个“小助手软件”装好。这时它可能会自己创建一个空的新“小房间”，没关系，我们等下会用搬来的盒子替换掉它。
第四步：把打包好的盒子搬到新家
现在，把你在第二步打包好的那两个 .tgz 文件，想办法复制到新电脑上。你可以用 U 盘拷贝，或者通过网络发送。然后，在新电脑上，把这两个打包文件解开，放到和旧电脑上一模一样的位置（通常是你的用户文件夹下）。要小心哦，确保 .openclaw 这个文件夹（前面带个点）也被完整地复制过去了。
第五步：在新家启动并检查 盒子都放好后，我们让小助手在新电脑上醒来，并帮它检查一下身体。
- 在新电脑的终端里，输入
openclaw doctor。这个命令像医生一样，会帮小助手检查新家是否舒服，并修复一些小问题。 - 然后，输入
openclaw gateway restart重新启动小助手。 - 最后，输入
openclaw status看看它是不是开心地跑起来了。
要小心这些容易出错的地方：
- 用错了“小房间”：如果你在旧电脑上给小助手起了个特别的名字（用了
--profile参数），那它的房间名可能不一样。在新电脑上启动时，也必须用同样的名字，不然它会找不到自己的东西。 - 只搬了一部分：千万不要只复制
openclaw.json这一个设置文件。小助手的密码、聊天记录都放在其他文件夹里，必须把整个“状态盒子”文件夹都搬过来。 - 权限不对：如果你是用“管理员”账号打包的，但用普通账号解包，小助手可能会打不开自己的盒子。要确保文件夹属于运行小助手的那个用户。
- 盒子里的秘密：“状态盒子”里装着 API 密钥、聊天账号密码等非常重要的秘密。对待打包好的备份文件要像对待你的日记本一样，好好保管，不要随便发给别人。
搬完家后，记得检查一下：小助手是否在运行？它还能不能和朋友（比如 WhatsApp）聊天？它的记忆本还在不在？如果一切都好，搬家就成功啦！