토픽 관리
토픽(사건방)을 만들고 지우고 목록을 보는 운영 명령은 모두 봇과의 1:1 DM 채팅에서 처리합니다. DM에서 사용 가능한 슬래시 명령은 다음 6가지이며, 같은 일을 자연어로 부탁해도 동일하게 동작합니다.
토픽 커스터마이징
토픽마다 사용 모델·추론 깊이·검토자(advisor)·활성화할 MCP 도구를 따로 지정할 수 있습니다. 모두 DM에서 자연어로 부탁하면 됩니다 — 봇이 토픽 매니저를 호출해 설정을 갱신하고, 다음 메시지부터 적용됩니다.
메모리
사용할수록 똑똑해지는 LLM 기반 위키 메모리 시스템입니다. 사무실 PC의 wiki/ 폴더 안에 사람이 직접 읽고 수정할 수 있는 마크다운 파일들로 누적됩니다 — 별도의 데이터베이스가 아니라서 봇이 잘못 기억한 부분이 있으면 직접 .md 파일을 열어 고치면 그대로 반영됩니다.
wiki/index.md전체 인덱스 — 모든 articles의 한 줄 요약# Wiki Index Last updated: 2026-04-25 ## clawgram 개발 - [[outbox-pattern]] -- 비동기 메시지 처리 패턴 (2026-04-09) - [[session-comm]] -- A2A 통신 MCP 서버, 9개 도구 (2026-04-25) - [[memory-system]] -- 메모리 주입 시스템 진화 (2026-04-25) ## 사업 / 커리어 - [[clawgram-pricing]] -- 프라이싱 전략 + OSS 하이브리드 (2026-04-19)
wiki/articles/시간을 가로지르는 지식·결정 — LLM 보조로 사람이 큐레이션--- date: 2026-04-25 type: concept topic: dev status: active --- # clawgram-forum-commands Clawgram 포럼 토픽 슬래시 명령 목록. | 명령어 | 기능 | 구현 파일 | |--------|------|-----------| | /fork [name] | 세션 히스토리 복사 + 새 토픽 | forum.ts | | /spawn [name] | 빈 세션으로 새 토픽 | forum.ts | | /new | 현재 토픽 유지 + 세션 리셋 | forum.ts |
wiki/summaries/세션 단위 자동 요약 — wiki-archiver가 남김--- date: 2026-04-25 type: source-summary topic: dash tags: [clawgram, onboarding, deployment] --- # dash — 온보딩 페이지 구축 (2026-04-25) ## Facts - /onboarding 페이지 신규 구축 및 배포 - 스크린샷 13장 lazy-load ## Decisions - 페이지 위치: A옵션(정적) vs B옵션(Next.js) → B 채택 - 봇 이미지 13장 → URL 리다이렉션으로 변경 ## Patterns - 디자인: Nanum Myeongjo + 크림/딥네이비/골드
wiki/topic/토픽별 브리프 — 다음 진입 시 시스템 프롬프트에 자동 주입--- topic: dash updated: 2026-04-25 type: topic-brief --- # dash 토픽 브리프 clawgramDash(Next.js) 앱 개발·배포 세션. ## 최근 작업 (2026-04-25) - /onboarding 페이지 신규 구축 및 배포 - URL: https://clawgram.co/onboarding/ - 6섹션 구조, sticky 목차 - 디자인: Nanum Myeongjo + 크림/딥네이비/골드 ## 현재 상태 - 온보딩: 라이브 - 배포 방식: Cloudflare Workers
wiki/archive/원본 세션 로그 (.jsonl) — 마지막 안전망{"role":"user","text":"...","ts":"..."}
{"role":"assistant","text":"...","tools":[...]}
{"role":"user","text":"...","attachments":[...]}
... (대화 raw 그대로)토픽 브리프 자동 주입
토픽 진입 시 자동토픽으로 돌아오면 wiki/topic/<토픽명>.md의 내용이 시스템 프롬프트에 자동으로 들어갑니다. 이전 대화를 다시 설명할 필요가 없고, 며칠·몇 주 지나도 같은 맥락 그대로.
wiki-archiver — 자동 동작 시점
자동Q&A가 6쌍 이상 누적된 토픽에서 다음 두 시점에 archiver 에이전트가 백그라운드로 돌아 wiki/summaries/에 요약을 남깁니다. (대화가 짧으면 아카이빙 스킵)
- ① /del — 토픽 삭제 직전: 그 토픽의 진행·결정사항을 요약 보존
- ② /new (포럼 토픽 안에서) — 토픽 자체는 유지하고 Claude 세션만 초기화할 때, 직전 세션의 요약을 archiver가 남기고 새 세션 시작
- Telegram에는 결과 알림만, 실제 작업은 백그라운드 (사용자 응답 안 막음)
토픽 간 협업
큰 작업은 한 토픽 안에서 혼자 하지 않고, /fork·/spawn으로 자식 토픽들을 분리해서 병렬로 돌리고, ask·tell·abort로 서로 데이터를 주고받게 합니다. 토픽끼리 메시지가 오갈 때는 화살표 표기로 어느 쪽으로 흘렀는지 그대로 보입니다 — 보내는 쪽엔 `[→ 대상]`, 받는 쪽엔 `[from 보낸이]` / 응답이 돌아올 땐 `[← 대상]`.
정기 작업
토픽 안에서 자연어로 작업을 부탁하면 봇이 자동 실행 스크립트를 작성해 cron(스케줄러)에 걸어 둡니다. **정해진 시간이 되면 그 토픽에 결과가 자동으로 게시**됩니다 — 텍스트 요약 + 첨부 파일 형태가 일반적입니다. 사용자가 묻지 않아도 토픽이 알아서 채워지는 셈. 시간은 자연어로 — 「매일 오전 8시」, 「5분마다」, 「정각마다」, 「평일 오후 5시」 같이 부탁하면 됩니다. 어떤 작업을 맡길지는 토픽 성격에 따라 자유롭게 (정기 자료 모니터링·외부 사이트 스크래핑·일일 리포트 등).
프라이버시 모드
토픽 단위로 켜는 개인정보 자동 마스킹입니다. 사용자가 보내고 받는 화면에는 원문이 그대로 보이고, 외부 Claude API에는 토큰만 다녀갑니다 — 평소처럼 쓰셔도 외부로 새는 정보가 없습니다. (구체적인 흐름은 아래 구조 다이어그램 참조)
고객 ○○○ 010-1234-5678,주민번호 901225-1234567자료 정리해줘
고객 ○○○ [PHONE_1],주민번호 [SSN_1]자료 정리해줘
[PHONE_1], [SSN_1]토큰 그대로 사용해 작업 수행.로그·캐시도 토큰 형태.
[PHONE_1] → 010-1234-5678[SSN_1] → 901225-1234567캘린더·메일 등 실작업도 원문으로
고객 ○○○ 010-1234-5678,주민번호 901225-1234567자료 정리되어 도착.
외부 도구
토픽에 텔레그램으로 그대로 던지는 첨부(음성·문서·이미지)부터, 자연어로 부탁한 작업이 외부 도구를 요구할 때 봇이 알아서 실행하는 자동화까지 — 평소엔 꺼져 있다가 필요할 때만 자동으로 켜집니다.
음성 메시지 받아쓰기
토픽 · 텔레그램 음성 전송텔레그램 음성 메시지를 그대로 보내면 한국어로 받아쓰기됩니다. 운전 중·법원 이동 중 메모도 그대로 들어옵니다.
PDF · 워드 · 한글 문서 읽기
토픽 · 파일 첨부PDF는 pdftotext, DOCX는 pandoc으로 텍스트를 추출해 봇이 즉시 읽을 수 있는 상태로 만듭니다.
이미지 OCR
토픽 · 이미지 첨부스캔된 종이서류·사진·캡처된 화면에서 텍스트를 추출합니다. macOS Vision Framework + PaddleOCR(한·중·일·영) 두 엔진을 상황에 맞게 사용.
브라우저 자동화 (Playwright)
토픽 · 자연어사이트 접속·로그인·폼 작성·스크린샷·자료 다운로드까지 자동화. 30분 동안 안 쓰면 자원 절약을 위해 자동 종료.
- 예: 「○○사이트에서 자료 받아서 정리해줘」
- 토픽마다 독립된 브라우저 인스턴스가 떠서 — 사건별 로그인 세션·쿠키·열린 탭이 서로 섞이지 않습니다
- 다중 탭/윈도우 동시 관리
- 토픽에 playwright MCP가 활성화돼 있어야 함 (Ⅱ. 토픽 커스터마이징 참고)
한국어 PDF 자동 생성 (LaTeX · xelatex)
토픽 · 자연어「PDF로 정리해줘」, 「한국어 보고서 만들어줘」 — 봇이 마크다운 → pandoc → xelatex 파이프라인으로 한국어 폰트가 깨지지 않는 PDF를 자동 생성해 텔레그램으로 회신합니다.
- 한국어 폰트: AppleGothic / Noto Sans KR / 나눔명조 자동 선택
- 표지 · 목차 · 표 · 수식 · 코드블록 모두 지원
- fpdf 같은 Python 라이브러리 대신 pandoc + xelatex 우선 사용
결과 파일 전송
토픽 · 자연어「이거 PDF로 보내줘」, 「엑셀로 정리해서 다운로드 줘」 — Claude가 만들어낸 결과물을 파일로 텔레그램에 그대로 전송합니다.