iScandium OpenClaw Samba Backup

将 OpenClaw 数据备份到远程 Samba 服务器。当用户提到「备份 openclaw」「设置自动备份」时触发。

OpenClaw Samba 备份

触发条件

关键词	动作
「备份 openclaw」「backup openclaw」	执行完整备份流程
「自动备份」「定时备份」	设置定时任务

执行模式

选项	说明
✅ 自动执行	触发后直接执行备份，无需逐步确认

配置

配置文件：config/default.json（参数说明见 config/params_schema.json）

首次使用前，复制配置模板：

bash

cp config/default.json.example config/default.json

参数	说明
target_server_ip	Samba 服务器 IP
target_share_name	共享文件夹名称
target_share_username	Samba 用户名
target_share_password	Samba 密码
source_admin_username	本服务器管理员用户名
source_admin_password	管理员密码（sudo 用）
max_backups	保留备份数量（默认 7）
source_dir	备份源路径（默认 ~/.openclaw）
target_folder	目标文件夹名（默认 hostname）
mount.vers	SMB 版本（默认 2.0）
mount.mount_point	挂载点（默认 /mnt/iscandium-openclaw-samba-backup）

工作流（1 步）

Step	职责	执行者	文档	输入	输出
01	执行备份	脚本	scripts/backup.sh	config/default.json	Samba 共享目录

备份位置

text

//{target_server_ip}/{target_share_name}/{target_folder}/{timestamp}/

运行备份

bash

bash ~/.openclaw/workspace/skills/iscandium-openclaw-samba-backup/scripts/backup.sh

设置定时备份

首次配置后，使用 OpenClaw 内置 cron：

bash

openclaw cron add \
    --name "OpenClaw Samba 备份" \
    --cron "0 3 * * *" \
    --tz "<your-timezone>" \
    --message "运行备份：bash ~/.openclaw/workspace/skills/iscandium-openclaw-samba-backup/scripts/backup.sh" \
    --session isolated \
    --agent <your-agent> \
    --timeout-seconds 600 \
    --no-deliver

依赖

• cifs-utils（Samba 客户端）

bash

sudo apt install cifs-utils

目录结构

text

iscandium-openclaw-samba-backup/
├── SKILL.md
├── config/
│   ├── default.json           # 私有配置（不发布）
│   ├── default.json.example  # 配置模板
│   └── params_schema.json    # 参数 schema
└── scripts/
    └── backup.sh             # 备份脚本