Search
Duplicate

[My Agent]6. Hermes와 Obsidian 연계하기

목차(클릭하세요)
Hermes Agent가 Obsidian vault를 파일시스템 레이어로 직접 읽고 쓰는 구조. 대화 기록·스킬·메모리가 마크다운으로 쌓이면서 시간이 지날수록 더 강력해지는 지식 시스템을 만듦 수정&생성해야 할 파일2가지 1. AGENTS.md : ~~AppData\Local\hermes 폴더에 생성 2. obsidian 스킬 생성: ~\AppData\Local\hermes\skills에 폴더째로 넣기
[참고자료]

1. 왜 Hermes와 Obsidian을 연계하는가?

1-1. 연계의 목적

Obsidian을 단순한 노트 폴더가 아니라 AI 에이전트의 메모리 시스템으로 활용함
일반적인 AI 사용 방식의 한계:
일반 AI 채팅 └── 대화가 끝나면 모든 맥락 사라짐 → 매번 처음부터 설명해야 함 → 쌓이는 지식 없음
Plain Text
복사
Hermes + Obsidian 연계 방식:
Hermes Agent └── Obsidian vault를 파일시스템으로 직접 접근 ├── 대화 요약 → Daily Notes에 자동 저장 ├── 반복 작업 → Skills로 자동 생성 ├── 중요 사실 → 메모리로 누적 └── 프로젝트 컨텍스트 → 마크다운으로 보관
Plain Text
복사
쓸수록 더 강해지는 복리형 자동화 시스템
vault란?
Obsidian이 관리하는 폴더의 한 종류, 정확히는 Obsidian의 홈 폴더
일반 폴더: └── 그냥 파일들이 모여있는 곳 Obsidian Vault: └── 폴더인데 Obsidian이 "이 폴더를 내 노트 공간으로 쓸게" 라고 선언한 것 → 폴더 안에 .obsidian/ 숨김 폴더 생성 → 백링크, 그래프, 플러그인 등 모든 기능이 이 폴더 기준으로 작동
YAML
복사

1-2. Hermes가 Obsidian과 연동하는 방식

Hermes는 Obsidian을 파일시스템 기반 노트 레이어로 활용함. 별도 플러그인 설치 없이 vault 폴더를 직접 읽고 쓰는 방식:
역할
위치
설명
Vault 노트
Obsidian 폴더
사람이 읽는 프로젝트 컨텍스트·연구 자료
Durable 메모리
Hermes 내부
안정적인 사용자/프로젝트 사실
Skills
Hermes 내부
반복 절차 자동화
Sessions
Hermes 내부
임시 대화 기록 (요약 시 vault로 이동)
4가지를 명확히 분리해야 vault가 지저분해지지 않음

2. Hermes와 Obsidian 연결의 실제

2-1. Vault 경로 설정

예시 위치
옵시디언 폴다//내가 설정한 보관함
Plain Text
복사
Hermes가 접근할 스코프 폴더 생성 (vault 전체 노출 방지)
all_phago/ └── Hermes/ ← Hermes 전용 폴더 (신규 생성) ├── Daily/ ← 날짜별 대화 요약 ├── Memory/ ← 메모리 검토용 └── Skills/ ← 생성된 스킬 목록
Plain Text
복사
vault 전체가 아닌 /Hermes 폴더만 스코프로 지정하는 것이 안전함

2-2. Hermes 설정 파일 수정

1.
메모리 활성화 여부 확인:hermes\config.yaml 열어서
# 메모리 활성화 (이미 설정됨 확인) memory: memory_enabled: true user_profile_enabled: true
YAML
복사
2.
terminal 부분추가 :hermes\config.yaml 열어서
terminal: backend: local cwd: 옵시디언의 베이스 폴더 경로적기
YAML
복사
주의: 경로를 적을때 따옴표 포함하여 적는 것을 권장
경로에 공백이 있을 경우 에러발생
# Obsidian vault 경로 설정 terminal: cwd: "Z:\\5.obsidian\\all_phago"
YAML
복사
3.
슬랙에서 vault 경로 알려주고 작업물 결과 저장요청하기
@hermes-bot 내 Obsidian vault 경로는 Z:\5.obsidian\all_phago 야. Hermes 폴더 안에 작업 결과를 저장해줘.
Plain Text
복사
실제 작동결과

2-3. 저장위치&경로를 고정하고 싶을때

해결 방법: AGENTS.md

Hermes는 시작할 때 자동으로 이 파일을 읽기때문
작업 중인 옵시디언 폴더안에 AGENTS.md 를 생성하고 다음 내용 넣기
## 절대 규칙: 파일 저장 위치 ### 기본 저장 경로 (반드시 준수) 모든 파일은 OOOOOOO 하위에만 저장. OOOOOOO 직접 저장 절대 금지. ### 하위 폴더 규칙 - 날짜별 기록 →OOOOOOO\all_phago\Hermes\Daily\ - 창작물 → OOOOOOO\all_phago\Hermes\Creative\ - 기술 문서 → OOOOOOO\all_phago\Hermes\Docs\ - 메모리 → OOOOOOO\all_phago\Hermes\Memory\ - 스킬 → OOOOOOO\all_phago\Hermes\Skills\ ### 절대 금지 - OOOOOOO 루트에 직접 저장 금지 - C:\Users\ 경로 저장 금지 - Hermes 설치 폴더 저장 금지 ### 파일 형식 - 반드시 .md (마크다운) - 저장 후 read-after-write 확인 필수
YAML
복사
실제로 ‘Hermes’폴더안의 하위폴더에 잘 저장되는지 확인하기
저장경로에서 에러가 계속 발생할 경우 직접 지침을 알려줄수도 있음

3. 기존 Vault 구조와 연결 및 자동화

3-1. 00_Raw 폴더 연동

기존 00_Raw/ 폴더 활용 하여 Hermes와의 대화내용을 저장하기
전기차 배터리에 대한 내용을 3단락으로 정리 후 마크다운으로 Z:\5.obsidian\all_phago\00_Raw\2026-05-24 폴더에 저장해
Plain Text
복사

3-2. MOC변경-> Home.md 변경 자동화

Hermes가 파일을 생성할 때마다, MOC변경-> Home.md 변경이 유기적으로 자동화되어야 함!
해결 방법: AGENTS.md에 규칙 추가
[1단계] Hermes에게 MOC 파일 구조인식시키기
조금 복잡한 작업일때는 gemma4:e2b 모델보다는 보다 고급모델을 사용권장
@hermes-bot OOOOOOO\MOC\ 폴더 파일 목록 알려줘
YAML
복사
[2단계] AGENTS.md 수정
AGENTS.md에 MOC 자동화 규칙 추가하기
## 파일 생성 후 자동화 규칙 ### 새 파일 생성 시 반드시 수행할 것: 1. 해당 파일의 카테고리 파악 - Daily/ → 날짜 기록 - Docs/ → 기술 문서 - Creative/ → 창작물 - Skills/ → 스킬 2. 관련 MOC 파일 업데이트 - AI 코딩·에이전트 관련 → OOOOOOO\MOC\AI 코딩 도구 MOC.md 에 링크 추가 - 스킬·MCP 관련 → OOOOOOO\MOC\Mcp&skills MOC.md 에 링크 추가 - 옵시디언 관련 → OOOOOOO\MOC\옵시디언 지식관리 MOC.md 에 링크 추가 - 이미지 생성 관련 → OOOOOOO\MOC\AI 이미지 생성 MOC.md 에 링크 추가 - 테슬라 관련 → OOOOOOO\MOC\테슬라 MOC.md 에 링크 추가 3. HOME.md 업데이트 - Z:\5.obsidian\all_phago\HOME.md 의 관련 섹션에 링크 추가 4. 모든 수정 후 read-after-write 확인
YAML
복사
예시작업
@hermes-bot 전기차로 3행시 지어서 Hermes/Creative 폴더에 저장한뒤 MOC자동화, HOME.md 업데이트진행해
YAML
복사
[3단계] obsidian 스킬 생성
# Obsidian 양파고 지식 관리 스킬 v3.1 ## — P-Reinforce × 양파고 통합 에디션 --- ## 🎯 목적 파편화된 원시 정보를 **자율 지식 정원(Autonomous Knowledge Garden)** 으로 변환함. - **P-Reinforce 엔진:** RL 기반 자동 분류·폴더 설계 - **양파고 엔진:** 인라인 위키링크 의무화·MOC 계층·역방향 기대 ## When to Use 아래 키워드 중 하나라도 포함되면 자동 적용: - 한국어: 옵시디언, 지식연결, 지식 연결, 지식 체계화, 노트 저장, 백링크, MOC, 위키링크 - 영어: obsidian, vault, knowledge graph, backlink, second brain, PKM --- ## 📂 Vault 구조 ``` Z:\5.obsidian\all_phago\ ├── HOME.md ← 전체 지식 진입점 ├── 00_Raw/YYYY-MM-DD/ ← 원본 보존 (절대 수정 금지) ├── 10_Wiki/ │ ├── Projects/ │ ├── Topics/ │ ├── Decisions/ │ └── Skills/ ├── 20_Meta/ │ ├── Graph.json │ ├── Policy.md │ └── Index.md ├── MOC/ │ ├── AI 코딩 도구 MOC.md │ ├── AI 이미지 생성 MOC.md │ ├── Mcp&skills MOC.md │ ├── 옵시디언 지식관리 MOC.md │ ├── 테슬라 MOC.md │ └── 외부특강_청취목록_MOC.md ├── Hermes/ ← Hermes 전용 폴더 │ ├── Daily/ ← 날짜별 작업 요약 │ ├── Docs/ ← 기술 문서 │ ├── Creative/ ← 창작물 │ ├── Memory/ ← 메모리 검토용 │ └── Skills/ ← 생성된 스킬 목록 └── assets/ ``` --- ## 📏 파일 저장 규칙 ### 기본 저장 경로 - Hermes 작업 결과: `Z:\5.obsidian\all_phago\Hermes\` 하위에만 저장 - 지식화된 노트: `Z:\5.obsidian\all_phago\10_Wiki\` 적절한 하위 폴더 - 원본 보존: `Z:\5.obsidian\all_phago\00_Raw\YYYY-MM-DD\` ### 하위 폴더 규칙 - 날짜별 기록 → `Hermes\Daily\` - 창작물 → `Hermes\Creative\` - 기술 문서 → `Hermes\Docs\` - 메모리 → `Hermes\Memory\` - 스킬 → `Hermes\Skills\` ### 절대 금지 - `Z:\5.obsidian\all_phago\` 루트에 직접 저장 금지 - `C:\Users\` 경로 저장 금지 - Hermes 설치 폴더 저장 금지 --- ## 📐 노트 출력 템플릿 ```markdown --- id: {{UUID}} tags: [태그1, 태그2] aliases: [별칭1] created: YYYY-MM-DD last_reinforced: YYYY-MM-DD confidence_score: 0.0 category: "[[10_Wiki/Topics/카테고리명]]" links: # 상위 - "[[MOC명]]" # 같은레벨 - "[[비슷한-노트]]" # 하위 - "[[세부-개념]]" raw_source: "[[00_Raw/YYYY-MM-DD/원본파일명]]" --- # {노트 제목} > 한 줄 통찰: (15단어 이내) ## 📌 Brief Summary (1~2문장. **핵심 개념은 모두 [[위키링크]]로 처리**) ## 🗺️ 이 노트의 위치 - 상위 개념: [[MOC명]] · [[상위개념]] - 같은 레벨: [[비슷한-노트-A]] · [[비슷한-노트-B]] - 하위 개념: [[세부-개념-A]] (있을 경우만) --- ## 📖 Core Content (본문 전체에서 개념 첫 등장마다 [[위키링크]] 삽입) --- ## 🔗 Knowledge Connections ### 직접 연결 - [[개념-A]] — 연결 이유 ### 역방향 기대 - [[노트명-A]]: 연결해야 하는 이유 *Last reinforced: YYYY-MM-DD* ``` --- ## 📋 파일 생성 후 자동화 규칙 새 파일 생성 시 반드시 수행: 1. 카테고리 파악 (Daily/Docs/Creative/Skills/10_Wiki) 2. 관련 MOC 업데이트: - AI 코딩·에이전트 관련 → `Z:\5.obsidian\all_phago\MOC\AI 코딩 도구 MOC.md` - 스킬·MCP 관련 → `Z:\5.obsidian\all_phago\MOC\Mcp&skills MOC.md` - 옵시디언 관련 → `Z:\5.obsidian\all_phago\MOC\옵시디언 지식관리 MOC.md` - 이미지 생성 관련 → `Z:\5.obsidian\all_phago\MOC\AI 이미지 생성 MOC.md` - 테슬라 관련 → `Z:\5.obsidian\all_phago\MOC\테슬라 MOC.md` 3. HOME.md 업데이트: `Z:\5.obsidian\all_phago\HOME.md` 관련 섹션에 링크 추가 4. 저장 후 read-after-write 확인 필수 --- ## ✅ 품질 체크리스트 - [ ] `00_Raw/` 원본 보존 경로 명시 - [ ] Frontmatter 전체 속성 포함 - [ ] `links` flat 리스트 구조 (중첩 키 금지) - [ ] 한 줄 통찰 15단어 이내 - [ ] 인라인 위키링크 5개 이상 - [ ] `이 노트의 위치` 섹션 존재 - [ ] `역방향 기대` 섹션 존재 - [ ] 관련 MOC 업데이트 - [ ] HOME.md 업데이트 --- ## ⚠️ 주의사항 1. `00_Raw/` 원본 절대 수정·삭제 금지 2. `links` 중첩 키 사용 금지 (옵시디언 JSON 오파싱 버그) 3. 구분자 `·` 만 사용 (`,` 혼용 금지) 4. 상위 개념 없는 노트 출력 금지 → MOC 먼저 생성
YAML
복사
[4단계]Hermes skills 폴더에 obsidian 스킬 등록
정확히는 ‘C:\Users\ysj\AppData\Local\hermes\skills\스킬폴더명’에 해당 skill.md파일 저장
[5단계] Hermes에게 MOC 파일들 읽게 하기
슬랙에서 스킬 관련 명령어 확인후, 사용가능한지 확인
@hermes-bot 현재 로드된 스킬 목록 알려줘
YAML
복사
@hermes-bot obsidian-yangphago 스킬 사용가능하니?
YAML
복사
[6단계] Hermes가 MOC 자동 업데이트 및 HOME.md 업데이트
아래과 같이 보다 명확한 요청이 필요
[나쁜 예시]
[좋은 예시]
옵시디언 스킬 사용해서 전기차_3행시.md관련 MOC 파일과 home.md 업데이트
YAML
복사
@hermes-bot obsidian-yangphago 스킬 사용해서 Hermes/Creative/전기차_3행시.md 파일을 생성하고 테슬라 MOC와 HOME.md도 함께 업데이트해줘
YAML
복사
[7단계] 최종 결과