SuperAPI AI 工具集

myclaw-backup

智能体与模型

查看项目

更新于 10-15 23:59

技能介绍

用途:备份与恢复 OpenClaw 的全部关键数据,包括工作区(MEMORY.md、技能、智能体文件)、openclaw.json(机器人令牌与 API 密钥)、凭据、频道配对状态、智能体配置与会话历史、设备、身份、cron 任务和守护脚本;不包含日志、二进制媒体、node_modules 与画布系统文件。

主要能力:backup.sh 读取 ~/.openclaw/ 并写出 chmod 600 归档,无网络访问;restore.sh 从归档覆盖 ~/.openclaw/,需输入 yes 确认,覆盖前会保存恢复前快照;serve.sh/server.js 启动本地 HTTP 服务器,必须提供 token,否则拒绝启动,/backup 与 /restore 等执行端点仅限 localhost,远程只能下载和上传文件;schedule.sh 修改系统 crontab 定时执行备份,添加前会打印 cron 条目,可用 --disable 移除。

使用方式:创建备份 bash scripts/backup.sh /tmp/openclaw-backups;恢复前先预览 bash scripts/restore.sh openclaw-backup_TIMESTAMP.tar.gz --dry-run,确认后再执行不带 --dry-run 的命令;启动服务器 bash scripts/serve.sh start --token $(openssl rand -hex 16) --port 7373,停止或查看状态用 serve.sh stop|status;定时用 scripts/schedule.sh [--interval daily|weekly|hourly]。HTTP API 除 /health 外均需 token,包括 GET /backups、POST /backup、GET /download/:filename、POST /upload、POST /restore/:filename(加 ?dry_run=1 预览)。

适用场景:迁移到新实例、灾难恢复、定时自动备份,以及通过浏览器管理备份。v1.6+ 默认在恢复 openclaw.json 后保留新服务器的 gateway.auth.token,避免迁移后 Control UI/Dashboard 出现网关令牌不匹配;仅在同一服务器完整灾难恢复时使用 --overwrite-gateway-token。恢复完成后写入 workspace/.restore-complete.json,智能体应在下次心跳或启动时读取并发送恢复报告,然后删除该文件。

限制与依赖:需要 node、rsync、tar、python3 与 openclaw CLI,可用 which node rsync tar python3 openclaw 检查。切勿在无 --token 时启动 HTTP 服务器,切勿在无 TLS 的情况下将服务器暴露到公网,归档含全部凭据需安全存放。未来 MyClaw 云备份服务暂未提供,其 HTTP API 设计为可兼容该服务。