必须完整迁移状态目录（~/.openclaw/）和工作区（~/.openclaw/workspace/），涵盖网关配置、api密钥、soul.md、memory.md、skills/及memory/等核心文件，迁移前需停止网关、排除logs/，并确保新旧环境版本一致。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您需要将OpenClaw的配置文件与本地知识库完整转移至新设备或新环境，但又担心出现配置丢失、记忆断裂或技能失效等问题，则必须确保迁移过程覆盖所有关键路径且规避运行时写入冲突。以下是实现无损迁移的具体操作步骤：
一、确认并导出核心路径资产
OpenClaw的状态目录（~/.openclaw/）与工作区目录（~/.openclaw/workspace/）共同构成迁移主干，其中状态目录含网关配置、API密钥、渠道凭证及会话状态，工作区则承载SOUL.md、MEMORY.md、memory/、skills/等知识实体。遗漏任一路径都将导致AI人格、历史记忆或技能调用异常。
1、在旧设备上执行命令确认实际路径：
openclaw status | grep -E "(State|Workspace)"
2、若输出中显示OPENCLAW_STATE_DIR变量，以该路径为准；否则默认为~/.openclaw/
3、检查workspace是否为自定义路径：
cat ~/.openclaw/openclaw.json | jq '.workspace' 2>/dev/null || echo "default: ~/.openclaw/workspace"
4、记录当前OpenClaw版本：
openclaw --version
二、云端或远程实例停服与打包
迁移前强制停止OpenClaw网关可防止数据在压缩过程中被动态修改，保障快照一致性。日志目录（logs/）体积大且无迁移必要，应主动排除以减小归档体积并加快传输。
1、登录云端服务器或远程实例终端
2、执行网关停止命令：
openclaw gateway stop
3、验证网关已退出：
openclaw status | grep Gateway
4、清空日志缓存（可选但推荐）：
rm -rf ~/.openclaw/logs/*.log
5、执行全量打包（排除冗余目录）：
tar -czvf openclaw-migration-backup.tar.gz \
--exclude='.DS_Store' \
--exclude='node_modules' \
--exclude='.git' \
~/.openclaw/
三、选择性迁移：仅同步知识库与配置
若仅需保留AI人格、记忆与技能，而无需会话状态或渠道登录态，可跳过整个状态目录，转而精准提取最小必要集。该方式适用于Git管理的工作区场景，也便于人工审核与版本控制。
1、进入旧设备终端，创建备份目录：
mkdir -p ~/openclaw-selective-backup
2、复制核心知识文件：
cp -r ~/.openclaw/workspace ~/openclaw-selective-backup/
3、导出结构化配置：
cp ~/.openclaw/openclaw.json ~/openclaw-selective-backup/
4、导出身份与记忆元数据：
cp -r ~/.openclaw/identity/ ~/.openclaw/memory/ ~/openclaw-selective-backup/
5、导出已安装技能包：
clawhub list --installed | xargs -I {} clawhub export {} -o ~/openclaw-selective-backup/skills/{}.clawhub
四、本地解压与路径覆盖
新设备上的OpenClaw必须与旧环境版本一致，否则openclaw.json字段解析或插件ABI可能不兼容。覆盖前先备份本地现有状态目录，避免不可逆覆盖错误。
1、在新设备安装匹配版本的OpenClaw：
npm install -g openclaw@$(cat ~/migration-record/version.txt)
2、创建临时恢复目录：
mkdir -p ~/openclaw-restore
3、解压迁移包至临时目录：
tar -xzvf openclaw-migration-backup.tar.gz -C ~/openclaw-restore/
4、备份当前状态目录（如存在）：
mv ~/.openclaw ~/.openclaw.bak.$(date +%Y%m%d)
5、执行原子级迁移：
mv ~/openclaw-restore/.openclaw ~/
五、权限修复与完整性验证
Linux/macOS系统下，解压后的文件可能继承源服务器用户ID，导致新设备上OpenClaw无法读取配置或写入memory/。验证环节需逐项确认关键文件是否存在且可访问，而非仅依赖启动成功。
1、修正所有权（以当前用户为准）：
chown -R $USER:$USER ~/.openclaw
2、检查核心文件存在性：
ls -l ~/.openclaw/workspace/SOUL.md ~/.openclaw/workspace/MEMORY.md
3、确认技能目录非空：
find ~/.openclaw/skills -name "*.js" | head -n 1
4、验证记忆子目录结构：
ls -d ~/.openclaw/workspace/memory/20*
5、启动服务并观察初始化日志：
openclaw gateway start 2>&1 | grep -E "(Loaded|memory|skill)"
