← 返回 Skills 市场

Obsidian Folder Sync

Name: Obsidian Folder Sync
Author: soroyue

作者 Simon Lau · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

134

总下载

当前安装

版本数

在 OpenClaw 中安装

/install obsidian-folder-sync

功能描述

将任意文件夹（支持任何 AI agent workspace）同步到 Obsidian Vault。 **触发场景**: - 用户说「同步到Obsidian」「备份到Obsidian」「Obsidian同步」「folder sync」 - 需要将任意文件夹（skills、memory、项目文档等）备份到 Obsi...

使用说明 (SKILL.md)

Obsidian Folder Sync

将任意文件夹同步到 Obsidian Vault，支持任何 AI agent 或手动管理的文件夹。

使用方式

bash ~/.openclaw/workspace/skills/obsidian-folder-sync/scripts/sync.sh \x3C源目录> \x3C目标Vault> [目标子目录]

参数说明：

参数	必填	说明
源目录	✅	要同步的文件夹绝对路径
目标Vault	✅	Obsidian Vault 路径
目标子目录	❌	Vault 内的子文件夹（默认：源目录名）

示例：

# 同步 AI agent skills 到 Obsidian
bash sync.sh ~/.openclaw/workspace/skills ~/Obsidian/MyVault

# 同步项目文档到 Vault 的 Projects 子目录
bash sync.sh ~/my-project/docs ~/Obsidian/MyVault Projects

# 同步记忆文件夹
bash sync.sh ~/my-agent/memory ~/Obsidian/MyVault Memory

同步规则

✅ 同步：所有 *.md 文件
❌ 排除：node_modules/、__pycache__/、.git/、.venv/、.clawhub/、.learnings/
📁 映射：源目录结构保持不变地映射到目标子目录

日志

日志文件：~/.openclaw/workspace/logs/obsidian-folder-sync.log

技术细节

工具：rsync --files-from，高效增量同步
文件列表写入 /tmp/obsidian-folder-sync-$$/，执行后自动清理
可通过环境变量覆盖配置（高级用法）

安全使用建议

这看起来是一个实现清晰、范围有限的本地同步脚本，但在安装/运行前请注意： - 验证依赖：确保系统已安装 rsync（脚本依赖），以及常见的 shell 工具（find、sed 等）。注册表元数据没有列出这些依赖——请手动确认。 - 审阅脚本：脚本全部可见且简单，建议在信任的环境中打开并检查是否有你不希望的命令（已检查：无网络、无凭据外传）。 - 先做干运行/测试：在小的测试目录上运行，确认结果符合预期，避免意外覆盖或把不想要的文件复制到 Vault。你可以先复制脚本到本地并手动检查命令（rsync 的选项会决定覆盖行为）。 - 日志与隐私：脚本会把执行信息（包括路径/文件名）写入 ~/.openclaw/workspace/logs/obsidian-folder-sync.log，确认日志位置与内容是否可接受，必要时清理或更改日志路径。 - 备份 Vault：在第一次运行前备份你的 Obsidian Vault，以防同步配置或路径出错导致意外写入。总体结论：功能与声明一致，风险来自常规误操作（路径/覆盖/日志），而非远程数据泄露或过度权限请求。

功能分析

Type: OpenClaw Skill Name: obsidian-folder-sync Version: 1.0.0 The skill bundle provides a legitimate utility for synchronizing Markdown files from a source directory to an Obsidian Vault using standard system tools like `rsync` and `find`. The logic in `scripts/sync.sh` is transparent, lacks network activity or obfuscation, and includes appropriate safety measures such as path validation and temporary file cleanup.

能力评估

ℹ Purpose & Capability

技能名称、描述、SKILL.md 与包含的 scripts/sync.sh 一致：目标是将源目录下的 .md 文件同步到本地 Obsidian Vault。小不一致点：注册表元数据列出“无必需二进制”，但脚本依赖系统工具（rsync、find、sed、mkdir、rm 等）。这属于文档/元数据不准确，而非功能性异常。

✓ Instruction Scope

运行说明明确要求用户提供源目录与 Vault 路径；脚本只读取这些路径下的文件、在 /tmp 写临时文件并在用户主目录下写日志。没有向外部网络发送数据，也没有访问或要求与技能目的无关的系统配置或凭据。

✓ Install Mechanism

无安装规范（instruction-only），只有一个可审计的 shell 脚本。没有从不明 URL 下载或执行远程代码，风险较低。

ℹ Credentials

技能声明不需要环境变量，脚本也不读取额外凭据；唯一使用的环境值是 HOME（用于日志路径）。SKILL.md 提到“可通过环境变量覆盖配置（高级用法）”，但脚本中并未实现这些覆盖，存在文档与实现不完全一致的情况。

✓ Persistence & Privilege

技能不会请求长期驻留（always:false），也不会修改其它技能或系统范围配置。它在用户指定的 Vault 中创建/写入文件并写日志到 ~/.openclaw/workspace/logs，权限范围与其功能相符。

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install obsidian-folder-sync
安装完成后，直接呼叫该 Skill 的名称或使用 /obsidian-folder-sync 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

obsidian-folder-sync 1.0.0 - Initial release. - Sync any folder's `.md` files to a specified Obsidian Vault subdirectory. - Excludes folders like `node_modules`, `.git`, `__pycache__`, and `.venv` from sync. - Preserves original directory structure in the Vault. - Command-line usage with customizable source, destination Vault, and optional subdirectory. - Efficient, incremental sync using `rsync`, with logs stored in `~/.openclaw/workspace/logs/obsidian-folder-sync.log`.

元数据

Slug obsidian-folder-sync

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题