openclaw-sync

# 🔄 OpenClaw 轻量同步

基于 **rclone + cron** 的数据备份方案，定时同步 workspace 到云端。

## 特点

- ✅ **轻量**：无常驻进程，cron 定时触发
- ✅ **通用**：支持 70+ 云存储（七牛/腾讯/阿里/百度/Google Drive...）
- ✅ **智能**：无变化不传输，节省流量
- ✅ **简单**：一条命令完成配置

## 快速开始

### 1. 安装 rclone

```bash
# 自动安装
curl https://rclone.org/install.sh | sudo bash

# 或手动安装
sudo apt-get install rclone
```

### 2. 配置云存储

```bash
# 交互式配置
rclone config

# 按照提示选择云服务商，填写密钥
```

### 3. 配置同步

```bash
cd skills/openclaw-sync

# 编辑配置
vim config/sync-config.json
```

```json
{
  "remote": "myqiniu",           // rclone 配置的 remote 名称
  "bucket": "mybucket",          // 存储桶名称
  "prefix": "openclaw-backup",   // 云端目录前缀
  "interval": "5"                // 同步间隔（分钟）
}
```

### 4. 启动同步

```bash
# 手动测试
bash scripts/sync.sh

# 添加到 cron（推荐）
bash scripts/setup-cron.sh
```

## 目录结构

```
skills/openclaw-sync/
├── config/
│   ├── sync-config.json      # 同步配置
│   └── sync-list.txt         # 文件过滤规则
├── scripts/
│   ├── sync.sh               # 同步脚本
│   ├── setup-cron.sh         # 安装定时任务
│   └── status.sh             # 查看状态
├── logs/
│   └── sync.log              # 同步日志
└── SKILL.md                  # 本文件
```

## 配置文件

### sync-config.json

```json
{
  "remote": "myqiniu",           // rclone remote 名称
  "bucket": "mybucket",          // 存储桶
  "prefix": "openclaw-backup",   // 云端前缀
  "interval": "5",               // 同步间隔（分钟）
  "syncDelete": false            // 是否同步删除
}
```

### sync-list.txt

```
# 包含规则（+开头）
+MEMORY.md
+memory/
+IDENTITY.md
+USER.md
+SOUL.md
+AGENTS.md
+TOOLS.md
+HEARTBEAT.md
+BOOTSTRAP.md
+README.md
+skills/
+tools/

# 排除规则（-开头）
-.git/**
-node_modules/**
-*.tmp
-*.log
-.DS_Store
```

## 常用命令

| 命令 | 说明 |
|------|------|
| `bash scripts/sync.sh` | 手动执行同步 |
| `bash scripts/setup-cron.sh` | 安装定...

# OpenClaw 数据同步 - 使用说明

## 快速开始

### 1. 首次配置

运行配置向导：

```bash
cd /home/node/.openclaw/workspace/skills/openclaw-sync
bash scripts/setup.sh
```

配置向导会引导你：
- 选择云存储服务商（腾讯云/七牛云/阿里云）
- 配置访问密钥
- 选择同步模式（实时/定时/手动）
- 测试连接

### 2. 手动同步

立即同步数据到云端：

```bash
bash scripts/sync-now.sh
```

### 3. 查看云端文件

列出云端备份的文件：

```bash
bash scripts/list-remote.sh
```

### 4. 恢复数据

从云端恢复数据到本地：

```bash
bash scripts/restore.sh
```

## 同步模式

### 实时同步

文件修改后自动同步到云端（延迟约 10-30 秒）。

启动服务：
```bash
sudo cp systemd/openclaw-sync.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable openclaw-sync
sudo systemctl start openclaw-sync
```

查看状态：
```bash
sudo systemctl status openclaw-sync
```

### 定时同步

每天固定时间同步一次（通过 crontab）。

配置向导会自动添加定时任务，也可以手动配置：
```bash
# 每天凌晨 3 点同步
0 3 * * * /home/node/.openclaw/workspace/skills/openclaw-sync/scripts/sync-now.sh >> /var/log/openclaw-sync.log 2>&1
```

### 手动同步

需要时手动触发：
```bash
bash scripts/sync-now.sh
```

## 同步的数据

默认同步以下数据（可在 `data/sync-list.txt` 中修改）：

- **核心数据**：MEMORY.md, memory/, USER.md, IDENTITY.md, SOUL.md 等
- **技能配置**：skills/*/config.json
- **自定义工具**：tools/, *.sh

## 配置文件

- `config/rclone.conf` - rclone 配置（包含云存储密钥）
- `config/backup.json` - 备份配置（云服务商、bucket 等）
- `data/sync-list.txt` - 同步文件列表

## 故障排查

### 同步失败

1. 检查 rclone 配置：
```bash
rclone config show --config config/rclone.conf
```

2. 测试连接：
```bash
rclone ls openclaw-backup:YOUR_BUCKET --config config/rclone.conf
```

3. 查看日志：
```bash
tail -f /var/log/openclaw-sync.log
```

### 恢复失败

1. 确认云端有数据：
```bash
bash scripts/list-remote.sh
```

2. 检查本地权限：
```bash
ls -la /home/node/.openclaw/workspace/
```

## 成本估算

数据量通常 < 1MB，成本几乎为零：

| 云服...