← Back to Skills Marketplace
134
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install obsidian-folder-sync
Description
将任意文件夹（支持任何 AI agent workspace）同步到 Obsidian Vault。 **触发场景**: - 用户说「同步到Obsidian」「备份到Obsidian」「Obsidian同步」「folder sync」 - 需要将任意文件夹（skills、memory、项目文档等）备份到 Obsi...
README (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-$$/，执行后自动清理 - 可通过环境变量覆盖配置（高级用法）
Usage Guidance
这看起来是一个实现清晰、范围有限的本地同步脚本，但在安装/运行前请注意：
- 验证依赖：确保系统已安装 rsync（脚本依赖），以及常见的 shell 工具（find、sed 等）。注册表元数据没有列出这些依赖——请手动确认。
- 审阅脚本：脚本全部可见且简单，建议在信任的环境中打开并检查是否有你不希望的命令（已检查：无网络、无凭据外传）。
- 先做干运行/测试：在小的测试目录上运行，确认结果符合预期，避免意外覆盖或把不想要的文件复制到 Vault。你可以先复制脚本到本地并手动检查命令（rsync 的选项会决定覆盖行为）。
- 日志与隐私：脚本会把执行信息（包括路径/文件名）写入 ~/.openclaw/workspace/logs/obsidian-folder-sync.log，确认日志位置与内容是否可接受，必要时清理或更改日志路径。
- 备份 Vault：在第一次运行前备份你的 Obsidian Vault，以防同步配置或路径出错导致意外写入。
总体结论：功能与声明一致，风险来自常规误操作（路径/覆盖/日志），而非远程数据泄露或过度权限请求。
Capability Analysis
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.
Capability Assessment
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，权限范围与其功能相符。
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install obsidian-folder-sync - After installation, invoke the skill by name or use
/obsidian-folder-sync - Provide required inputs per the skill's parameter spec and get structured output
Version History
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`.
Metadata
Frequently Asked Questions
What is Obsidian Folder Sync?
将任意文件夹（支持任何 AI agent workspace）同步到 Obsidian Vault。 **触发场景**: - 用户说「同步到Obsidian」「备份到Obsidian」「Obsidian同步」「folder sync」 - 需要将任意文件夹（skills、memory、项目文档等）备份到 Obsi... It is an AI Agent Skill for Claude Code / OpenClaw, with 134 downloads so far.
How do I install Obsidian Folder Sync?
Run "/install obsidian-folder-sync" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Obsidian Folder Sync free?
Yes, Obsidian Folder Sync is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Obsidian Folder Sync support?
Obsidian Folder Sync is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Obsidian Folder Sync?
It is built and maintained by Simon Lau (@soroyue); the current version is v1.0.0.
More Skills