Claude Code + OpenClaw + Obsidian을 연결하는 지식 베이스 구축기

이번주에는 조금전 올린글인 마왕성 AI 에이전트 팀 구성도 했지만, 저의 지식 보관소로 사용할 공간도 만들었습니다.

요즘 핫하기 그지 없는 Obsidian Vault를 활용해서 만들었습니다.


환경이 달라도 생각보다 어렵지 않았던 Obsidian

제 OpenClaw가 돌아가는 PC 환경은 기본 OS는 Windows, OpenClaw는 WSL 환경하에서 돌아가기에 Obsidian 또한 WSL 환경하에 설치해야 하나... 하고 잠깐 고민했었는데요.

내 컴퓨터에 마크다운으로 저장된다는 이 특징 때문인지, 제 고민이 무색하게도 양쪽에서 접근이 너무 쉽게 된다는 것을 알게 되었습니다.

그래서 고민없이 Obsidian을 지식 보관 창고로 사용하기로 했습니다.

생각보다 너무 간단하게도 경로 하나면 끝이더라고요.

저는 WSL2 환경에서 작업하는데, Windows에 Obsidian을 설치하고 Vault를 Windows 경로에 두면 WSL에서 /mnt/c/...로 바로 접근됩니다. 복사도, 동기화도 필요 없어요.

Windows:  C:\Users\550sn\ObsidianVault\
WSL:      /mnt/c/Users/550sn/ObsidianVault/
Claude Code, OpenClaw:  동일 경로 접근 가능

설계 전에 먼저 한 것 — 용도 정리

Vault를 만들기 전에, "뭘 담을 거냐"를 먼저 정했습니다.

제 경우엔 이랬어요:

  • 유튜브 채널 두 개의 기획 및 에피소드 관리

  • 강의 제작 메모

  • AI/자동화 공부 노트

  • 독서 후 인사이트 정리

  • 아이디어 연결 및 발전

이게 명확해야 폴더 구조를 잡을 수 있습니다.

용도가 불명확한 채로 폴더부터 만들면, 나중에 "이게 어디 들어가지?"가 반복됩니다.

※ 옵시디언 청강을 하면서 받았던 CMDS 가이드 파일들은 보면서 이점을 특히 더 깊게 느꼈습니다.

※ CMDS 가이드 파일을 봤을 때 드는 느낌은 너무 잘 만들어진 구성이라는 것을 알 수 있었고, 만든 분의 수많은 시행착오 끝에 이와 같은 구성을 만들었구나 하는점을 느꼈습니다.
이 가이드를 그대로 사용하면 단번에 퀀텀 점프를 할 수도 있었겠지만, 제가 충분히 이해하지 못한 영역의 내용 또한 너무 많다고 느꼈기에, 제 기준으로 다시 처음부터 구성해 보자고 마음 먹었습니다.


폴더 구조 — 4자리 번호 체계

폴더에 번호를 붙였습니다. 이유는 두 가지예요.

  1. Obsidian에서 정렬이 자동으로 됩니다

  2. AI 에이전트에게 "애매하면 0000_Inbox/에 넣어"라고 지시할 수 있습니다

굳이 4자리 분류 번호체계를 만든 이유는 "앞으로 어디까지 확장될지 아직은 자신이 없어서" 라고 해 두겠습니다.

ObsidianVault/
├── 0000_Inbox/             # 미분류 빠른 메모
│   ├── 0010_RawIdea/       # 날것의 아이디어 캡처
│   └── 0020_AIAgents/      # AI 회의 결과
├── 0100_Daily/
│   ├── 0110_MyDaily/       # 나의 일일 기록
│   └── 0120_AIDaily/       # AI 에이전트 작업 일지
├── 0200_Projects/
│   ├── 0210_LGEnsol/       # 회사 업무 ⚠️ 민감정보
│   ├── 0220_TOffice/       # 업무의 잔머리 채널
│   ├── 0230_Courses/       # 강의 제작
│   └── 0240_SSong/         # SSongDevil 채널
├── 0300_Notes/             # 주제별 영구 노트
│   ├── 0310_AI/
│   ├── 0320_Manufacturing/
│   ├── 0330_Productivity/
│   └── 0340_Ideas/
├── 0400_Resources/
│   ├── 0410_Books/         # 독서 노트
│   └── 0420_References/    # 웹 클리핑, 참고자료
├── 0500_Templates/         # 노트 템플릿 모음
└── 9999_Archive/           # 완료/비활성 노트

0000_Inbox를 두는 이유: AI 에이전트가 "어디 넣을지 모르겠다"고 판단할 때, 일단 여기 넣고 나중에 정리합니다. Inbox가 없으면 에이전트가 멋대로 분류하다가 엉뚱한 곳에 넣을 수 있어요.

0010_RawIdea0020_AIAgents를 분리한 이유: 처음 아이디어가 떠올랐을 때의 원문과, AI와 회의한 결과물은 성격이 다릅니다. 나중에 "이 아이디어가 어떻게 발전했는지" 추적할 수 있게 분리했어요.


노트 작성 규칙 — frontmatter가 핵심

모든 노트는 이 형식으로 시작합니다:

---
title: 노트 제목
date: 2025-04-04
tags: [ai, automation]
type: daily | project | note | resource | idea
status: inbox | active | done | archived
related: []
---

왜 이게 중요하냐면, AI 에이전트가 이 메타데이터를 보고 노트를 분류하고 처리하기 때문입니다.

typeidea인 노트는 0340_Ideas/에, typeproject0200_Projects/ 아래 적절한 폴더에 들어갑니다. frontmatter 없이 감으로 분류시키면 결과가 들쭉날쭉해져요.

태그 체계도 미리 정했습니다:

#ai / #llm / #claude / #openclaw
#youtube / #콘텐츠 / #강의
#manufacturing / #spc / #oee
#productivity / #automation / #n8n
#idea / #reading / #project / #daily

에이전트에게 "적절한 태그를 붙여줘"라고 하면, 이 목록에서 골라 붙입니다.


CLAUDE.md — Vault의 헌법

이 Obsidian 기록의 1차 관리자는 Claude Code로 정했기 때문에 이 파일은 가장 중요한 파일입니다.

Vault 루트에 CLAUDE.md를 두면, Claude Code가 이 폴더에서 작업할 때 항상 이 파일을 먼저 읽습니다.

내용은 크게 다섯 가지입니다.

1. Vault 개요 — 무슨 목적의 Vault인지

2. 폴더 구조 — 위에 정의한 구조 그대로

3. 노트 작성 규칙 — frontmatter 형식, 파일명 규칙, 태그 체계

4. 행동 지침 — 에이전트가 작업할 때 지켜야 할 규칙들

## Claude Code 행동 지침

- 노트 **삭제는 절대 금지**. 정리가 필요하면 `9999_Archive/`로 이동.
- 기존 frontmatter 형식을 **반드시 유지**하고, 없으면 추가.
- 파일 수정 전 **현재 내용 확인 후** 작업 진행.
- 한국어로 노트 작성. 태그, 파일명은 영문 혼용 가능.

5. OpenClaw 연동 규칙 — Telegram으로 흑마가 접근할 때의 행동 기준

## OpenClaw 연동 규칙

- **아이디어 캡처**: Telegram 메시지 → `0000_Inbox/0010_RawIdea/`에 즉시 노트 생성
- **AI 회의 결과**: 에이전트 간 논의 결과 → `0000_Inbox/0020_AIAgents/`에 저장
- **AI Daily Note**: 세션 정리 시 자동 생성 (`0100_Daily/0120_AIDaily/`)
- **접근 제한**: `0210_LGEnsol/` 폴더 읽기/쓰기 모두 금지

마지막 줄이 중요합니다. 회사 업무 관련 폴더는 외부 AI API로 내용이 전송되면 안 되거든요. CLAUDE.md에 명시해 두면 Claude Code도, OpenClaw도 이 규칙을 따릅니다.


템플릿 파일 만들기

0500_Templates/ 폴더에는 자주 쓰는 노트 형식을 미리 만들어 뒀어요.

Daily Note 템플릿:

---
title: {{date}}
date: {{date}}
tags: [daily]
type: daily
status: active
---

## 오늘의 포커스
- 

## 작업 로그
- [ ] 

## 아이디어 / 인사이트
- 

## 내일 준비
- 

아이디어 노트 템플릿:

---
title: 
date: {{date}}
tags: [idea]
type: idea
status: inbox
related: []
---

## 핵심 아이디어
> 한 문장으로 요약

## 원문 / 맥락

## 연결되는 노트
- [[]]

## 다음 액션
- [ ] 

AI 회의 결과 템플릿:

---
title: AI회의 — {{date}}
date: {{date}}
tags: [idea, openclaw, ai]
type: idea
status: inbox
---

## 회의 주제

## 참여 에이전트
- 잔마왕
- 흑마 (OpenClaw)

## 논의 내용

## 주요 결론

## 다음 액션
- [ ] 

이 외에도 YouTube 에피소드, 독서 노트, 참고자료, 강의 기획, Evergreen 노트 템플릿을 만들어 뒀어요.

그리고 0500_Templates/_index.md라는 파일을 하나 더 만들어서, 어떤 템플릿이 있는지 한눈에 볼 수 있게 정리했습니다.

| 파일명 | 용도 | 저장 위치 |
|--------|------|-----------|
| daily-template.md | 나의 Daily Note | 0100_Daily/0110_MyDaily/ |
| ai-daily-template.md | AI 작업 일지 | 0100_Daily/0120_AIDaily/ |
| idea-template.md | 아이디어 캡처 | 0000_Inbox/0010_RawIdea/ |
| ai-meeting-template.md | AI 회의 결과 | 0000_Inbox/0020_AIAgents/ |
...

채널별 _about.md 파일

0220_TOffice/0240_SSong/ 폴더 안에는 _about.md 파일을 넣어뒀습니다.

AI 에이전트 입장에서 "이 폴더가 어떤 채널이고, 어떤 목적으로 쓰이는지"를 알아야 콘텐츠를 제대로 분류하고 기획할 수 있거든요.

업무의 잔머리 _about.md에는 채널 URL, 콘셉트, 주요 콘텐츠 카테고리, 채널 철학을 담았고, SSongDevil _about.md에는 BPM 체계(140/160/180), 4단계 제작 워크플로우, 확장 예정 활동 카테고리를 정리했습니다.

에이전트가 "SSongDevil 에피소드 기획해줘"라는 지시를 받으면, _about.md를 먼저 읽고 어떤 채널인지 파악한 다음 기획을 시작합니다.


실제로 쓰는 명령어들

Claude Code를 Vault 폴더에서 열고 이렇게 씁니다:

"0000_Inbox 폴더 노트들을 분석해서 적절한 폴더로 분류해줘"

"오늘 날짜로 My Daily Note 만들어줘"

"아래 텍스트를 YouTube 에피소드 노트로 변환해줘: ..."

"0300_Notes/0310_AI 폴더 노트들의 링크 관계를 정리해줘"

"[[특정노트]] 아이디어를 바탕으로 연관 아이디어 3개 제안해줘"

CLAUDE.md에 폴더 구조와 규칙이 잘 정의되어 있으면, 이런 자연어 지시만으로도 에이전트가 알아서 올바른 경로에 파일을 만들고, 올바른 형식으로 내용을 채웁니다.


설계 과정에서 배운 것

처음엔 그냥 폴더 만들고 노트 쓰면 되겠지 싶었는데, AI 에이전트와 함께 쓰려면 구조가 훨씬 중요하다는 생각이 들었습니다.

사실 이 부분에 있어서는 GPTers에 구요한님이라는 워낙 앞서가신 선구자님이 계셔서 그 구조를 보고 배우기만 해도 많은 부분을 빠르게 따라 갈 수도 있었지만요.

실제 이 설계를 함에 있어서도 핵심 아이디어와 중요 골격은 CMDS에서 많은 것을 배워서 따라가고 있다. 라고 볼 수 있을것 같고 어디까지나 제가 이해한 범위 내에서 흉내내면서 따라갔기에 하위 호환 버전이라고 할 수도 있으리라 생각됩니다.

하지만, 그래도 여기까지는 제가 이해한 범위로 따라온 지식 관리체계이기에 여기서 조금씩 더 쌓아나가고 따라간다면 저 또한 어깨를 나란히 할 수 있는 날이 오리라 기대를 해 봅니다.


내 지식 보관소의 현황은

우선 틀은 어느정도 만들어 졌는데, 이 내용을 실제 채우는 것이 가장 크고 중요한 숙제라고 생각됩니다.

그나마, 지금 채워 넣을 것은 꽤 많이 있기에 우선은 그 정보들 부터 채워 넣어 봤습니다.

그 내용들 또한 나름 분량이 제법 되었기에 나름 잔머리를 많이 쓰면서 채워 넣었습니다.

  1. 그동안 Notion에 기록해 왔던 독서 기록을 추가해 봤습니다.

한국어 텍스트가 포함된 페이지의 스크린샷

흑마에게 시켜서 Notion의 독서기록 DB 정보를 csv 파일로 다운로드 받고, Claude Code에서 이 csv 파일로 Obsidian 메모를 추가하는 코드를 만들어 달라고 한 다음 일괄 업로드 했습니다.

※ 이걸 하나하나 AI Agent가 다 하게 했다가는 토큰이 남아나지 않을것 같았습니다.

  1. 그동안 Notion에 기록해 왔던 업무의 잔머리 채널 영상들의 정보를 추가했습니다.

독서 기록 DB 정리와 같은 방법으로 진행했습니다. 흑마에게 시켜서 Notion의 DB 정보를 csv 파일로 다운로드 받고, Claude Code에서 이 csv 파일로 Obsidian 메모를 추가하는 코드를 만들어 달라고 한 다음 일괄 업로드 했습니다.

  1. SSongDevil 채널에 올렸던 노래 정보들을 업로드 했습니다.

이 부분은 노래를 만들때 각각의 노래에 대한 Text 파일을 만들어 뒀었기에, Claude Code를 통해 업로드 작업을 시켰습니다.

아직 노래 파일이 12개로 작은편인데다가 영상 리스트나 독서 리스트 처럼 DB 형태로 정리된 자료는 아니었기에 여기는 AI 서비스의 힘을 이용했습니다.

그리고, 지금 만들어진 저의 귀여운 Galaxy는...

흑백의 원 그리기

아직 많이 작고, 귀엽고, 연결도 약하고 (연결해야 할 곳이 천지...) 기형적인 모습으로 태어나서 Galaxy라고 부르기엔 매우 부끄럽지만, 그래도 탄생 했습니다.

하지만 이제 시작이니.. 앞으로 잘 발전시켜 나가야겠죠.


앞으로는

앞으로도 많은 부분에서 이 기억 보관소를 적극 활용할 생각입니다.

일단, 1일 2메모(AI 기록 1개, 나의 기록 1개)는 최소 기록으로 남길 생각입니다.

책에 대한 내용도 Open Claw를 통해 정제해서 올리고, 그외의 여러 아이디어들도 이곳을 활용해 적극적으로 올리고 앞으로의 많은 인사이트를 얻는데 활용하는 진정한 세컨드 브레인으로 활용하기를 기대해 봅니다.


업무의 잔머리: https://www.youtube.com/@tricksoffice

SSongDevil: https://www.youtube.com/@ssongdevil

이 글에서 다룬 도구: Obsidian · Claude Code · OpenClaw · WSL2

4
1개의 답글

뉴스레터 무료 구독