Obsidian Sync_知识管理 skill-PHP中文网

Obsidian Sync

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

在 Clawdbot 工作区与 Obsidian 间同步文件。运行同步服务器，即可通过 OpenClaw 插件实现双向同步。

Obsidian Synclaw 服务器

功能概述

Obsidian Synclaw 服务器是一项面向实际任务的技能，主要用于A 安全文件同步服务器, 用于 Clawdbot 和 Obsidian 之间的双向同步；{} 此技能属于 obsidian- openclaw 的一部分；

核心要点

A obsidian 插件, 允许您与 yo 聊天。
它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。

使用与执行

从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

Obsidian Sync Server

一个安全的文件同步服务器，用于在 Clawdbot 与 Obsidian 之间实现双向同步。

📦 此技能属于 obsidian-openclaw
一款 Obsidian 插件，支持您与 Clawdbot 智能体对话，并在您的知识库（vault）与智能体工作区（workspace）之间同步笔记。

快速开始

SYNC_TOKEN="your-gateway-token" node scripts/sync-server.mjs

配置

环境变量	默认值	说明
`SYNC_PORT`	`18790`	服务器端口
`SYNC_BIND`	`localhost`	绑定地址
`SYNC_WORKSPACE`	`/data/clawdbot`	工作区根路径
`SYNC_TOKEN`	（必需）	认证令牌（使用 Gateway token）
`SYNC_ALLOWED_PATHS`	`notes,memory`	允许访问的子目录列表（以英文逗号分隔）

安全性

仅允许访问已配置的子目录
禁止路径遍历（../）
所有请求均需携带 Authorization: Bearer 头部
默认绑定至 localhost；如需远程访问，请通过 Tailscale serve 暴露服务

API 接口

方法	接口路径	说明
GET	`/sync/status`	健康检查
GET	`/sync/list?path=notes`	列出指定路径下的 Markdown 文件
GET	`/sync/read?path=notes/x.md`	读取文件内容及元数据
POST	`/sync/write?path=notes/x.md`	写入文件（含冲突检测）

通过 Tailscale 暴露服务

tailscale serve --bg --https=18790 http://localhost:18790

作为系统服务运行

用户级 systemd 服务

mkdir -p ~/.config/systemd/user

cat > ~/.config/systemd/user/openclaw-sync.service << 'EOF'
[Unit]
Description=OpenClaw Sync Server
After=network.target

[Service]
Type=simple
Environment=SYNC_TOKEN=your-token-here
Environment=SYNC_WORKSPACE=/data/clawdbot
Environment=SYNC_ALLOWED_PATHS=notes,memory
ExecStart=/usr/bin/node /path/to/skills/obsidian-sync/scripts/sync-server.mjs
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target
EOF

systemctl --user daemon-reload
systemctl --user enable --now openclaw-sync
loginctl enable-linger $USER  # 开机自启