🪽 Hermes 06. Telegram → GBrain → Obsidian 실구현 체크리스트

설계가 좋아 보여도 실제로 안 굴러가면 의미가 없다. Telegram, Hermes, GBrain, Obsidian은 각각 역할이 다르기 때문에, 구현도 한 번에 다 붙이지 말고 작게 붙이고 바로 검증하는 순서가 중요하다. 특히 현재 작업 환경에는 이미 GBrain 로컬 PoC가 있기 때문에, 새 시스템을 처음부터 만드는 것보다 기존 PoC를 실사용 루프로 연결하는 체크리스트가 더 실용적이다.

이 문서는 이론 설명보다 실행 순서에 집중한다. 지금 환경에서 무엇이 이미 준비돼 있고, 무엇을 먼저 확인하고, 어디서부터 자동화를 붙여야 하는지를 단계별로 정리한다.

안내: 이 글은 Hermes 공식 문서, GBrain 공식 README/설치 문서, 그리고 현재 작업 환경의 GBrain 로컬 PoC 메모를 바탕으로 정리했고, 구조화와 문장 정리에 생성형 AI를 보조적으로 활용했습니다.

현재 환경 기준으로 이미 있는 것

먼저 출발점을 명확히 잡는 게 중요하다. 지금 환경에는 GBrain 로컬 PoC가 이미 있다.

현재 GBrain 관련 경로

• tool repo: /home/tw2/.openclaw/workspace/integrations/gbrain-tool
• brain repo: /home/tw2/.openclaw/workspace/integrations/gbrain-brain
• db path: /home/tw2/.openclaw/workspace/integrations/gbrain-brain/.gbrain-db/brain.pglite
• CLI wrapper: /home/tw2/.local/bin/gbrain
• safe wrapper: /home/tw2/.openclaw/workspace/integrations/gbrain-tool/gbrain-local.sh
• refresh script: /home/tw2/.openclaw/workspace/integrations/gbrain-brain/refresh-poc.sh

현재 Obsidian 볼트 경로

• 메인 볼트: /home/tw2/Documents/n8n/data/shared/syn/
• Clipping: 0.Inbox/Clipping
• 리소스: 3.Resources/Flux
• Quartz 배포용: 8.quartz/

즉, 지금 필요한 건 “설치”보다 연결 규칙과 승격 규칙이다.

구현 목표를 너무 크게 잡지 않는다

이번 체크리스트의 목표는 아래 세 가지면 충분하다.

1. Telegram에서 입력이 들어온다
2. Hermes가 그 입력 중 일부를 GBrain에 남긴다
3. GBrain에 쌓인 것 중 일부만 Obsidian으로 승격한다

이 세 가지가 먼저 굴러가면, 그다음에야 음성, 이메일, 캘린더, 사람 엔티티 강화 같은 고급 흐름을 붙일 수 있다.

flowchart LR
A[Telegram 입력] --> B[Hermes 판단]
B -->|짧은 답변| C[채팅에서 종료]
B -->|기억 가치 있음| D[GBrain 저장]
D --> E[주간 검토]
E -->|승격 가치 있음| F[Obsidian 정리]

1단계, Telegram 입력 기준부터 고정한다

가장 먼저 해야 할 일은 무엇을 Telegram으로 받는지 규칙을 고정하는 것이다. Telegram을 만능 작업장으로 쓰면 금방 무거워진다.

이번 단계에서 Telegram에 허용할 입력

• 링크
• 짧은 아이디어
• 음성 메모
• 후속 조사가 필요한 질문
• 사람/회사/프로젝트 관련 짧은 맥락

이번 단계에서 Telegram으로 받지 않을 것

• 긴 보고서 완성본
• 대규모 문서 편집 지시
• 구조가 복잡한 문서 초안 전체

Hermes Telegram 문서가 말하듯, Telegram은 입력과 결과 수신에 강하다. 하지만 정제 문서 작업까지 여기서 끝내려 하면 효율이 떨어진다.

• Telegram Setup: https://hermes-agent.nousresearch.com/docs/user-guide/messaging/telegram

체크

• DM에서 봇 호출이 안정적이다
• /sethome이 설정돼 있다
• 나만 쓰는 allowlist가 걸려 있다
• 링크와 짧은 메모를 보내는 습관이 부담스럽지 않다

2단계, Hermes의 저장 기준을 먼저 작게 자른다

다음은 Hermes가 “무엇을 저장할지”를 좁게 시작하는 단계다. 처음부터 모든 메시지를 기억으로 승격하면 나중에 정리가 더 어려워진다.

초기 저장 기준

아래 네 가지에만 반응하도록 생각하면 좋다.

1. URL이 있는 메시지
2. “기억해”, “정리해”, “나중에 보자” 같은 저장 의도가 분명한 메시지
3. 사람/회사/프로젝트 이름이 반복 등장하는 짧은 메모
4. 음성 메모를 텍스트로 바꾼 뒤 핵심이 분명한 입력

저장 제외 기준

• 단순 안부
• 바로 끝나는 짧은 질답
• 일회성 장난 메시지
• 이미 다른 문서에 정리된 내용을 반복 확인하는 경우

미니 사례

“이 링크 gbrain 구조 참고”처럼 URL이 포함된 메시지는 저장 후보로 잡기 쉽다. 반대로 “오케이” 같은 메시지는 기억 계층으로 올릴 이유가 없다.

체크

• URL 포함 메시지는 계속 수집된다
• 저장 의도 문구를 우선 인식한다
• 일회성 대화는 채팅 세션에서 끝낸다
• 저장 기준이 너무 넓어지지 않았다

3단계, GBrain은 새로 만들지 말고 기존 PoC를 먼저 살린다

지금 환경은 이미 GBrain 로컬 PoC가 있다. 따라서 새 repo를 만들기보다, 현재 repo가 실제로 조회 가능한지부터 점검하는 게 맞다.

GBrain 설치 문서도 gbrain init, gbrain doctor, gbrain import, gbrain embed --stale 순으로 검증하라고 안내한다.

• INSTALL_FOR_AGENTS.md: https://raw.githubusercontent.com/garrytan/gbrain/master/INSTALL_FOR_AGENTS.md

이번 환경에서 먼저 확인할 것

• wrapper 경로인 /home/tw2/.local/bin/gbrain이 정상 동작하는가
• brain repo가 /home/tw2/.openclaw/workspace/integrations/gbrain-brain로 유지되는가
• PGLite DB가 살아 있는가
• import 범위가 지금 필요한 폴더와 맞는가

현재 import 범위

• 0.Inbox/Clipping
• 3.Resources/Flux
• PARA mirror 일부
• 8.quartz/{Flux,Trend,Tip,Troubleshooting}

이 범위는 이미 나쁘지 않다. 오히려 지금은 더 넓히기보다, Telegram 입력이 이 범위 어디로 들어갈지를 정하는 편이 중요하다.

체크

• gbrain wrapper가 정상 실행된다
• gbrain doctor 수준의 기본 점검이 통과한다
• brain repo 경로와 DB 경로가 명확하다
• import 범위를 지금 당장 더 넓히지 않는다

4단계, Telegram 입력의 첫 도착지는 GBrain 전용 임시 계층으로 둔다

여기서 바로 중요한 결정이 나온다. Telegram에서 들어온 메모를 곧바로 3.Resources나 8.quartz에 쓰지 않는 편이 좋다. 처음엔 임시 축적층으로 두는 게 낫다.

현재 환경 기준으로는 두 가지 선택지가 있다.

선택지 A, 기존 Clipping 성격으로 넣기

링크/짧은 노트 중심이면 0.Inbox/Clipping 성격으로 먼저 흘리는 방식이다.

선택지 B, GBrain repo 안에 별도 inbox 성격 만들기

Telegram 전용 brain inbox를 두고, 나중에 승격 기준에 따라 Obsidian으로 넘기는 방식이다.

내 추천은 B다. 이유는 명확하다. GBrain은 에이전트가 먼저 보는 기억 계층이므로, Telegram 입력을 사람용 폴더와 섞지 않는 편이 나중에 훨씬 깔끔하다.

추천 규칙

• Telegram 원문/요약 = GBrain 쪽 inbox
• 사람이 다시 읽을 정리본 = Obsidian 쪽 문서

체크

• Telegram 입력의 첫 저장 위치가 정해졌다
• 사람용 노트와 기계용 기억이 섞이지 않는다
• 링크와 메모의 임시 축적층이 따로 있다

5단계, Obsidian 승격 기준을 미리 정한다

많이 놓치는 부분인데, “언제 Obsidian으로 올릴지” 기준이 없으면 GBrain에만 쌓이거나, 반대로 너무 빨리 승격돼 문서가 비대해진다.

초반엔 아래 셋 중 하나면 승격하는 편이 좋다.

승격 조건

1. 같은 주제로 메모가 3개 이상 쌓였다
2. 나중에 다시 읽을 가능성이 높다
3. 발행/공유/실행 문서로 바꿀 가치가 있다

Obsidian에 승격할 대표 유형

• 시리즈 문서 초안
• 리서치 정리본
• 업무 체크리스트
• 사람 손으로 다듬을 매뉴얼

미니 사례

Telegram에서 “Hermes와 GBrain 분리 운영” 관련 메모가 계속 쌓이면, 그때 비로소 Obsidian의 시리즈 문서 한 편으로 승격한다. 메모가 1개일 때부터 문서를 만들면 오히려 유지 비용이 커진다.

체크

• 승격 조건 2~3개가 명확하다
• 메모가 1개일 땐 바로 문서화하지 않는다
• Obsidian에는 승격된 결과물만 남긴다

6단계, 주간 리뷰 루프를 만든다

이 구조는 자동 수집만으로 완성되지 않는다. GBrain과 Obsidian 사이에는 사람이 한 번 개입하는 주간 리뷰가 있어야 한다.

추천 주간 루프

1. 이번 주 Telegram 입력 중 기억으로 남은 것 확인
2. GBrain에서 반복 등장 주제 검색
3. 승격 가치 있는 것만 Obsidian 문서 후보로 선택
4. Quartz나 Resources 쪽 문서로 정리

이 루프가 있어야 GBrain은 기억 창고로 남고, Obsidian은 읽을 만한 문서로 유지된다.

체크

• 주 1회 검토 시간을 잡았다
• GBrain에서 먼저 검색해 본다
• 승격할 문서만 Obsidian으로 이동한다
• 승격되지 않은 메모는 굳이 억지 정리하지 않는다

7단계, 실제 환경 기준 1차 구현 순서

지금 환경에서 가장 현실적인 구현 순서는 아래다.

Phase 1, 입력 안정화

• Hermes Telegram DM 사용 안정화
• 링크, 아이디어, 음성 메모만 우선 입력
• 홈 채널과 allowlist 유지

Phase 2, GBrain 생존 확인

• /home/tw2/.local/bin/gbrain 경로 기준 실행 확인
• brain repo, db path, refresh script 확인
• 기존 import 범위 유지

Phase 3, Telegram → GBrain 저장 규칙 확정

• URL 포함 메시지 저장
• 저장 의도 메시지 저장
• 사람/회사/프로젝트 맥락 저장
• 단순 질답 제외

Phase 4, 주간 승격 루프 실행

• GBrain에서 주제 재검색
• Obsidian 후보 선정
• 3.Resources/Flux 또는 8.quartz로 승격

Phase 5, 그다음 확장

• Obsidian 연동 세분화
• Gboard 루틴 붙이기
• 음성/미팅/이메일 ingestion 확장

8단계, 당장 하지 않는 것이 더 중요한 것들

초기 실패는 대부분 “할 수 있는 걸 전부 붙였기 때문”에 생긴다.

지금 당장 안 하는 편이 좋은 것

• Telegram 전체 로그 자동 동기화
• Obsidian 전체 재임포트 자동화
• 모든 메시지 강제 저장
• 회의/이메일/캘린더를 동시에 붙이기
• GBrain graph/timeline 고도화부터 집착하기

GBrain README는 기능이 매우 많다. 하지만 지금 단계에서는 기능 수보다 운영 경로 하나를 매끈하게 만드는 것이 더 중요하다.

• GBrain README: https://github.com/garrytan/gbrain

9단계, 성공 여부를 어떻게 판단할까

아래 세 질문에 예라고 답할 수 있으면 1차 구현은 성공이다.

1. Telegram에 메모를 남기는 일이 더 가벼워졌나
2. 며칠 뒤 같은 주제를 다시 찾을 때 GBrain이 실제로 도움이 되나
3. Obsidian 문서가 이전보다 덜 어지럽고 더 읽기 쉬운가

이 셋이 맞으면 구조는 맞게 가고 있는 것이다. 반대로 하나라도 계속 나빠지면 저장 기준이 너무 넓거나, 승격 타이밍이 너무 빠른 경우가 많다.

내 추천 시작 조합

현재 환경에선 이 조합이 가장 무난하다.

• Telegram = 모바일 입력 전용
• Hermes = 분기와 응답 전용
• GBrain = Telegram 입력의 장기 기억 계층
• Obsidian = 승격 문서와 발행 문서 계층
• 리뷰 주기 = 주 1회

이 조합은 화려하지 않지만, 실제로 오래 간다. 입력은 가볍고, 기억은 누적되고, 문서는 정리된 채로 남기 쉽다.

다음 읽기

• Hermes 04. 텔레그램 연결과 게이트웨이 운영
• Hermes 05. Telegram → GBrain → Obsidian 루프 설계안
• Hermes 시리즈 인덱스
• Hermes 03. 모델 선택과 기본 설정