nutstore-webdav-storage

用于把 OpenClaw 多 agent 工作区 里的身份信息文件与 memory/ 目录同步到 坚果云 WebDAV。

技能定位

这是一个“备份/归档”型 skill，不是运行盘 skill。

统一口径：

本地仍是主存储
坚果云只做远端备份 / 归档 / 恢复源
远端按 agent 分目录
没有特别说明时，默认只备份各 agent 的身份信息文件与 memory/
如老板明确指定，可按 agent 执行自定义文件或目录备份
默认不同步 secrets、cookies、主密钥、虚拟环境、缓存目录

适用平台

适用的是运行 OpenClaw 工作区的主机环境，不是某个消息平台。

当前适用范围：

Linux
macOS
WSL / 其他类 Unix shell 环境（满足 bash + rclone + WebDAV 连通时可用）

前提条件：

可执行 bash
已安装并可调用 rclone
可访问坚果云 WebDAV
OpenClaw 工作区目录结构可用

说明：

该 skill 不依赖 QQ / Telegram / Discord 等消息平台本身
无论从哪个聊天入口触发，最终都必须在满足上述条件的主机上执行
当前不按“原生适配”定义纯 Windows CMD/PowerShell 环境，也不面向纯移动端执行环境

默认路径

本地源目录

默认使用 OpenClaw 工作区根目录：

$WORKSPACE_ROOT

首次运行时，如当前环境还没有明确工作区根目录，建议先初始化：

export WORKSPACE_ROOT="$HOME/.openclaw/workspace"

如你的 OpenClaw 工作区不在默认位置，请改成你自己的实际路径。

远端目标目录

默认坚果云远端目录：

nutstore:/openclaw-backup

目录结构按 agent 分开，例如：

nutstore:/openclaw-backup/chief/
nutstore:/openclaw-backup/backend/
nutstore:/openclaw-backup/frontend/
nutstore:/openclaw-backup/openclawbot/

可按需覆盖。

快速决策

0）第一次使用，想先完成初始化

读：本页“首次运行初始化说明”，再按需继续看 references/rclone-setup.md

1）想先完成坚果云连接配置

读：references/rclone-setup.md

如需了解坚果云 / WebDAV 场景下的使用边界、排障顺序和恢复验收注意事项，再读：references/nutstore-notes.md

2）没特别说明，想直接做一次默认备份

用：scripts/backup-openclaw-to-nutstore.sh

3）老板明确指定了要备份的文件或目录

用：CUSTOM_BACKUP_PATHS + scripts/backup-openclaw-to-nutstore.sh

4）想恢复默认范围（identity / memory）

用：scripts/restore-openclaw-from-nutstore.sh

5）想恢复老板明确指定的某个文件或目录

用：scripts/restore-openclaw-from-nutstore.sh <agent> path <relative-path>

说明：

如 path 模式目标是正式工作区，必须显式设置 RESTORE_FORCE=1
如只是做恢复验收，优先设置 RESTORE_TARGET_ROOT 到测试目录

6）想生成 cron 模板

用：scripts/print-cron-examples.sh

7）想快速检查远端备份是否正常

用：scripts/check-nutstore-backup.sh [agent] [optional-relative-path]

8）想看默认同步/排除范围与自定义规则

读：references/storage-scope.md

9）想看坚果云 / WebDAV 特有注意事项

读：references/nutstore-notes.md

默认同步范围

对每个 agent，没有特别说明时默认同步：

身份信息文件：AGENTS.md、HEARTBEAT.md、IDENTITY.md、MEMORY.md、SOUL.md、TOOLS.md、USER.md
memory/

AGENTS 用法

默认情况下，如不显式传入 AGENTS，脚本会按默认集合执行：

chief backend frontend openclawbot

1）默认全量 agent

适合：没有特别说明时，按默认范围做整套备份。

bash skills/nutstore-webdav-storage/scripts/backup-openclaw-to-nutstore.sh

2）只跑单个 agent

适合：只想处理当前 agent，例如只备份 chief。

AGENTS="chief" bash skills/nutstore-webdav-storage/scripts/backup-openclaw-to-nutstore.sh

3）只跑多个指定 agent

适合：只处理部分 agent，而不是默认全量。

AGENTS="chief backend" bash skills/nutstore-webdav-storage/scripts/backup-openclaw-to-nutstore.sh

说明：

AGENTS 使用空格分隔，不用逗号
未在 AGENTS 中列出的 agent，本轮不会执行
CUSTOM_BACKUP_PATHS 与 AGENTS 可同时组合使用

自定义备份范围

如老板明确指定文件或目录，可通过 CUSTOM_BACKUP_PATHS 传入相对路径列表，按 agent 备份到与默认模式一致的远端目录结构下。

示例：

CUSTOM_BACKUP_PATHS="docs/reports,memory/2026-04-19,TOOLS.md" \
AGENTS="chief" \
bash skills/nutstore-webdav-storage/scripts/backup-openclaw-to-nutstore.sh

示例对应远端位置：

docs/reports → nutstore:/openclaw-backup/chief/docs/reports
memory/2026-04-19 → nutstore:/openclaw-backup/chief/memory/2026-04-19
TOOLS.md → nutstore:/openclaw-backup/chief/TOOLS.md

说明：

多个路径用英文逗号分隔
路径必须是 agent 工作区内的相对路径
文件会备份到 nutstore:/openclaw-backup/<agent>/...
目录会整体同步到 nutstore:/openclaw-backup/<agent>/...
未显式传入 CUSTOM_BACKUP_PATHS 时，仍走默认备份模式

默认排除范围

默认模式下，除身份信息文件与 memory/ 之外的其他业务文件
自定义模式下，未被明确指定的其他业务文件
**/secrets/**
**/cookies/**
**/.secret.key
**/.venv/**
**/.conda-env/**
**/node_modules/**
temp/
其他缓存或敏感目录

工作规则

优先使用 rclone + WebDAV，不把登录密码直接写进脚本。
统一使用应用密码，不使用账号登录密码。
先配置远端，再执行备份/恢复脚本。
未经老板明确要求，不把 secrets、cookies、主密钥同步到坚果云。
远端统一按 agent 分目录管理，不把多个 agent 内容混在一起。
没有特别说明时，默认只备份身份信息文件与 memory/；其他目录需要老板明确要求才扩展。
如启用自定义备份，只允许传 agent 工作区内的相对路径，不接受越界路径。
备份前优先确认目标目录；恢复前优先确认是否允许覆盖本地文件。
自动化调用优先走脚本，不重复手写一长串 rclone 命令。

首次运行初始化说明

第一次使用时，不要直接上 cron，先按下面顺序完成主链路验证：

确认执行环境：bash、rclone、WebDAV 连通、工作区目录正常
初始化远端：bash skills/nutstore-webdav-storage/scripts/config-rclone-nutstore.sh
验证远端：rclone lsd nutstore:
先跑默认备份（必要时先 NUTSTORE_DRY_RUN=1）
至少完成一次恢复 dry-run
如需真实恢复验收，优先设置 RESTORE_TARGET_ROOT 恢复到测试目录
默认模式稳定后，再决定是否启用自定义模式或 cron

最小示例：

export WORKSPACE_ROOT="${WORKSPACE_ROOT:-$HOME/.openclaw/workspace}"
cd "$WORKSPACE_ROOT/chief"

bash skills/nutstore-webdav-storage/scripts/config-rclone-nutstore.sh
rclone lsd nutstore:
NUTSTORE_DRY_RUN=1 bash skills/nutstore-webdav-storage/scripts/backup-openclaw-to-nutstore.sh
NUTSTORE_DRY_RUN=1 bash skills/nutstore-webdav-storage/scripts/restore-openclaw-from-nutstore.sh chief memory

如需详细初始化、cron 与恢复验收说明，读：references/automation.md 如需看 Nutstore / WebDAV 场景注意事项，读：references/nutstore-notes.md

环境变量

脚本支持以下环境变量覆盖默认值：

NUTSTORE_REMOTE：默认 nutstore:/openclaw-backup
WORKSPACE_ROOT：默认 $HOME/.openclaw/workspace
OPENCLAW_ROOT：兼容旧变量名，仅作为 WORKSPACE_ROOT 的回退来源
RESTORE_TARGET_ROOT：恢复目标根目录；默认与 WORKSPACE_ROOT 一致，可覆盖到测试目录做安全验收
RCLONE_BIN：默认 rclone
NUTSTORE_DRY_RUN：设为 1 时执行 --dry-run
AGENTS：默认 chief backend frontend openclawbot
CUSTOM_BACKUP_PATHS：可选，自定义备份相对路径列表，多个路径用英文逗号分隔；远端路径与默认模式保持同一套 agent 根目录结构

何时读附加参考

配置失败 / 首次配置 → references/rclone-setup.md
想调整默认同步范围或查看自定义备份/恢复规则 → references/storage-scope.md
想接 cron / 自动化，或做真实恢复验收 → references/automation.md
想看 Nutstore / WebDAV 特有边界、排障顺序、恢复注意事项 → references/nutstore-notes.md
想直接生成推荐 cron 模板 → scripts/print-cron-examples.sh
想快速检查远端备份状态 → scripts/check-nutstore-backup.sh