migrate

migrate 是专为 Clawdbot 设计的全量迁移与备份工具，通过一对精简的 Bash 脚本实现跨设备环境的无缝转移。该技能允许用户将完整的工作区配置、已安装的 Skill 组件以及 WhatsApp 会话状态打包为压缩归档，并在新机器上快速恢复，彻底解决了自动化工具换机时的配置重建难题。

核心用法围绕 export.sh 与 import.sh 两个脚本展开。导出操作会创建带有时间戳的 clawdbot-export-YYYYMMDD_HHMMSS.tar.gz 文件，默认包含 ~/clawd 工作区目录、主配置文件 clawdbot.json、已管理的 Skill 模块以及 WhatsApp 登录会话，同时智能排除 node_modules、构建产物和版本控制目录等可重建文件。用户可通过 --include-sessions 追加会话历史记录，或在明确风险警示后使用 --include-credentials 导出敏感凭证。导入流程同样简洁，只需指定归档路径即可自动解压并部署到目标工作区，配合 --force 参数可跳过确认快速覆盖现有环境。

该技能的显著优势在于其对 WhatsApp 会话的无损转移能力——用户无需在新设备上重新扫描二维码即可完成登录状态迁移，这对依赖 WhatsApp 集成的业务场景至关重要。技术实现上，脚本严格遵循 Unix 哲学，仅依赖系统自带的 tar、rsync、cp 等标准工具，无外部库依赖或动态代码加载，确保了极高的可移植性和稳定性。安全设计方面，开发者采用了"默认安全"策略：敏感凭证和会话记录默认不包含在归档中，文件覆盖操作强制要求用户确认，且使用 trap 机制确保临时目录的清理，有效防止残留数据泄露。

然而，作为 T3 来源的社区项目，该技能也存在一定局限性。首先，它由个人开发者维护，缺乏官方组织的长期支持承诺；其次，当前版本不支持归档加密，若导出的文件包含凭证且传输通道不安全，存在中间人窃取风险；此外，缺少 SHA256 等完整性校验机制，归档损坏可能导致恢复失败；最后，跨版本兼容性未明确说明，Clawdbot 大版本升级后的归档恢复可能存在配置冲突。

该技能最适合需要更换工作设备、在多台机器间同步开发环境，或希望建立定期备份机制的 Clawdbot 重度用户。特别是对于依赖特定 Skill 配置和 WhatsApp 业务会话的运营人员，能显著降低设备更换的停机时间。

使用时的常规风险主要集中在数据安全领域：启用 --include-credentials 会将数据库密码、API 密钥等敏感信息明文存入归档，必须通过加密 USB、SCP 等安全通道传输，并妥善保管存储介质；--force 参数虽提升效率，但会无条件覆盖目标目录现有配置，可能导致数据丢失；另外，由于归档未压缩加密，存储在共享设备或云端时需额外注意访问权限控制。建议用户在导出后立即验证归档完整性，并在导入后检查关键配置是否正常加载。