OpenClaw配置备份：迁移Qwen3.5-4B-Claude环境到新电脑

1. 为什么需要完整的配置迁移方案

上周我的主力开发机突然硬盘故障，虽然数据最终恢复，但重新配置OpenClaw环境的过程让我意识到：一个可靠的配置备份方案对AI工作流稳定性的重要性。特别是当你的OpenClaw已经对接了像Qwen3.5-4B-Claude这样的定制模型，还安装了大量技能插件时，从头开始配置可能浪费数小时。

传统的文件备份工具如Time Machine或rsync虽然能保存文件，但OpenClaw的配置分散在多个位置：

• ~/.openclaw目录存储核心配置和模型连接信息
• 全局npm包包含已安装的技能插件
• 本地模型索引可能指向特定路径
• 渠道凭证（如飞书机器人）需要重新授权

经过这次教训，我整理出一套完整的迁移方案，不仅能保留现有环境的所有功能，还能实现新旧设备间的无缝切换。

2. 迁移前的准备工作

2.1 识别关键配置文件

首先在源机器上确认这些关键路径：

# 核心配置目录
ls -la ~/.openclaw

# 全局安装的OpenClaw相关包
npm list -g --depth=0 | grep openclaw

# 技能插件存储位置
ls -la ~/.openclaw/plugins

特别注意openclaw.json中的模型配置段，例如对接Qwen3.5-4B-Claude的部分可能类似：

"models": {
  "providers": {
    "qwen-claude": {
      "baseUrl": "http://localhost:8080",
      "apiKey": "sk-xxxxxx",
      "api": "openai-completions",
      "models": [
        {
          "id": "qwen3.5-4b-claude",
          "name": "Qwen3.5-4B-Claude推理版",
          "contextWindow": 32768
        }
      ]
    }
  }
}

2.2 创建迁移包目录结构

建议按此结构组织迁移文件：

mkdir openclaw_migration && cd openclaw_migration
mkdir -p {configs,plugins,scripts,models}

3. 完整配置备份流程

3.1 打包核心配置文件

使用tar保留文件权限和符号链接：

tar -czvf openclaw_configs.tar.gz -C ~/.openclaw .
mv openclaw_configs.tar.gz openclaw_migration/configs/

安全提示：如果配置中包含敏感API密钥，建议加密压缩包：

gpg --symmetric --cipher-algo AES256 openclaw_configs.tar.gz

3.2 备份技能插件

全局安装的插件需要单独备份清单：

npm list -g --depth=0 | grep @m1heng-clawd > openclaw_migration/plugins/global_plugins.txt

对于通过ClawHub安装的社区技能：

clawhub list --installed > openclaw_migration/plugins/clawhub_plugins.txt

3.3 处理本地模型索引

如果使用Qwen3.5-4B-Claude的本地GGUF模型，需要记录模型路径：

grep -A 5 "qwen3.5-4b-claude" ~/.openclaw/openclaw.json > openclaw_migration/models/model_info.json

对于平台部署的模型（如星图镜像），只需备份baseUrl和apiKey即可。

4. 新机器恢复环境

4.1 基础环境准备

在新机器上先安装OpenClaw运行时：

# 官方推荐方式
curl -fsSL https://openclaw.ai/install.sh | bash

# 或者通过npm
npm install -g openclaw@latest

4.2 恢复配置文件

解压备份文件到正确位置：

mkdir -p ~/.openclaw
tar -xzvf openclaw_migration/configs/openclaw_configs.tar.gz -C ~/.openclaw

如果使用加密备份，需要先解密：

gpg -d openclaw_configs.tar.gz.gpg | tar -xzv -C ~/.openclaw

4.3 重装技能插件

根据备份清单批量重装：

# 全局插件
xargs -a openclaw_migration/plugins/global_plugins.txt npm install -g

# ClawHub社区技能
xargs -a openclaw_migration/plugins/clawhub_plugins.txt clawhub install

4.4 模型连接验证

启动网关服务并检查模型连接状态：

openclaw gateway start
openclaw models list

如果使用本地GGUF模型，需要确保新机器的模型路径与备份一致，或更新openclaw.json中的路径配置。

5. 自动化迁移脚本

为简化流程，我编写了这个自动化迁移脚本migrate_openclaw.sh：

#!/bin/bash

# 参数检查
if [ "$#" -ne 2 ]; then
    echo "Usage: $0 <backup|restore> <migration_dir>"
    exit 1
fi

ACTION=$1
MIGRATION_DIR=$2

backup() {
    echo "[+] Backing up OpenClaw configs..."
    mkdir -p "$MIGRATION_DIR"/{configs,plugins,models}
    tar -czvf "$MIGRATION_DIR/configs/openclaw_configs.tar.gz" -C ~/.openclaw .
    
    echo "[+] Backing up plugins..."
    npm list -g --depth=0 | grep @m1heng-clawd > "$MIGRATION_DIR/plugins/global_plugins.txt"
    clawhub list --installed > "$MIGRATION_DIR/plugins/clawhub_plugins.txt"
    
    echo "[+] Backing up model info..."
    grep -A 5 "qwen3.5-4b-claude" ~/.openclaw/openclaw.json > "$MIGRATION_DIR/models/model_info.json"
    
    echo "[✓] Backup completed to $MIGRATION_DIR"
}

restore() {
    echo "[+] Restoring OpenClaw configs..."
    mkdir -p ~/.openclaw
    tar -xzvf "$MIGRATION_DIR/configs/openclaw_configs.tar.gz" -C ~/.openclaw
    
    echo "[+] Installing plugins..."
    xargs -a "$MIGRATION_DIR/plugins/global_plugins.txt" npm install -g
    xargs -a "$MIGRATION_DIR/plugins/clawhub_plugins.txt" clawhub install
    
    echo "[✓] Restore completed from $MIGRATION_DIR"
}

case "$ACTION" in
    backup)
        backup
        ;;
    restore)
        restore
        ;;
    *)
        echo "Invalid action: $ACTION"
        exit 1
        ;;
esac

使用示例：

# 备份当前环境
chmod +x migrate_openclaw.sh
./migrate_openclaw.sh backup ./openclaw_backup_20240615

# 在新机器恢复
./migrate_openclaw.sh restore ./openclaw_backup_20240615

6. 迁移后的验证与调试

完成迁移后，建议按此顺序验证：

1. 基础功能测试：

   openclaw --version
   openclaw gateway status
   

2. 模型连接测试：

   openclaw models test qwen3.5-4b-claude
   

3. 技能插件测试：

   openclaw skills list
   openclaw skills test wechat-publisher
   

4. 渠道连接验证（如飞书）：

   openclaw channels list
   

如果遇到模型连接问题，检查：

• 新机器的网络环境是否能访问模型端点
• 本地模型文件路径是否一致
• API密钥是否仍然有效

对于渠道连接问题，可能需要：

• 在飞书/钉钉开放平台更新IP白名单
• 重新获取App Secret
• 重启网关服务

---

获取更多AI镜像

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