토픽 관리
토픽(사건방)을 만들고 지우고 목록을 보는 운영 명령은 모두 봇과의 1:1 DM 채팅에서 처리합니다. DM에서 사용 가능한 슬래시 명령은 다음 6가지이며, 같은 일을 자연어로 부탁해도 동일하게 동작합니다.
/start
DMDM에서 사용할 수 있는 모든 슬래시 명령을 한 줄씩 정리한 도움말을 띄웁니다. 처음 봇을 마주했을 때 처음 입력하는 명령.
/s — 세션(토픽) 목록
DM현재 연결된 포럼 그룹의 모든 토픽을 한 줄씩 보여줍니다. 각 토픽의 세션 ID(앞 8자), 모델, effort, privacy 여부, 활성화된 MCP 도구, 토픽 바로가기 링크가 함께 표시됩니다.
/new <이름> — 새 토픽 생성
DM포럼 그룹 안에 새 토픽을 만들고 DB에 등록합니다. 동일 이름 토픽이 이미 있으면 바로가기 링크만 회신합니다. 봇이 그룹 관리자(Manage Topics 권한 포함)가 아니면 권한 안내로 막힙니다.
/new (인자 없이) — DM 컨텍스트 초기화
DM1:1 채팅 자체의 대화 흐름을 비웁니다. 토픽은 건드리지 않고 DM 대화만 새로 시작합니다.
/del <이름> — 토픽 삭제
DM토픽을 삭제하기 전에 wiki-archiver가 그 토픽의 진행과 결정사항을 자동 요약해 wiki/summaries/에 보존합니다. 그다음 텔레그램 토픽이 삭제됩니다 — 채팅방은 사라져도 기록은 남습니다.
/connect — 그룹 연결 확인 / 변경
DM현재 연결된 포럼 그룹의 이름과 그룹 ID를 보여줍니다. 다른 그룹으로 옮기려면 /connect <그룹ID> 형식으로 입력합니다. (1인당 1개 그룹만 연결 가능)
/debug — 디버그 모드 토글
DM켜두면 봇의 중간 사고과정·도구 호출 내역이 토픽에 같이 노출됩니다. 평소 OFF 상태로 두고, 동작이 이상할 때만 켜서 원인을 파악합니다.
토픽 커스터마이징
토픽마다 사용 모델·추론 깊이·검토자(advisor)·활성화할 MCP 도구를 따로 지정할 수 있습니다. 모두 DM에서 자연어로 부탁하면 됩니다 — 봇이 토픽 매니저를 호출해 설정을 갱신하고, 다음 메시지부터 적용됩니다.
모델 (model)
DM · 자연어토픽별로 Claude Opus / Sonnet / Haiku 중 어느 모델을 쓸지 지정합니다. 빠른 응답이 필요한 토픽은 Haiku, 깊은 분석이 필요한 토픽은 Opus.
- 예: 「○○토픽 모델 opus로 바꿔줘」
Effort (추론 깊이)
DM · 자연어low / medium / high / xhigh / max 다섯 단계. 단순 조회는 low, 복잡한 검토·법리 분석은 xhigh·max로 권장.
- 예: 「○○토픽 effort xhigh로 올려줘」
Advisor (검토자 모드)
DM · 자연어토픽의 실행 모델이 까다로운 판단에 직면하면, 더 강한 검토 모델(Opus 4.7)에게 한 번 더 자문을 받는 구조입니다. 중요한 의견서·법리 검토 토픽에 권장.
- 활성화 조건: 토픽의 실행 모델이 Opus 4.6/4.7 또는 Sonnet 4.6 이상
- 다음 메시지부터 적용
MCP 도구 활성화 / 비활성화
DM · 자연어토픽마다 사용할 도구를 골라 켜고 끌 수 있습니다. 예를 들어 자료조사 토픽에는 playwright(브라우저)와 wiki를, 일정 자동화 토픽에는 cron-manager를 활성화. 필요 없는 도구는 끄면 컨텍스트가 가벼워져 응답이 빨라집니다.
- 예: 「○○토픽에 playwright mcp 추가해줘」
- 예: 「○○토픽 cron-manager 빼줘」
- 변경은 다음 세션부터 적용
현재 설정 조회
DM · 자연어「○○토픽 지금 설정 어떻게 돼있어?」라고 물으면 모델·effort·privacy·advisor·MCP 상태를 한 번에 알려줍니다.
프라이버시 모드 (PII 마스킹)
토픽 단위로 켜는 개인정보 자동 마스킹입니다. 핵심 원리: **마스킹은 사무실 PC ↔ 외부 Claude API 사이의 경계에서만 일어납니다.** 사용자가 보내고 받는 화면 양쪽 모두에는 원문이 그대로 보이고, 외부 서버에는 토큰만 다녀갑니다. 변호사·사무직원이 평소처럼 쓰셔도 외부로 새는 정보는 없습니다.
- 사용자변호사·사무직원원문 그대로
예: “고객 ○○○ 010-1234-5678, 주민번호 901225-1234567 자료 정리해줘”
↓메시지·첨부 - 사무실 PCClawgram① PII 탐지 + 토큰 치환
KoELECTRA + BERT-NER + 정규식 보조 → 010-… → [PHONE_1] → 901225-… → [SSN_1]
↓토큰만 전송 - 외부Anthropic Claude API원문 도달 X
Claude는 [PHONE_1], [SSN_1] 토큰 그대로 사용해 작업 수행. 로그·캐시도 토큰 형태.
↓응답 (토큰 포함) - 사무실 PCClawgram② 토큰 → 원문 역매핑
응답·도구 호출 시점에서 [PHONE_1] → 010-1234-5678 복원. 캘린더·메일 발송도 원문으로.
↓원문 복원된 응답 - 사용자변호사·사무직원원문 그대로
사용자 화면에는 처음 보낸 그대로의 정보가 보임.
/debug ON.활성화 / 비활성화
DM · 자연어DM에서 「○○토픽 privacy 켜줘 / 꺼줘」 한 줄로 토픽 단위 토글. 활성화 직후 해당 토픽에 시스템 안내가 자동으로 뜹니다.
탐지 엔진 — 사무실 PC 안에서만
자동사무실 PC에서 도는 로컬 FastAPI 서버가 한국어 NER(KoELECTRA + BERT-NER)로 PII를 1차 탐지하고, 정규식이 보조(전화/이메일/카드번호/주민번호/계좌). 탐지 자체는 클라우드를 거치지 않습니다.
외부 경계에서만 토큰 치환
자동탐지된 PII는 [PHONE_1], [EMAIL_1], [SSN_1], [CARD_1] 같은 토큰으로 치환된 상태로만 외부 Claude API에 전송됩니다. 같은 값은 같은 토큰으로 일관 매핑되어 의미가 살아 있습니다 — 외부 서버에는 원문이 절대 다녀가지 않습니다.
응답 단계에서 자동 역매핑
자동Claude가 토큰이 섞인 답변을 돌려주면 봇이 사용자에게 보내기 직전에 토큰 → 원문으로 다시 매핑합니다. 도구 호출(예: 캘린더 등록·메일 발송) 시점에서도 동일하게 원문이 복원되어 실제 작업이 정상 수행됩니다.
사용자 입장에서는 평소와 동일
구조적 보장변호사·사무직원이 보는 입력창과 응답 화면에는 원문이 그대로 표시됩니다. 마스킹은 사무실 PC ↔ Claude API 사이의 보이지 않는 경계에서만 일어나기 때문에, 의식하지 않고 평소처럼 작업해도 외부로 새는 정보가 없습니다.
ID/PW 권장 형식 — 안전한 입력
토픽 · 사용자 입력비밀번호처럼 NER이 일반적으로 인식하지 못하는 자유 텍스트 항목은 ID: ... / PW: ... 형식으로 입력하면 봇이 PW 부분을 확실히 탐지·마스킹합니다. 활성화 시 토픽에 자동 안내됩니다.
/debug — 마스킹 동작 직접 확인
DM/debug ON 상태에서 PII가 들어간 메시지를 보내면 중간 사고과정에 [PHONE_1] 같은 토큰이 그대로 노출됩니다. 어떤 항목이 어떤 토큰으로 치환되어 외부로 나가는지 직접 검증할 수 있습니다.
첨부 — 음성 · 문서 · 이미지
토픽 안에서 텔레그램으로 그대로 던지면 됩니다 — 별도 변환·업로드 절차가 없습니다. 받은 파일은 자동으로 텍스트화되어 Claude가 그대로 읽습니다.
음성 메시지 (Whisper)
토픽 · 텔레그램 음성 전송텔레그램 음성 메시지를 그대로 보내면 Whisper가 한국어로 받아쓰기합니다. 운전 중·법원 이동 중 메모도 그대로 들어옵니다.
PDF · 워드 · 한글 문서
토픽 · 파일 첨부PDF는 pdftotext, DOCX는 pandoc으로 텍스트를 추출해 봇이 즉시 읽을 수 있는 상태로 만듭니다.
이미지 OCR
토픽 · 이미지 첨부스캔된 종이서류·사진·캡처된 화면에서 텍스트를 추출합니다. macOS Vision Framework + PaddleOCR(한·중·일·영) 두 엔진을 상황에 맞게 사용.
동영상 프레임 분석
토픽 · 비디오 첨부ffmpeg로 핵심 프레임을 뽑아 봇이 시각적으로 분석할 수 있도록 처리합니다.
여러 파일 한 번에
토픽 · 텔레그램 미디어 그룹여러 파일을 동시에 던지면 자동으로 묶어서 한 번의 요청으로 처리합니다.
메모리 — LLM-Wiki
사용할수록 똑똑해지는 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의 내용이 시스템 프롬프트에 자동으로 들어갑니다. 이전 대화를 다시 설명할 필요가 없고, 며칠·몇 주 지나도 같은 맥락 그대로.
사실 · 결정 · 패턴 저장 (save_wiki_entry)
토픽 · 자연어「이거 기억해 둬」, 「다음부터는 ○○ 양식 써」, 「이 의뢰인은 △△로 호칭」 — 핵심을 LLM이 추출해 사실(Facts) · 결정(Decisions) · 패턴(Patterns) 단위로 자동 분류 저장.
다른 토픽 위키 검색 (wiki_query)
토픽 · 자연어「○○사건 때 우리가 어떻게 정리했지?」라고 물으면 모든 토픽 위키를 뒤져 관련 항목을 인용해 가져옵니다. 그 토픽의 대화 히스토리는 건드리지 않고 wiki만 참조.
wiki-archiver — 자동 동작 시점
자동Q&A가 6쌍 이상 누적된 토픽에서 다음 두 시점에 archiver 에이전트가 백그라운드로 돌아 wiki/summaries/에 요약을 남깁니다. (대화가 짧으면 아카이빙 스킵)
- ① /del — 토픽 삭제 직전: 그 토픽의 진행·결정사항을 요약 보존
- ② /new (포럼 토픽 안에서) — 토픽 자체는 유지하고 Claude 세션만 초기화할 때, 직전 세션의 요약을 archiver가 남기고 새 세션 시작
- Telegram에는 결과 알림만, 실제 작업은 백그라운드 (사용자 응답 안 막음)
토픽 간 메모리 격리
기본 동작프라이버시 보호를 위해, 한 토픽의 메모리가 다른 토픽으로 자동 흘러가지 않습니다. 명시적으로 「○○토픽 위키 가져와」라고 했을 때만 인용됩니다.
자동 실행 — Cron
토픽 안에서 자연어로 작업을 부탁하면 봇이 Python 스크립트를 자동 작성해 cron(스케줄러)에 걸어 둡니다. **정해진 시간이 되면 그 토픽에 결과가 자동으로 게시**됩니다 — 텍스트 요약 + 첨부 파일 형태가 일반적입니다. 사용자가 묻지 않아도 토픽이 알아서 채워지는 셈. 어떤 작업을 자동화할지는 토픽 성격에 따라 자유롭게 (정기 자료 모니터링·외부 사이트 스크래핑·일일 리포트 등).
스케줄 등록 (cron_create)
토픽 · 자연어자연어로 작업을 부탁하면 봇이 Python 스크립트(cron/<name>.py)를 자동 작성하고 cron 표현식과 함께 등록합니다. 표준 cron 표현(예: `0 8 * * *`, `*/5 * * * *`)도 직접 지정 가능.
스케줄 목록 · 로그
토픽 · 자연어 (cron_list / cron_logs)「지금 돌고 있는 크론 다 보여줘」, 「이번 주 email_to_calendar 로그 보여줘」 — 현재 등록 상태와 실행 로그(최근 N줄)를 확인합니다.
삭제 / 재시작 / 강제 종료
토픽 · 자연어「○○ cron 지워줘」 → cron_delete, 「다시 시작해」 → cron_restart. 막힌 락이 있으면 cron_kill / cron_reset으로 정리.
다른 토픽에서 결과 조회 (ask_cron)
토픽 · 자연어예약 작업 결과는 등록된 토픽에 누적됩니다. 다른 토픽에서 「○○ 자동화 토픽에서 이번 주 결과 가져와」 같이 부탁하면 ask_cron으로 그 토픽의 cron 데이터만 인용해서 가져옵니다.
기존 세션 재사용 / 초기화
구조각 cron 작업은 자체 Claude 세션을 가지며 누적된 컨텍스트로 다음 실행을 더 정확히 처리합니다. 컨텍스트가 너무 커지거나 흐름이 꼬이면 cron_reset으로 초기화 — 등록은 유지되고 누적 기억만 비워집니다.
토픽 간 협업
큰 작업은 한 토픽 안에서 혼자 하지 않고, /fork·/spawn으로 자식 토픽들을 분리해서 병렬로 돌리고, ask·tell·abort로 서로 데이터를 주고받게 합니다. 토픽끼리 메시지가 오갈 때는 화살표 표기로 어느 쪽으로 흘렀는지 그대로 보입니다 — 보내는 쪽엔 `[→ 대상]`, 받는 쪽엔 `[from 보낸이]` / 응답이 돌아올 땐 `[← 대상]`.
/fork [이름] — 자식 토픽 (컨텍스트 상속)
포럼 토픽 슬래시현재 토픽의 Claude 세션을 그대로 복제해 자식 토픽을 만듭니다. 부모의 대화·메모리·결정사항을 모두 알고 있는 상태로 시작 — 같은 사건의 하위 작업을 병렬로 돌릴 때 사용합니다. 부모와 자식은 독립적으로 진행되어 부모 히스토리는 오염되지 않습니다.
/spawn [이름] — 자식 토픽 (새 세션)
포럼 토픽 슬래시자식 토픽을 새 세션으로 만듭니다. 부모의 대화·기억은 가져오지 않지만 모델·effort·privacy·MCP 같은 설정은 그대로 상속. 같은 토픽의 다른 사건/주제를 따로 돌리고 싶을 때 사용.
ask_session — 다른 토픽에 질문하고 결과만 가져오기
토픽 · 자연어「○○토픽에 물어봐서 ~ 가져와줘」 한 줄. 그 토픽의 컨텍스트로 임시 포크가 떠서 작업 후 결과만 회신 — 원래 토픽 히스토리는 손대지 않습니다.
tell_session — 다른 토픽에 일방향 전달
토픽 · 자연어「이거 ○○토픽에 알려둬」처럼 응답이 필요 없는 통보. 받은 토픽은 비동기로 처리하며 회신은 없습니다.
abort_session — 다른 토픽 작업 강제 중단
토픽 · 자연어다른 토픽이 오래 걸리는 작업을 돌고 있으면 「○○토픽 작업 중단해」로 끊어 옵니다. 보통 peek_session으로 상태 먼저 확인.
list_sessions / peek_session — 전체 상태 보기
토픽 · 자연어「지금 어느 토픽이 돌고 있어?」, 「○○토픽 뭐 하는 중이야?」 — 활성 토픽과 현재 실행 중인 작업을 한눈에 봅니다.
외부 도구
토픽 안에서 자연어로 부탁한 작업이 외부 도구를 요구하면 봇이 알아서 실행합니다. 평소엔 꺼져 있다가 필요할 때만 자동으로 켜집니다.
브라우저 자동화 (Playwright)
토픽 · 자연어사이트 접속·로그인·폼 작성·스크린샷·자료 다운로드까지 자동화. 30분 동안 안 쓰면 자원 절약을 위해 자동 종료.
- 예: 「○○사이트에서 자료 받아서 정리해줘」
- 다중 탭/윈도우 동시 관리
- 토픽에 playwright MCP가 활성화돼 있어야 함 (Ⅱ. 토픽 커스터마이징 참고)
한국어 PDF 자동 생성 (LaTeX · xelatex)
토픽 · 자연어「PDF로 정리해줘」, 「한국어 보고서 만들어줘」 — 봇이 마크다운 → pandoc → xelatex 파이프라인으로 한국어 폰트가 깨지지 않는 PDF를 자동 생성해 텔레그램으로 회신합니다.
- 한국어 폰트: AppleGothic / Noto Sans KR / 나눔명조 자동 선택
- 표지 · 목차 · 표 · 수식 · 코드블록 모두 지원
- fpdf 같은 Python 라이브러리 대신 pandoc + xelatex 우선 사용
macOS UI 제어
토픽 · 자연어사무실 PC의 앱을 직접 다룹니다. 열려 있는 앱 목록 조회, 버튼 클릭, 텍스트 입력, 스크린샷 + OCR로 화면 안 요소 찾기.
결과 파일 전송
토픽 · 자연어「이거 PDF로 보내줘」, 「엑셀로 정리해서 다운로드 줘」 — Claude가 만들어낸 결과물을 파일로 텔레그램에 그대로 전송합니다.
토큰 사용량 조회
토픽 · 자연어 / get_usage_stats이번 달·이번 주 사용량을 토픽별·세션별로 확인할 수 있습니다.
먼저 텔레그램 그룹 연결부터
매뉴얼의 기능들은 모두 텔레그램 포럼 그룹이 봇과 연결된 뒤에 사용 가능합니다. 도입 가이드에 단계별 스크린샷을 정리해 두었습니다.
도입 가이드 보기 →