配置
像房子的规则表,告诉 Gateway 怎么工作。
Install 导读
迁移的核心是复制整个状态目录(默认 ~/.openclaw/)和工作区,而不是只拷 openclaw.json。最容易翻车的是忘记匹配旧机器的 profile 或状态目录路径,导致频道全部掉线。迁移后务必用 openclaw status 和 dashboard 验证频道连接和会话是否完整。
先讲这一页到底在解决什么
迁移的核心是复制整个状态目录(默认 ~/.openclaw/)和工作区,而不是只拷 openclaw.json。最容易翻车的是忘记匹配旧机器的 profile 或状态目录路径,导致频道全部掉线。迁移后务必用 openclaw status 和 dashboard 验证频道连接和会话是否完整。
第一站
官方列的 “What Gets Migrated” 很值得直接压成画面感。
像房子的规则表,告诉 Gateway 怎么工作。
像各种门卡、钥匙、OAuth 通行证。
像聊天记录和“这扇门已经登录好了”的现场状态。
像记事本、技能卡、提示词文件,全都在这里。
第二站
不然边搬边改文件,很容易搬出半旧半新的怪状态。
openclaw gateway stop像先让旧房子的值班员下班,别在你打包时还一直改抽屉里的东西。
tar -czf openclaw-state.tgz .openclaw像把整个状态箱打成一个搬家包,而不是零零散散抓几个文件。
如果你有 .openclaw-work 这类多个房间,就每个房间各打一包,别混成一团。
先停,再打包,别边跑边搬。
第三站
官方说 onboarding 生成了新目录也没关系,就是这个意思。
像先让新房子具备基本用电和开门能力。
scp / rsync -a像把搬家箱从旧房子送到新房子。
tar -xzf openclaw-state.tgz像在新房里把整箱家当打开,按原样摆回去。
这也是为什么官方特别提醒“确保 hidden directories 也被带上”。很多关键东西就藏在那里。
第四站
它不只是“看有没有活着”,还会顺手补迁移和修细节。
openclaw doctor像请总验收师来检查:配置迁移好了没,路径修对了没,服务状态顺不顺。
openclaw gateway restart像让值班室在新房里正式重启上岗。
openclaw status最后看灯牌是不是亮了,别以为搬完箱子就算入住成功。
这页最重要的提醒是:搬家要搬整箱,不要只拿封面那张配置纸。