테마 전환

두 번째 뇌 만들기: OpenClaw와 Obsidian/Notion의 심층 메모리 동기화 실전

Easton editorial illustration: multi-tenant AI service platform

OpenClaw를 사용하면서 가장 골치 아픈 점은 늘 잊어버린다는 것입니다. 새 세션을 열 때마다 프로젝트 배경을 다시 소개하고 요구 사항을 설명하며, 이전에 논의한 결정을 반복해서 알려줘야 합니다.

OpenClaw의 obsidian-vault 스킬은 이 문제를 해결합니다. AI와의 상호작용에서 생긴 메모리를 로컬 Obsidian 노트 저장소에 자동으로 동기화해 진정한 의미의 양방향 동기화를 구현합니다.

저비용 ‘새우 키우기’ 가이드: ArkClaw로 AI Agent를 누구나 쉽게 사용하기

요즘 인기인 OpenClaw(바닷가재)는 유용하지만 설정 장벽이 너무 높지 않나요? ByteDance의 Volcano Engine에서 출시한 ArkClaw는 진입 장벽을 크게 낮췄습니다. 서버와 Token 설정을 씨름할 필요 없이 클릭 한 번으로 브라우저를 제어하고, 스크립트를 실행하고, 캘린더를 관리하는 24시간 온라인 ‘AI 일꾼’을 가질 수 있습니다.

무엇보다 정말 저렴합니다. 월 요금은 9.9위안이며, 제 초대 코드 ZLKUK54M(여기에서 가입)을 사용하면 8.9위안이면 됩니다. 프로그래머라면 Coding Plan Pro에 가입해 무료로 이용할 수도 있습니다.

OpenClaw의 메모리 시스템이란?

본격적인 설정에 앞서 배경을 간단히 살펴보겠습니다.

OpenClaw는 skills(스킬)를 통해 기능을 확장하는 오픈 소스 AI Agent입니다. 그중 obsidian-vault 스킬은 Obsidian 노트 저장소와 상호작용하는 용도로 만들어졌습니다.

Obsidian은 로컬 Markdown 파일 기반의 지식 관리 도구입니다. 핵심 개념은 ‘저장소(vault)‘로, 본질적으로는 Markdown 파일만 들어 있는 폴더입니다. 이 설계는 OpenClaw와 매우 잘 맞습니다. OpenClaw는 원래 파일을 읽고 쓸 수 있으므로, 이제 특정 폴더에 노트를 작성하기만 하면 됩니다.

Dave Swift의 실전 경험에 따르면 Obsidian을 연결해 AI Agent에 실제로 영구 보존되는 메모리 시스템을 제공할 수 있습니다. 게다가 이 메모리는 ‘그래프 형태’입니다. Obsidian의 지식 그래프에서 AI의 생각이 다른 노트와 어떻게 연결되는지 확인할 수 있습니다.

50만+
OpenClaw 코드 줄 수
100%
로컬 Markdown 저장
0
추가 API 비용

준비 사항

시작하기 전에 다음 항목을 준비해야 합니다.

필수 항목:

  • OpenClaw 설치 및 설정 완료
  • Obsidian 설치(무료 버전이면 충분)
  • AI 메모리용 Obsidian 저장소

선택 항목(권장):

  • AI가 수정한 내용을 되돌아보기 위한 Git 버전 관리
  • 기본적인 터미널 사용 지식

개인적으로는 오랫동안 쌓아 온 기본 저장소를 AI가 직접 다루게 하는 것보다 AI 전용 저장소를 새로 만드는 것을 권합니다. 안전이 우선이니까요.

1단계: Obsidian 저장소 구조 만들기

Obsidian을 열고 새 저장소를 만든 뒤 이름을 “OpenClawMemory” 또는 원하는 이름으로 지정합니다.

저장소 루트에 다음과 같은 폴더 구조를 만듭니다.

OpenClawMemory/
├── 01-Session-Logs/          # 세션 기록
├── 02-Knowledge-Base/        # 지식 베이스
├── 03-Projects/              # 프로젝트 노트
├── 04-Daily-Notes/           # 일기/메모
└── OPENCLAW.md               # AI 메모리 진입점

이 구조는 제가 직접 시행착오를 거쳐 만든 것입니다. Session-Logs에는 AI와 나눈 각 대화의 요약을 저장하고, Knowledge-Base에는 정리된 지식을 넣으며, Projects에는 프로젝트별 노트를 구성하고, Daily-Notes에는 시간순으로 일상 기록을 남깁니다.

2단계: OPENCLAW.md 설정하기

OPENCLAW.md는 전체 시스템의 핵심입니다. 저장소 루트에 있으며 OpenClaw가 시작될 때마다 자동으로 이 파일을 읽습니다. AI를 위한 ‘메모리 진입점’이라고 생각하면 됩니다.

다음은 제가 현재 사용하는 설정입니다.

# OpenClaw Memory System Configuration

## Current Vault Info
- Vault Name: OpenClawMemory
- Purpose: AI conversation memory and knowledge management
- Created: 2026-03-11

## Directory Structure
- 01-Session-Logs/: 세션 요약과 핵심 결정 저장
- 02-Knowledge-Base/: 지식을 축적하고 [[양방향 링크]] 사용
- 03-Projects/: 프로젝트별로 구성한 노트
- 04-Daily-Notes/: 시간순 기록

## Memory Sync Rules
1. 각 세션이 끝나기 전에 핵심 논의 내용을 01-Session-Logs/YYYY-MM-DD-session.md에 기록
2. 정리된 중요 지식은 02-Knowledge-Base/로 이동
3. [[노트 이름]] 형식으로 양방향 링크 작성
4. 새 프로젝트의 첫 번째 노트에는 반드시 project-info 코드 블록 포함

## My Preferences
- 노트 언어: 한국어
- 태그 스타일: #tag 형식 사용
- 링크 스타일: [[표시 이름|실제 링크]] 형태의 Pipe 문법 우선 사용
- 주의 사항: 장황한 요약은 피하고 bullet point 형식으로 간결하게 기록

이 설정에서 핵심은 ‘메모리 동기화 규칙’ 부분입니다. 언제 노트를 작성하고, 어디에 저장하며, 어떤 형식을 사용할지 AI에 알려줍니다. 그러면 매번 상기시키지 않아도 AI가 자동으로 규칙을 따릅니다.

3단계: obsidian-vault 스킬 설치하기

이제 OpenClaw가 이 저장소를 다루는 방법을 알 수 있게 해야 합니다. obsidian-vault 스킬이 바로 그 역할을 합니다.

먼저 OpenClaw의 스킬 디렉터리를 찾습니다. 일반적인 경로는 다음과 같습니다.

  • Mac/Linux: ~/.openclaw/skills/
  • Windows: %USERPROFILE%\.openclaw\skills\

그런 다음 obsidian-vault 스킬의 디렉터리 구조를 만듭니다.

mkdir -p ~/.openclaw/skills/obsidian-vault

이 디렉터리에 다음 두 파일을 만듭니다.

SKILL.md — 스킬 정의 파일:

---
name: obsidian-vault
description: Obsidian 노트 저장소와 상호작용해 AI 메모리를 영구 저장
version: 1.0.0
---

# Obsidian Vault 스킬

## 개요
이 스킬을 사용하면 OpenClaw가 Obsidian 노트 저장소의 Markdown 파일을 읽고 쓰고 관리하면서 AI 상호작용 메모리를 자동으로 동기화할 수 있습니다.

## 사용 가능한 명령어

### /save-memory
현재 세션의 핵심 정보를 Obsidian 저장소에 저장합니다.

사용법: /save-memory [제목] [분류]
- 제목: 노트 제목
- 분류: session/knowledge/project/daily

예시: /save-memory "API 설계 논의" session

### /search-notes
저장소에서 노트를 검색합니다.

사용법: /search-notes [키워드]

### /link-notes
현재 노트에 양방향 링크를 만듭니다.

사용법: /link-notes [[노트A]] [[노트B]]

## 규칙
- 모든 노트는 Markdown 형식 사용
- Obsidian 고유 문법 지원: [[양방향 링크]], #태그, >인용문
- 세션 기록은 YYYY-MM-DD-제목.md 형식으로 이름 지정
- 중요한 지식에는 #permanent-note 태그 추가

OPENCLAW.md — 스킬의 추가 컨텍스트(선택 사항):

obsidian-vault 스킬을 사용할 때:
1. 현재 프로젝트의 OPENCLAW.md를 먼저 읽고 배경 파악
2. 노트를 작성하기 전에 파일이 이미 존재하는지 확인
3. Frontmatter로 메타데이터(날짜, 태그, 출처) 추가

4단계: 실전 연습

설정이 끝났습니다. 이제 이 시스템을 실제로 사용해 보겠습니다.

상황: 새 프로젝트 논의

OpenClaw와 새로운 블로그 시스템 아키텍처를 논의하고 있다고 가정해 보겠습니다. 논의가 끝난 뒤 이렇게 말할 수 있습니다.

> “오늘 논의한 내용을 Obsidian에 저장해 줘.”

스킬이 올바르게 설정되었다면 OpenClaw는 다음과 같이 동작합니다.

  1. 01-Session-Logs/ 디렉터리에 2025-02-27-blog-system-architecture.md 같은 파일을 만듭니다.
  2. 파일 내용은 다음과 비슷합니다.
---
date: 2025-02-27
type: session-log
tags: [blog, architecture, planning]
---

# 블로그 시스템 아키텍처 논의

## 핵심 결정
- Astro를 정적 사이트 생성기로 사용
- 콘텐츠는 Markdown 파일에 저장
- 댓글 시스템은 Giscus(GitHub Discussions 기반) 사용

## 기술 스택
- 프런트엔드: Astro + React
- 스타일: Tailwind CSS
- 배포: Vercel
- 콘텐츠 관리: 로컬 Markdown + Git

## 할 일
- [ ] 기본 프로젝트 구조 구성
- [ ] Tailwind 설정
- [ ] 홈페이지 레이아웃 설계

## 관련 링크
- [[Astro 공식 문서]]
- [[Tailwind 설정 가이드]]

어떤가요? Frontmatter의 메타데이터 덕분에 노트를 검색하고 분류할 수 있고, 양방향 링크로 지식 베이스의 다른 노트와 연결할 수 있으며, 할 일 목록으로 진행 상황도 바로 추적할 수 있습니다.

자동 동기화 팁

수동 저장도 번거로운가요? 저는 나중에 OPENCLAW.md에 다음 규칙을 추가했습니다.

## 자동 동기화 실행 조건
다음 상황이 발생하면 메모리를 자동으로 저장:
- 세션 시간이 30분을 초과함
- 중요한 아키텍처 결정을 논의함
- 사용자가 명시적으로 "이것을 기억해"라고 말함
- 세션 종료 전 마지막 메시지

이제 OpenClaw가 적절한 시점에 알아서 노트를 저장하므로 매번 상기시킬 필요가 없습니다.

Notion 연동

Notion을 더 익숙하게 사용하는 분도 있을 것입니다. 좋은 소식은 같은 접근법을 Notion에도 적용할 수 있다는 점입니다.

Notion은 API를 제공합니다. 비슷한 스킬을 만들어 OpenClaw가 API를 통해 콘텐츠를 Notion 데이터베이스에 동기화하게 할 수 있습니다. 다만 파일을 직접 다루는 Obsidian과 달리 Notion에서는 다음 작업이 필요합니다.

  1. Notion Integration Token 신청
  2. 해당 Integration에 특정 데이터베이스 공유
  3. Notion API를 사용해 생성, 조회, 수정, 삭제 수행

Markaicode의 튜토리얼에 따르면 OpenClaw와 Notion의 동기화도 약 20분이면 설정할 수 있습니다. 이미 Notion을 많이 사용하고 있다면 이 방법을 고려해 볼 만합니다.

하지만 저는 개인적으로 Obsidian을 더 권합니다. 이유는 다음과 같습니다.

특성ObsidianNotion
데이터 소유권로컬 파일, 완전한 통제권클라우드 저장, 서비스에 의존
형식 범용성순수 Markdown독점 형식, 내보내기 제한
접근 속도로컬 우선, 즉시 열림네트워크 연결에 의존
API 복잡도직접 파일 작업API Token 및 권한 설정 필요
오프라인 사용완전히 지원제한적으로 지원

고급 활용법

기본 설정을 마쳤다면 다음과 같은 고급 기능도 시도할 수 있습니다.

1. 지식 그래프 시각화

Obsidian의 Graph View는 노트 사이의 연결을 보여줍니다. AI가 링크가 포함된 노트를 많이 만들수록 계속 성장하는 지식 네트워크를 볼 수 있습니다. 이렇게 시각화된 ‘두 번째 뇌’는 아주 인상적입니다.

2. 노트 템플릿화

Obsidian에서 다음과 같은 템플릿을 만듭니다.

  • session-template.md — 세션 기록 템플릿
  • project-template.md — 프로젝트 시작 템플릿
  • decision-record.md — 결정 기록 템플릿

그런 다음 OPENCLAW.md에서 OpenClaw가 어떤 템플릿을 사용할지 알려줍니다.

3. 다른 도구와 연동

  • Templater 플러그인으로 더 복잡한 자동화 구현
  • Dataview 플러그인으로 노트 조회 및 표시
  • Git 플러그인으로 원격 저장소에 자동 동기화
  • Alfred/Raycast와 함께 사용해 노트 빠르게 검색

마무리하며

이 시스템을 설정하는 데 한나절이 걸렸지만 그 효과는 계속 이어집니다. 이제 Obsidian을 열면 지난 몇 주 동안 AI와 논의한 중요한 주제를 모두 볼 수 있고, 주제 사이의 연결도 명확합니다. 마치 실제로 학습하고 성장하는 디지털 비서를 얻은 듯한 느낌입니다.

Reddit에서 누군가 이렇게 말했습니다. “Claude Code + Obsidian = graphical Claude memory.” 정확한 표현입니다. 그래프 형태로 시각화되는 것은 노트만이 아니라 AI와 사용자가 함께 구축하는 지식 구조이기도 합니다.

OpenClaw를 사용하고 있다면 이 방법을 꼭 시도해 보길 권합니다. 모든 문제를 마법처럼 해결해 주지는 않지만, 적어도 ‘어제 어디까지 이야기했지?‘를 반복해서 설명할 필요는 없어집니다.


이 글은 제 Obsidian 저장소에도 동기화해 저장했습니다. 태그: #openclaw #obsidian #ai-memory #knowledge-management

FAQ

OpenClaw가 스킬을 찾을 수 없다고 합니다.
스킬 디렉터리 경로가 올바른지 확인하세요. `openclaw config get skills_dir`로 현재 설정된 스킬 디렉터리를 확인할 수 있습니다. obsidian-vault 폴더가 해당 디렉터리 아래에 있고 SKILL.md 파일을 포함하는지 확인하세요.
저장된 파일의 형식이 뒤죽박죽입니다.
OPENCLAW.md에 원하는 Markdown 형식을 명확히 지정하세요. Obsidian은 표준 Markdown과 일부 확장 문법을 지원하지만 단순할수록 안정적입니다. OPENCLAW.md에 구체적인 템플릿 예시를 넣어도 좋습니다.
양방향 링크가 작동하지 않습니다.
Obsidian 설정에서 양방향 링크 기능을 켜야 합니다. 설정 > 링크로 이동해 '링크 자동 생성'이 활성화되어 있는지 확인하세요. 링크 문법도 [[노트 이름]] 형식인지 확인하세요.
이 메모리는 어떻게 백업하나요?
모두 Markdown 파일이므로 Git으로 바로 관리하면 됩니다. 저장소 루트에서 Git 저장소를 초기화하고 정기적으로 commit하면 백업과 변경 이력 확인을 모두 할 수 있습니다. Obsidian의 Git 플러그인으로 자동 동기화할 수도 있습니다.
OpenClaw가 Obsidian 저장소에서 잘못된 작업을 했다면 어떻게 하나요?
바로 이런 상황 때문에 Git 사용을 권장합니다. 문제가 생기면 `git diff`로 변경 사항을 확인하고 `git checkout`으로 이전 상태를 복원할 수 있습니다. 특히 중요한 세션이 끝난 뒤에는 정기적으로 commit하는 것이 좋습니다.

2분 읽기 · 게시일: 2026년 2월 27일 · 수정일: 2026년 9월 4일

댓글

GitHub로 로그인하여 댓글을 남기세요

Easton BlogEaston Blog