OpenClaw环境迁移指南：千问3.5-9B配置备份与恢复

1. 为什么需要环境迁移？

上周我的主力开发机突然硬盘故障，导致OpenClaw的整套配置丢失。重新搭建环境时，光是飞书通道的授权验证就花了2小时，更别提那些精心调试的自定义技能和模型参数。这次惨痛经历让我意识到：OpenClaw的环境迁移需要系统化的备份方案。

与普通应用不同，OpenClaw的配置分散在多个位置：

• 模型凭证和API密钥（通常加密存储）
• 技能市场的自定义模块
• 飞书/钉钉等通讯通道的OAuth配置
• 本地工作目录的任务历史记录

本文将分享一套经过实战验证的迁移方案，用tar+openssl实现配置打包加密，通过clawhub命令导出技能清单，最终在目标机器实现"一键恢复"。

2. 迁移前的准备工作

2.1 识别关键配置文件

首先通过openclaw doctor命令检查核心文件路径（以下是我的环境输出示例）：

$ openclaw doctor
[✓] 配置文件: /Users/leo/.openclaw/openclaw.json
[✓] 技能目录: /Users/leo/.openclaw/skills
[✓] 工作空间: /Users/leo/.openclaw/workspace
[✓] 日志文件: /var/log/openclaw/daemon.log

特别要注意隐藏目录.openclaw，这是大部分配置的存储位置。建议用tree命令查看完整结构：

tree -a ~/.openclaw -L 2

2.2 处理敏感信息

模型凭证和通道密钥需要特殊处理。例如我的openclaw.json中包含：

{
  "models": {
    "providers": {
      "qwen-portal": {
        "apiKey": "sk-xxxxxxxxxxxx", // 需要加密
        "baseUrl": "https://api.qwen.ai"
      }
    }
  },
  "channels": {
    "feishu": {
      "appSecret": "xxxxxxxx" // 需要加密
    }
  }
}

推荐使用openssl进行加密（后面会演示具体操作）。

3. 四步完成环境备份

3.1 第一步：打包工作目录

使用tar命令创建压缩包，排除缓存文件：

cd ~
tar --exclude='.openclaw/cache/*' \
    -czvf openclaw_backup_$(date +%Y%m%d).tar.gz \
    .openclaw \
    /var/log/openclaw

这个命令会：

1. 跳过缓存目录节省空间
2. 包含配置文件和日志
3. 以日期格式命名备份文件

3.2 第二步：加密敏感文件

对包含API Key的配置文件单独加密：

openssl enc -aes-256-cbc -salt -in ~/.openclaw/openclaw.json \
    -out openclaw_config_enc.enc -pass pass:YourStrongPassword

安全提示：

• 密码建议保存在1Password等专业工具
• 不要将密码写入脚本文件
• 加密后删除原始配置文件（shred -u ~/.openclaw/openclaw.json）

3.3 第三步：导出技能列表

通过ClawHub CLI导出已安装技能：

clawhub list --installed --format=json > installed_skills.json

示例输出：

[
  {
    "name": "file-processor",
    "version": "1.2.0",
    "author": "openclaw-team"
  },
  {
    "name": "meeting-minutes",
    "version": "0.9.3", 
    "author": "community-contrib"
  }
]

3.4 第四步：记录环境信息

最后记录基础环境版本：

openclaw --version > version.txt
node --version >> version.txt 
npm list -g --depth=0 >> version.txt

4. 在新环境恢复配置

4.1 基础环境准备

先在目标机器安装相同版本的OpenClaw：

# 确认版本一致
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --version 0.9.7

4.2 解密并恢复文件

将备份包传输到新机器后：

# 解压基础文件
tar -xzvf openclaw_backup_20240515.tar.gz -C ~/

# 解密配置文件
openssl enc -aes-256-cbc -d -in openclaw_config_enc.enc \
    -out ~/.openclaw/openclaw.json -pass pass:YourStrongPassword

4.3 批量重装技能

使用之前导出的installed_skills.json：

cat installed_skills.json | jq -r '.[].name' | xargs -n 1 clawhub install

常见问题：

• 如果技能作者变更，可手动指定版本号
• 私有技能需要先配置ClawHub访问令牌

4.4 验证飞书通道

由于飞书应用配置涉及IP白名单，需要：

1. 获取新机器的公网IP：

   curl ifconfig.me
   

2. 登录飞书开放平台，将新IP加入白名单
3. 重启OpenClaw网关：

   openclaw gateway restart
   

5. 迁移后的检查清单

完成恢复后，建议按以下顺序验证：

1. 核心服务状态：

   openclaw gateway status
   

2. 模型连接测试：

   openclaw models test qwen-portal
   

3. 技能功能验证：

   openclaw skills run file-processor --test
   

4. 飞书消息收发： 在飞书群组发送/claw help测试机器人响应

6. 高级技巧：差异迁移方案

对于频繁迁移的场景，可以优化流程：

6.1 使用rsync增量同步

rsync -avz --delete \
    --exclude='cache' \
    ~/.openclaw/ user@newhost:~/.openclaw/

6.2 编写自动化校验脚本

创建verify_migration.sh：

#!/bin/bash

# 检查核心服务
if ! openclaw gateway status | grep -q "running"; then
    echo "[ERROR] Gateway service not running"
    exit 1
fi

# 检查模型连接
if ! openclaw models test qwen-portal &>/dev/null; then
    echo "[ERROR] Model connection failed" 
    exit 2
fi

echo "[OK] Migration verified"
exit 0

7. 我踩过的三个坑

坑1：权限问题导致技能失效
在Linux环境下，直接解压tar包可能导致技能目录权限错误。解决方案：

chmod -R 755 ~/.openclaw/skills

坑2：Node版本不兼容
有次迁移后技能报错，发现目标机Node版本是v16，而原环境是v18。现在我会在version.txt中记录：

node --version
npm --version

坑3：时区影响定时任务
如果使用OpenClaw的定时任务功能，记得检查：

timedatectl status

---

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。