/install quark-backup
quark-backup
功能概述
将 OpenClaw 的 .openclaw 目录打包为 tar.gz 并上传到夸克网盘指定目录,支持每日定时自动执行。
快速开始
手动执行备份
cd /home/openclaw/.openclaw/workspace
bash tools/kuake/backup-openclaw-full.sh
脚本会自动:
- 打包
.openclaw(排除 node_modules、浏览器缓存) - 在夸克网盘
/openclaw/创建目标目录 - 上传压缩包
- 校验上传是否成功
配置每日自动备份(04:00)
使用 cron 调度:
# 每天 04:00 执行备份
0 4 * * * cd /home/openclaw/.openclaw/workspace && bash tools/kuake/backup-openclaw-full.sh >> /home/openclaw/log/backup.log 2>&1
工作流程
首次配置(需要 Cookie)
- 登录 https://pan.quark.cn
- 浏览器开发者工具复制 Cookie
- 写入
/home/openclaw/.config/openclaw-quark-backup.env:KUAKE_COOKIE='你的完整Cookie'
备份脚本结构
tools/kuake/
├── bin/kuake # kuake CLI 二进制
├── use-kuake.sh # 包装脚本(设置 Cookie 环境变量)
├── backup-openclaw-full.sh # 主备份脚本
└── .env # 不存在则跳过(Cookie 由上一步提供)
打包排除项
node_modules(可重建,节省空间)- Chrome 浏览器配置文件
- CDP profile 和 browser-runtime
tools/kuake/.env(敏感信息)
本地保留备份(可选)
如需在本地也留一份备份,修改脚本将 ARCHIVE 路径改为本地目录:
LOCAL_BACKUP_DIR="${OPENCLAW_HOME}/local-backups"
ARCHIVE="${LOCAL_BACKUP_DIR}/openclaw-full-backup-${STAMP}.tar.gz"
mkdir -p "$LOCAL_BACKUP_DIR"
恢复流程
- 从夸克网盘
/openclaw/下载最新备份 - 解压到新机器的
/home/openclaw/下 - 重新安装 OpenClaw:
npm install -g openclaw - 重新配置 cron 任务
- 重新配置夸克 Cookie
注意事项
- Cookie 有时效性,约 30 天检查一次是否失效
- 备份文件命名格式:
openclaw-full-backup-YYYYMMDD-HHMMSS.tar.gz - 备份目标目录:
/openclaw/(可修改KUAKE_REMOTE_DIR环境变量) - 备份本身不包含 OpenClaw 全局包,需在新环境重新安装
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install quark-backup - After installation, invoke the skill by name or use
/quark-backup - Provide required inputs per the skill's parameter spec and get structured output
What is quark-backup?
OpenClaw 定时备份技能,将 .openclaw 目录打包上传至夸克网盘。触发条件:(1)用户提到"备份"、"自动备份"、"定时备份"、"上传夸克";(2)配置每天 04:00 自动备份任务;(3)手动触发一次性备份。执行时会打包 workspace、memory、sessions、配置等,排除 node_... It is an AI Agent Skill for Claude Code / OpenClaw, with 38 downloads so far.
How do I install quark-backup?
Run "/install quark-backup" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is quark-backup free?
Yes, quark-backup is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does quark-backup support?
quark-backup is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created quark-backup?
It is built and maintained by zzqlemon (@z157181773); the current version is v1.0.0.