Openclaw용 Note Sync

AI 에이전트가 Model Context Protocol (MCP) 도구를 사용하여 아이디어, 알림 및 일기 항목을 로컬 Markdown 파일에 추가할 수 있도록 하는 노트 작성 기술입니다.

lgwventrue
v1.0.1
Jun 11, 2026
0
511
0

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.

npx clawhub@latest install note-sync

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌
~/.openclaw/skills/
워크스페이스
<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.

Clawhub를 사용해서 note-sync 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

Note Sync란 무엇인가요?

Note Sync는 AI 대화와 개인 지식 관리 사이의 간극을 메우기 위해 설계된 통합 도구입니다. 로컬에서 실행되는 맞춤형 Model Context Protocol (MCP) 서버를 활용하여, 이 기술은 AI 어시스턴트가 대화 메시지, 브레인스토밍된 아이디어 및 할 일을 로컬 파일에 직접 저장할 수 있도록 지원합니다. AI 작업 공간을 떠나지 않고도 통찰력을 디스크에 정리하고자 하는 개발자와 파워 유저를 위한 Openclaw Skills의 필수 구성 요소입니다.

이 기술은 append_note 도구를 통해 작동하며, 어시스턴트가 호스트 머신 또는 Windows Subsystem for Linux (WSL) 환경의 로컬 저장소와 안전하게 상호 작용할 수 있게 합니다. 파일 쓰기를 처리하고, 지정된 헤더 아래에 노트를 직접 추가하며, 사용자 의도에 따라 정보를 자동으로 분류합니다. 이를 통해 개인 노트, 일기 및 할 일 목록을 완전히 로컬 Markdown 형식으로 구조화된 상태로 유지할 수 있습니다.

Note Sync 활용 사례

  • AI 대화 세션 중에 떠오르는 생각, 통찰력 또는 코드 조각을 자동으로 캡처하여 로컬 일기에 직접 저장.
  • 새 항목을 전용 파일에 추가하여 작업 백로그 또는 할 일 목록 유지.
  • AI 분석 중 생성된 연구 노트나 다단계 실행 계획을 디스크에 직접 취합.
  • 수동 복사/붙여넣기 없이 개인 일기나 일일 로그를 로컬 Markdown 파일로 정리.

Note Sync 작동 원리

  1. 사용자가 AI 에이전트에게 정보를 저장하거나 기록하도록 요청합니다(예: '이 아이디어를 내 일기에 저장해 줘').
  2. AI 어시스턴트가 append_note 도구를 트리거하여 파일 이름(예: 'journal' 또는 'todo')을 자동으로 추론하고 Markdown 콘텐츠를 구조화합니다.
  3. note-sync MCP 서버가 명령을 수신하고 새 텍스트 블록을 지정된 로컬 Markdown 파일에 안전하게 추가합니다.
  4. 서버가 성공 확인을 반환하고 AI 에이전트를 업데이트하여 사용자의 노트가 작업 공간에 안전하게 저장되었음을 알릴 수 있도록 합니다.

Note Sync 설정 가이드

가장 안정적인 생산성 Openclaw Skills 중 하나인 Note Sync를 구성하려면 다음 단계를 따르세요:

1단계: 저장소 복제 및 MCP 바이너리 빌드

보조 저장소를 머신(또는 WSL 내)으로 복제하고 Go 실행 파일을 컴파일합니다:

git clone https://github.com/your-org/go-note-sync-mcp.git
cd go-note-sync-mcp/mcp-server
go build -o note-sync-mcp.exe

환경 변수 NOTE_SYNC_REPO가 이 복제된 디렉토리의 루트를 직접 가리키도록 설정하세요.

2단계: openclaw.json 구성

Openclaw 구성 파일(보통 ~/.openclaw/openclaw.json에 위치)을 편집하여 이 기술과 로컬 MCP 서버를 등록합니다. <WSL_REPO>를 로컬 저장소 경로로, <SKILL_DIR>을 ClawHub가 기술을 설치한 위치(보통 ~/.openclaw/skills/note-sync)로 바꿉니다:

{
  "skills": {
    "entries": {
      "note-sync": {
        "enabled": true,
        "env": {
          "NOTE_SYNC_REPO": "<WSL_REPO>"
        }
      }
    }
  },
  "mcp": {
    "servers": {
      "note-sync": {
        "command": "<SKILL_DIR>/scripts/note-sync-mcp.sh",
        "args": []
      }
    }
  }
}

3단계: 게이트웨이 재시작 및 확인

게이트웨이 프로세스를 재시작하고 기술과 도구가 올바르게 로드되었는지 확인합니다:

openclaw gateway restart
openclaw skills info note-sync
openclaw mcp list

성공하면 append_note 도구가 터미널 목록에 표시되어야 합니다.

Note Sync 데이터 스키마 및 분류 체계

Note Sync 기술은 <repo>/mcp-server/notes/ 디렉토리 아래의 로컬 파일 시스템에서 데이터를 동적으로 관리합니다. 각 노트는 추론된 제목을 파일 이름으로 사용하여 개별 Markdown (.md) 파일로 저장됩니다.

디렉토리 레이아웃

<NOTE_SYNC_REPO>/
└── mcp-server/
    ├── notes/
    │   ├── 感悟.md
    │   ├── 待办.md
    │   └── journal.md
    └── note-sync-mcp.exe

MCP 도구 매개변수 스키마

주요 도구 인터페이스 append_note는 JSON으로 구조화된 다음 페이로드를 기대합니다:

인수 유형 필수 설명
title string 예 노트의 파일 이름 및 제목(예: 'journal', 'todo')
content string 예 파일에 추가할 Markdown 호환 본문 콘텐츠

Note Sync 고급 기능

  • WSL 및 Windows 네이티브 상호 운용성: WSL 경계를 넘어 Windows .exe 파일을 실행하는 쉘 래퍼를 사용하여 환경 간에 원활하게 실행되도록 설계되었습니다.
  • 사용자 지정 디렉토리 재정의: 경로 구성을 쉽게 조정하여 노트 저장소를 Obsidian 볼트 디렉토리나 Logseq 그래프로 직접 지정할 수 있습니다.
  • 동적 제목 추론: LLM 기반 지능을 사용하여 대화 맥락을 분석하고 사용자 프롬프트 없이도 적절한 파일 아래에 노트를 자동으로 분류합니다.
  • Model Context Protocol 통합: 강력한 MCP 도구 표준을 활용하여 다른 Openclaw Skills 및 최신 에이전트 인터페이스와의 높은 호환성을 보장합니다.

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Requires
Github Stars: 0
forks: 0

추천*