AndyBold

Obsidian Sync

AI 智能体v1.0.0
作者:AndyBold更新于 2026-05-11obsidian-sync@clawhub_andybold/obsidian-sync
任务自动化工作流编排#Sync

据 AlphaMoat 统计,截至 2026-10,Obsidian Sync 累计下载 7,776 次、获 7 个星标,按累计下载量在本次参与排名的 10,914 个 AI 技能中排名第 3,572 位,在「AI 智能体」分类(1,632 个)中排名第 478 位。

列表默认按累计下载量排序,也可按星标排序;详情页排名按累计下载量计算。

累计下载
7,776
星标
7
全站下载量排名
#3,572
全站前 33% · 「AI 智能体」前 30%
平台累计下载星标评论
ClawHub ↗4,9176-
SkillHub ↗7,7767—

各平台的计数口径不同,统计时间不一致。

这个技能是做什么的

它作为 OpenClaw Obsidian 插件的后端,提供 HTTP 同步服务,列出、读取、写入并报告配置路径下的 Markdown 文件状态,支持冲突检测。安全方面仅开放配置的子目录、阻断路径穿越、要求 Bearer 令牌,默认绑定 localhost(远程访问经 Tailscale serve);文档说明可注册为 systemd 用户服务常驻运行。

资料发布于 2026-10-27

可以用来做什么

  • 在 Obsidian 与 Clawdbot 工作区之间双向同步笔记
  • 为 OpenClaw Obsidian 插件提供本地同步后端
  • 限制可访问子目录并保护同步接口

什么时候用

  • 希望 Obsidian 笔记与智能体工作区保持一致时
  • 配置本地同步服务并控制暴露范围时
  • 需要文件读写、冲突检测与审计日志时

示例提示词

以下是根据技能文档生成的示例,不代表实际运行结果。

启动同步服务并在 localhost 上监听。
只允许同步 notes 和 memory 两个子目录。
把它注册成 systemd 用户服务常驻后台。

月度数据趋势

累计下载7,776
2,9805,5568,1312026-03 · 累计下载 3,3352026-05 · 累计下载 4,0912026-06 · 累计下载 4,2842026-07 · 累计下载 4,6192026-08 · 累计下载 4,8582026-09 · 累计下载 5,3602026-10 · 累计下载 7,77626-0326-0926-10
星标7
6772026-03 · 星标 62026-05 · 星标 62026-06 · 星标 62026-07 · 星标 72026-08 · 星标 72026-09 · 星标 72026-10 · 星标 726-0326-0926-10

2026-09 起统计方法调整:同名技能按作者分别统计,并覆盖全部技能。图中虚线为调整前的月份,与之后的数据不直接比较,也不计算跨越调整的增长。

月份累计下载环比星标
2026-107,776—7
2026-095,360—7
2026-084,858+5.2%7
2026-074,619+7.8%7
2026-064,284+4.7%6
2026-054,091—6
2026-033,335—6

SKILL.md 原文

以下是作者发布的原始文件,按纯文本显示,本站未做修改或审核;其中的链接不可点击,命令请核实后再运行。抓取于 2026-10-23。

2.9 KB · ClawHub v1.0.0
---
name: obsidian-sync
description: Sync files between Clawdbot workspace and Obsidian. Run the sync server to enable two-way file synchronization with the OpenClaw Obsidian plugin.
---

# Obsidian Sync Server

A secure file sync server for two-way synchronization between Clawdbot and Obsidian.

> **📦 This skill is part of [obsidian-openclaw](https://github.com/AndyBold/obsidian-openclaw)**  
展开全部(共 95 行)
> An Obsidian plugin that lets you chat with your Clawdbot agent and sync notes between your vault and the agent's workspace.

## Quick Start

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

## Configuration

| Environment Variable | Default | Description |
|---------------------|---------|-------------|
| `SYNC_PORT` | `18790` | Server port |
| `SYNC_BIND` | `localhost` | Bind address |
| `SYNC_WORKSPACE` | `/data/clawdbot` | Root workspace path |
| `SYNC_TOKEN` | (required) | Auth token (use Gateway token) |
| `SYNC_ALLOWED_PATHS` | `notes,memory` | Comma-separated allowed subdirectories |

## Security

- Only configured subdirectories are accessible
- Path traversal (`../`) is blocked
- All requests require `Authorization: Bearer <token>`
- Bind to localhost; expose via Tailscale serve for remote access

## API Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/sync/status` | Health check |
| GET | `/sync/list?path=notes` | List markdown files |
| GET | `/sync/read?path=notes/x.md` | Read file + metadata |
| POST | `/sync/write?path=notes/x.md` | Write file (conflict detection) |

## Exposing via Tailscale

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

## Running as a Service

### User systemd service

```bash
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  # Start on boot
```

## Obsidian Plugin

This skill provides the backend for the **OpenClaw Obsidian plugin**:

**[github.com/AndyBold/obsidian-openclaw](https://github.com/AndyBold/obsidian-openclaw)**

The plugin provides:
- 💬 **Chat sidebar** — Talk to your Clawdbot agent from Obsidian
- 📁 **File actions** — Create, edit, delete notes via conversation
- 🔄 **Two-way sync** — Keep notes synchronized between vault and agent
- 🔒 **Secure storage** — OS keychain integration for tokens
- 📋 **Audit logging** — Track all file operations

Install the plugin via [BRAT](https://github.com/TfTHacker/obsidian42-brat) using: `AndyBold/obsidian-openclaw`

「AI 智能体」分类下的热门技能

数据月份:2026-10 · 下载/星标数聚合自公开技能注册库(ClawHub、SkillHub),按月更新。口径说明见数据方法。