yaoyao-cloud-backup

🦞 云端与外部备份同步套件 - 零配置、零手动

核心理念

安装即用，首次访问自动引导

• ✅ 安装后首次访问即自动引导配置
• ✅ 不需要记任何命令
• ✅ 不需要查任何文档
• ✅ 遇到云备份话题自动询问

首次使用体验

场景：用户首次访问云备份功能

你：云备份怎么用？

摇摇：
  🔍 检测到您还没有配置任何云备份服务
  
  📋 推荐方案（国内用户首选）：
  
  [1] 🥜 坚果云
      国内可用，稳定可靠，免费额度够用
      → 适合：大多数国内用户
      
  [2] ☁️ 阿里云 OSS
      企业级存储，低成本
      → 适合：有技术背景的用户
      
  [3] 🖥️ Samba/NAS
      局域网高速传输
      → 适合：有 NAS 的用户
      
  [4] 📡 SFTP
      SSH 加固，安全可靠
      → 适合：有自己服务器的用户
  
  请选择编号（1-4），或说"跳过"稍后配置

自动检测范围

快速安装指南

选择 1：坚果云（推荐国内用户）🥜

特点：国内可用、稳定、免费额度够用

步骤：

1. 访问 https://www.jianguoyun.com/ 注册
2. 进入「账户信息」→「安全设置」→「第三方应用管理」
3. 创建应用密码
4. 把邮箱和应用密码告诉我，我帮你配置

选择 2：阿里云 OSS ☁️

特点：企业级存储、低成本、国内高速

步骤：

1. 访问 https://www.aliyun.com/product/oss 开通
2. 创建 AccessKey（Root AccessKey 或子用户 AccessKey）
3. 创建存储桶（Bucket）
4. 把 AccessKey ID/Secret 和 Bucket 名称告诉我，我帮你配置

选择 3：Samba/NAS 🖥️

特点：局域网高速传输，无需互联网

步骤：

1. 确保 NAS 已开启 SMB/Samba 服务
2. 在 NAS 上创建共享文件夹（如 memory 或 家庭共享）
3. 告诉我 NAS 的 IP 地址、共享名称和登录信息，我帮你配置

凭证配置：在 ~/.openclaw/credentials/secrets.env 中添加：

SAMBA_HOST=192.168.10.216
SAMBA_USER=你的用户名
SAMBA_PASS=你的密码
SAMBA_SHARE=家庭共享
SAMBA_PORT=445
SAMBA_REMOTE_PATH=/

依赖：pysmb（自动安装）

使用：

# 上传到所有已配置的云服务（包括Samba）
python3 scripts/unified_sync.py --upload

# 查看状态
python3 scripts/unified_sync.py --status

选择 4：SFTP 📡

特点：SSH 加固，安全可靠

步骤：

1. 确保服务器已开启 SSH 服务
2. 告诉我服务器地址、端口、用户名和密码，我帮你配置

使用方式

自动引导（首次/未配置时）

你：云备份怎么用？
     备份到云
     云同步
     ...

摇摇：自动检测 → 发现未配置 → 直接引导安装

已配置后的同步

# 上传到所有已配置的云服务
python3 scripts/unified_sync.py --upload

# 从所有云服务下载
python3 scripts/unified_sync.py --download

# 查看状态
python3 scripts/unified_sync.py --status

工作流程

用户首次访问云备份功能
          │
          ▼
┌─────────────────────────┐
│   自动检测云服务配置     │
└────────────┬────────────┘
             │
      ┌──────┴──────┐
      │             │
  已有配置       未配置
      │             │
      ▼             ▼
   执行同步     首次自动引导
                      │
                      ▼
              ┌───────────────┐
              │ 显示推荐方案   │
              │ 用户选择编号   │
              │ 自动配置完成  │
              └───────────────┘

凭证管理

所有凭证存储在 ~/.openclaw/credentials/secrets.env：

# 坚果云 WebDAV
WEBDAV_URL=https://dav.jianguoyun.com/dav/
WEBDAV_USERNAME=你的邮箱
WEBDAV_PASSWORD=你的密码

# 阿里云 OSS
S3_ENDPOINT=https://oss-cn-hangzhou.aliyuncs.com
S3_ACCESS_KEY=你的 AccessKey ID
S3_SECRET_KEY=你的 AccessKey Secret
S3_BUCKET=你的 bucket 名称

# IMA 知识库
IMA_OPENAPI_CLIENTID=xxx
IMA_OPENAPI_APIKEY=xxx

# Samba/NAS（配置文件：config/samba.json）
# 详见上方"选择 3：Samba/NAS"章节

安全特性