需执行结构化迁移：一、备份本地配置与技能数据；二、导出飞书/企微/钉钉集成凭证；三、卸载旧版并清理Windows注册表残留；四、安装新版并手动还原备份配置；五、通过远程指令、技能包调用及定时任务验证迁移完整性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您已安装旧版本WorkBuddy并希望升级至新版本，同时保留历史配置、技能包、远程集成关系及自定义工作流，则需执行结构化迁移操作。以下是完成跨版本迁移的具体步骤：
一、备份本地配置与技能数据
迁移前必须完整保留用户级设置与OpenClaw兼容技能资产，避免重装后重复配置。所有备份文件均存储于用户目录下，不依赖云端同步。
1、打开文件管理器，定位到WorkBuddy默认配置路径：Windows：C:\Users\[用户名]\AppData\Roaming\WorkBuddy 或 macOS：~/Library/Application Support/WorkBuddy。
2、将整个WorkBuddy文件夹复制到外部存储设备或桌面临时文件夹，确保包含config.json、skills/、claw-integrations/子目录。
3、特别检查skills/目录内是否存在以.ocl为后缀的技能包文件，这些是OpenClaw体系导入的工作流，迁移时不可遗漏。
二、导出飞书/企微/钉钉集成凭证
新版WorkBuddy不再自动继承旧版IM工具的授权状态，需手动提取已配置的应用凭证，用于新版本快速复用已有机器人连接。
1、在旧版WorkBuddy界面右上角点击个人头像 → 进入「Claw设置」→ 选择已启用的平台（如飞书）。
2、在该平台配置页中，找到并完整复制以下三项值：App ID、App Secret、Webhook URL，粘贴至加密文本文件保存。
3、若使用企业微信，还需记录「机器人密钥」和「加解密Key」（位于企微管理后台对应机器人详情页），二者为消息加解密必需参数。
三、卸载旧版并清理残留注册表项（仅Windows）
残留注册表键值可能导致新版启动失败或权限异常，需主动清除旧版系统级注册信息。
1、通过控制面板卸载WorkBuddy，勾选“删除用户数据”选项保持关闭——此项会清除配置，故必须先完成第一步备份。
2、按Win + R输入regedit，导航至：HKEY_CURRENT_USER\Software\Tencent\WorkBuddy，右键删除该主键。
3、继续查找：HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Tencent\WorkBuddy，同样执行删除操作。
四、安装新版并还原配置
新版安装程序不会覆盖旧配置路径，因此必须手动恢复备份内容，使新版本加载原有环境上下文。
1、从官网下载最新安装包：https://www.codebuddy.cn/work/，按系统选择对应版本完成安装。
2、首次启动新版WorkBuddy时，在登录腾讯账号后暂停操作，立即退出应用进程。
3、将第一步备份的整个WorkBuddy文件夹，完整覆盖至新版本对应的配置路径（路径同第一步所列）。
4、重新启动应用，确认「Claw设置」中各IM平台显示“已连接”，且skills/列表可见全部原有技能包。
五、验证迁移完整性
迁移是否成功取决于远程指令响应能力与本地任务执行准确性，需通过真实场景触发双重校验。
1、在企业微信中向已绑定机器人发送指令：“列出当前桌面所有PDF文件”，观察是否返回准确文件名列表。
2、在WorkBuddy本地界面新建任务，调用一个曾导入的.ocl技能包，确认其步骤解析无报错、沙箱执行进度条正常推进。
3、检查「自动化任务」面板，确认原设定的每日9点导出订单数据任务仍处于启用状态，并显示下次触发时间为当日9:00。
