技能详情（站内镜像，无评论）
许可证：MIT-0
MIT-0 ·免费使用、修改和重新分发。无需归因。
版本：v1.0.0
统计：⭐ 5 · 2.6k · 20 current installs · 20 all-time installs
⭐ 5
安装量（当前） 20
🛡 VirusTotal ：良性 · OpenClaw ：可疑
Package：andybold/obsidian-sync
安全扫描（ClawHub）
- VirusTotal ：良性
- OpenClaw ：可疑
OpenClaw 评估
The skill implements a local sync server that mostly matches its description, but registry metadata omits required runtime and credentials and there are small mismatches that should be clarified before use.
目的
Name/description match the code: the included script implements a local HTTP sync server for Obsidian/Clawdbot two-way sync. However, the registry metadata lists no required env vars or binaries while the SKILL.md and script require a SYNC_TOKEN (or CLAWDBOT_TOKEN) and Node to run — this is an incoherence between declared purpose/requirements and actual needs.
说明范围
SKILL.md instructs running the included Node script, configuring SYNC_TOKEN, workspace, and allowed subdirectories, and shows a systemd service example. Those instructions are focused on the sync purpose, but they also (a) recommend exposing the server via Tailscale and (b) include starting persistent user services. The doc doesn't document the alternate CLAWDBOT_TOKEN env var present in code. The agent instructions and code can expose local f…
安装机制
There is no install spec (instruction-only), which is low-risk. However, the script requires Node.js at runtime; the registry did not declare Node as a required binary. That mismatch should be corrected in metadata so users know they must have Node installed before running.
证书
The SKILL.md and script require an authentication token (SYNC_TOKEN required) and accept an alternate CLAWDBOT_TOKEN env var. The registry metadata lists no required env vars, so a sensitive credential requirement is undocumented. Requesting a gateway/auth token is reasonable for an authenticated sync server, but the undocumented CLAWDBOT_TOKEN alias and omission from registry are incoherent and mean users might accidentally expose a privilege…
持久
The skill is not marked always:true and is user-invocable, which is appropriate. The SKILL.md includes instructions for running it as a persistent systemd user service; if installed as a long-running service it will have ongoing access to files in the configured workspace. Autonomous model invocation is allowed by default (disable-model-invocation=false) — this is normal for skills, but combined with a long-running service and credential use i…
安装（复制给龙虾 AI）
将下方整段复制到龙虾中文库对话中，由龙虾按 SKILL.md 完成安装。
请把本段交给龙虾中文库（龙虾 AI）执行：为本机安装 OpenClaw 技能「Obsidian Sync」。简介：Sync files between Clawdbot workspace and Obsidian. Run the sync server to enab…。
请 fetch 以下地址读取 SKILL.md 并按文档完成安装：https://raw.githubusercontent.com/openclaw/skills/refs/heads/main/skills/andybold/obsidian-sync/SKILL.md
（来源：yingzhi8.cn 技能库）SKILL.md
---
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)**
> 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`