从中文用户到英文用户:OpenClaw 数据迁移全记录

背景

Windows 系统中文用户名（C:\Users\王坤\）在很多开发场景下会带来路径编码问题。为了彻底解决，我将 Windows 用户名改为了英文（C:\Users\34250\）。但这意味着 AI 助手（OpenClaw/QClaw）的所有配置、工作区、记忆文件都需要完整迁移。

迁移清单

1. 配置文件迁移（openclaw.json）

这是最核心的部分，包含所有通道、插件、模型、绑定等配置：

• QQ 机器人通道
  
  ：appId 1903923875，从备份中找到实际凭证（环境变量引用在新环境失效）
• 微信通道
  
  ：openclaw-weixin 本地通道配置
• 插件系统
  
  ：openclaw-qqbot、openclaw-weixin 等插件启用
• 绑定规则
  
  ：QQ 消息路由到主 agent
• 技能目录
  
  ：添加 ~/.openclaw/skills 等额外路径

2. 工作区文件迁移（70+ 文件）

包括：

• 博客项目文件（坤沙博客相关 HTML、Python 脚本）
• 热电项目文件（虹洋热电 H0301 锅炉补给水处理系统文档）
• PDF 分析文件（catalog、F1180S 图纸等 20+ 张图片）
• 前端项目文件（yan_frontend、yan_backend）
• 各种任务总结和临时文件

3. 目录迁移（7 个目录）

• kunsha-entertainment
  
   – 坤沙博客娱乐页面
• yan_frontend
  
   / yan_backend – 烟项目前后端
• pdfs
  
   / pdf_pages / ocr_output – PDF 处理相关
• skills
  
   – 自定义技能

4. 记忆文件迁移

从 2026-03-20 到 2026-06-02 的 28 个日记文件全部同步，保持连续性。

5. QQ 机器人数据迁移

从 D:\QCLAW\openclaw-config\qqbot\data\credential-backup.json 找到实际凭证：

• appId: 1903923875
• clientSecret: 10zzz0aBnP2gKzfL2kSBvfQCylZNC2sj

配置中使用了环境变量引用 ，在新环境中这些变量不存在，导致机器人无法回复。找到实际值后替换，问题解决。

6. 路径处理

所有 C:\Users\王坤\ 路径替换为 C:\Users\34250\，确保无中文路径残留。

遇到的问题

问题 1：QQ 机器人不回复

原因：配置中 appId 和 clientSecret 使用环境变量引用，新环境未设置这些变量。

解决：从备份目录 D:\QCLAW\openclaw-config\qqbot\data\credential-backup.json 找到实际值，直接替换。

问题 2：公众号 IP 白名单

原因：宽带动态 IP 变化，新 IP 不在白名单中。

解决：登录微信公众号后台，添加新 IP 到白名单。

问题 3：编辑工具匹配问题

原因：PowerShell 生成的 JSON 缩进与 edit 工具期望的格式不一致。

解决：改用 PowerShell 脚本直接操作 JSON 对象，避免文本匹配问题。

迁移结果

总结

从中文用户到英文用户的迁移，核心挑战在于：

2. 路径编码
   
   ：中文路径在某些工具中会导致编码问题，改为英文后彻底解决
4. 环境变量
   
   ：旧配置中的环境变量引用在新环境失效，需要找到实际值
6. 动态 IP
   
   ：宽带动态 IP 变化需要及时更新白名单

最终实现了 100% 的配置匹配，所有功能正常工作。这次迁移也验证了 OpenClaw 配置的可移植性——只要备份完整，就能在任何环境中恢复。