AI 랩으로 돌아가기
🤖
AI 비서
Claude Code + Telegram으로 만든 22개 스킬 업무 자동화 비서
자연어 한 줄이면 계약서 작성, 서류 분석, 리스크 스캔, 메일 발송까지. 코딩 없이 Claude Code 바이브코딩만으로 구축한 실전 AI 비서 시스템입니다.
22개
보유 스킬
8개
연동 API
5일
개발 기간
Claude Code
핵심 기술
왜 만들었나
몰트봇(Moltbot, 구 오픈클로 OpenClaw)을 보고 영감을 받았습니다. AI가 텔레그램에서 직접 업무를 처리하는 모습에 "나도 내 업무에 맞는 AI 비서를 만들 수 있지 않을까?"라는 생각이 들었습니다. 반복되는 업무가 많았습니다. 서류 찾기, 분석 보고서 작성, 계약서 생성, 메일 발송... 각각은 단순하지만 모이면 하루가 가득 찹니다. Claude Code 바이브코딩만으로 비개발자도 실전 AI 에이전트를 구축할 수 있다는 것을 직접 증명한 프로젝트입니다.
어떻게 작동하나
텔레그램에 메시지를 보내면 Claude Code가 받아서 처리합니다. "OO 폴더 분석해줘"라고 하면 Google Drive에서 해당 폴더를 찾고, 문서를 하나씩 읽고, 분석한 결과를 텔레그램으로 돌려보냅니다. 계약서가 필요하면 사진을 보내고 "계약서 만들어줘"라고 하면 서류가 자동으로 생성됩니다. iPhone에서는 Siri에게 말하면 음성 릴레이를 통해 동일하게 처리됩니다.
멀티봇 아키텍처
처음에는 봇 하나로 시작했지만, 여러 사람이 동시에 사용하려면 독립된 봇이 필요했습니다. 현재는 각 사용자별 전용 봇이 있고, bot-manager가 모든 봇의 상태를 감시합니다. 봇이 죽으면 자동 재시작하고, 텔레그램 /restart 명령으로 원격 제어도 가능합니다.
스킬 카탈로그
분석
서류 분석
폴더의 PDF/Excel/Word를 5단계 하네스로 종합 분석
심층 보고서
전체 서류를 읽고 Word 보고서 자동 생성
기간 비교
2024 vs 2025 등 두 기간 서류 비교 분석
리스크 스캔
세무 리스크를 빠르게 탐지하여 보고
보고서 검증
작성된 보고서가 원본 서류와 일치하는지 교차 검증
자금흐름 정리
날짜+금액+당사자를 추출하여 시간순 정리
스캔 문서 강화
흐린 스캔/손글씨 이미지를 전처리하여 판독률 향상
작성
계약서 자동 작성
신분증+사업자등록증 → 계약서 3종 자동 생성
필요서류 체크리스트
세목별 필요서류 목록을 파일로 전송
서류 자동 분류
뭉치 서류를 세목별/연도별로 자동 정리
상담 체크리스트
업종별 첫 기장 상담 체크리스트를 워드 파일로 자동 생성
조회
고객DB 조회
Google Sheets 고객 데이터베이스 검색
파일 검색/전송
고객 폴더에서 파일을 찾아 텔레그램으로 전송
고객 폴더 검색
고객명으로 폴더 구조 표시
법령 검색
korean-law MCP로 법령·판례·해석례·개정비교 실시간 조회
소통
메일 자동 발송
Notion 템플릿 기반 자료요청 메일 발송
상담 메모 저장
상담 내용을 정리하여 고객 폴더에 저장
신규 고객 등록
신규 고객 폴더 생성 및 초기 설정
관리
할일 관리
Notion 연동 세무 업무 할일 추가/완료/조회
뉴스 브리핑
세무/경제 뉴스 웹 검색 후 텔레그램 전송
학습
정답노트 퀴즈
시험 정답 문장 저장 + OX 퀴즈 자동 출제 복습
기획
다중 에이전트 회의
여러 AI 에이전트가 아이디어를 병렬 생성→통합→순위
기술 스택
Claude Code
AI 엔진 — 자연어 → 코드 실행
Telegram Bot API
사용자 인터페이스 — 모바일 명령 수신/응답
Google Drive API
파일 저장소 — 고객 서류 검색/분석/전송
Notion API
업무 관리 — 할일 추가/완료/조회
python-docx
문서 생성 — 계약서/보고서 자동 작성
SQLite
로컬 DB — 정답노트/퀴즈 데이터 관리
MCP (Model Context Protocol)
도구 연결 — 외부 API를 Claude에 연결
SMTP (Gmail)
이메일 발송 — 고객 소통 메일 자동 전송
시스템 구조
1
사용자 레이어
Telegram 앱 (모바일/PC)Siri 음성 릴레이 (iOS)
2
AI 엔진
Claude Code (Opus)스킬 라우팅 (.claude/skills/)
3
외부 서비스
Google DriveNotionGmail SMTPGoogle Sheets
4
인프라
클라우드 서버 (24시간)systemd (상시 실행)bot-manager (자동 복구)
개발 타임라인
2026년 3월 31일
AI로 뭉치 서류를 카테고리별로 자동 분류하는 법
여러 서류가 섞여 있는 폴더를 AI가 분석해서 세목별/연도별로 자동 분류. 수작업 정리 시간을 대폭 절감.
2026년 3월 31일
Claude Code + Telegram으로 AI 비서 만들기 — 프로젝트 시작
Claude Code와 Telegram 봇을 연결하여 업무용 AI 비서 시스템을 처음부터 구축하는 과정. Google Drive 연동까지 초기 인프라 세팅 완료.
2026년 3월 31일
Claude Code에서 Google Calendar API 연동하는 법
Google Sheets와 Calendar을 OAuth로 통합 인증하고, MCP 서버로 Claude Code에서 직접 캘린더를 조회/관리할 수 있게 설정.
2026년 3월 31일
Claude Code로 Google Sheets 데이터 조회 자동화 만들기
1,000건 이상의 데이터가 있는 Google Sheets를 Python API로 연동. 텔레그램에서 이름만 말하면 즉시 정보를 검색해서 보여주는 스킬 구축.
2026년 3월 31일
AI가 매일 아침 뉴스를 요약해서 보내주는 자동화 만들기
매일 아침 AI가 자동으로 뉴스를 검색하고 요약해서 Telegram으로 보내주는 시스템. 스케줄러 + Claude Code 조합.
2026년 3월 31일
AI로 폴더 안의 서류를 전부 분석해서 Word 보고서 만들기
폴더 경로만 지정하면 AI가 모든 서류를 읽고, 5단계 검증을 거쳐 Word 보고서를 자동 생성하는 심층 분석 시스템 구축.
2026년 3월 31일
Claude Code로 계약서 자동 작성 + 리스크 스캔 시스템 구축
입력 데이터만 넣으면 계약서류 3종을 자동 작성하고, 서류에서 위험 요소를 빠르게 스캔하는 AI 시스템. 이 시점에서 17개 스킬 달성.
2026년 3월 31일
python-docx로 Word 계약서 서식을 100% 보존하며 자동 작성하는 법
Word 템플릿의 폰트/스타일을 완벽히 유지하면서 내용만 교체하는 플레이스홀더 방식으로 전환. run 단위 최소 교체로 서식 깨짐 해결.
2026년 4월 1일
클라우드 서버를 자동으로 확보하는 스크립트 만들기
클라우드 무료 서버 인스턴스를 자동으로 생성 시도하는 스크립트 구축. 성공하면 Telegram 알림이 오는 구조.
2026년 4월 1일
Telegram에서 메일 발송과 할일 관리까지 되는 AI 비서 만들기
Notion 템플릿 기반 자동 메일 발송(SMTP), Notion 연동 할일 관리 스킬 추가. 도움말 메뉴도 5개 카테고리로 재구성.
2026년 4월 1일
Telegram 봇 슬래시 메뉴가 초기화되는 문제 해결 방법
봇 재시작할 때마다 슬래시 메뉴가 3개로 돌아가는 문제. 원인은 all_private_chats scope 미등록이었고, 양쪽 scope 모두 18개 등록으로 해결.
2026년 4월 1일
crontab + flock으로 스크립트 자동 복구 워치독 만들기
백그라운드 스크립트가 죽어도 자동으로 재시작되는 워치독 시스템. 중복 실행 방지하면서 주기적으로 감시.
2026년 4월 1일
AI 에이전트에 장기 메모리를 추가하는 법 — Hindsight MCP 도입 계획
수동 메모리(MEMORY.md)에서 자동 메모리(Hindsight)로 업그레이드 계획. 대화 내용이 자동 축적되어 다음 대화에 관련 기억이 주입되는 구조.
2026년 4월 1일
AI 프로젝트 구축 과정을 웹사이트에 자동 기록하는 시스템 만들기
서버에서 작업할 때마다 GitHub API로 블로그 repo에 자동 push. Vercel이 자동 배포하여 웹사이트에 실시간 반영되는 빌드 로그 시스템.
2026년 4월 2일
Siri 음성 명령 relay 서버 자동 복구 시스템 구축
Siri 음성 명령을 Telegram으로 전달하는 relay 서버가 꺼져있던 문제 해결. 자동 감시 + 자동 복구 시스템을 추가하여 안정성 확보.
2026년 4월 2일
AI 모닝 브리핑에 오늘 날씨와 옷차림 추천 자동 추가하기
매일 아침 9시 모닝 브리핑에 서울 날씨 정보를 추가. wttr.in 무료 API로 기온, 강수확률, 옷차림 추천, 우산 필요 여부를 자동 포함.
2026년 4월 2일
Telegram 봇 슬래시 메뉴 18개 자동 등록 + /guide 도움말 명령어 추가
봇 재시작 시 슬래시 메뉴가 초기화되는 문제를 해결하고, 내장 명령어와의 충돌을 피해 서비스 안내 명령어를 분리.
2026년 4월 2일
Claude Code 텔레그램 봇 자동 복구 + 스킬 고도화 — 18개 스킬 안정 운영
봇 프로세스 비정상 종료 시 자동 재시작하는 워치독 체계 강화. 분석 스킬 정확도 보강, 계약서 스킬 개선, 메일/할일 스킬 추가로 총 18개 스킬 체계 완성.
2026년 4월 3일
AI 세무봇 클라우드 서버 이전 + 멀티봇 인프라 리팩토링
클라우드 서버 이전 후 credential 중앙관리, 스킬 공유 구조, 봇 매니저 통합, 서비스 분리까지 전체 인프라를 리팩토링. 봇 추가 시 설정 1줄로 가능한 구조 완성.
2026년 4월 3일
AI 세무봇 보안 강화 — 안전한 운영 환경 구축
외부 입력 처리 방식 개선, 방화벽 설정, 스크립트 보안 강화, 인증 토큰 권한 관리까지 전반적인 보안 점검 및 개선 완료.
2026년 4월 3일
AI로 스캔 문서 판독 강화 스킬 만들기
PDF 스캔 서류의 판독 실패 페이지를 이미지 전처리(대비 강화+회전 보정+이진화)로 재판독하는 /enhance 스킬을 개발. 300dpi 추출 후 PIL 전처리 파이프라인으로 판독률을 대폭 향상시키고, 실제 업무 보고서에 적용하여 효과를 검증.
2026년 4월 3일
AI 세무봇 모닝 브리핑 뉴스 품질 자동화
모닝 브리핑 뉴스 소스를 WebSearch에서 네이버 뉴스 API + 국세청 보도자료 자동 수집으로 전환. API 호출을 bash에서 사전 실행하는 B 방식으로 속도 3분→38초로 개선, 토큰 사용량도 절감.
2026년 4월 3일
AI로 공부용 OX 퀴즈 자동 출제 시스템 만들기
공부하면서 정리한 정답 문장을 SQLite에 저장하고, 스마트 알고리즘으로 약점 위주 OX 퀴즈를 자동 출제하는 복습 시스템 구축. 카테고리별 분류와 정답률 추적 지원.
2026년 4월 4일
AI로 다중 에이전트 아이디어 회의 시스템 만드는 법
Claude Code로 사업 아이디어를 자동 생성하고 평가하는 다중 에이전트 파이프라인을 9번의 반복 테스트를 거쳐 완성. 시드 분배 병렬 생성, 역삼각형 필터링, 자동 순위 매기기까지 3분 만에 완료되는 스킬로 구축했다.
2026년 4월 5일
Claude Code로 법령·판례 실시간 검색 스킬 만들기
세무 AI 봇에 법령·판례·해석례 검색 기능을 추가했다. 법제처 Open API 기반 korean-law MCP를 연동하여 조문 조회, 판례 검색, 조세심판원 결정, 행정해석례까지 텔레그램에서 바로 검색할 수 있다.
2026년 4월 5일
AI로 업종별 세무 상담 체크리스트 자동 생성하기
새 거래처 첫 기장 상담 시 업종별 체크리스트를 워드 파일로 자동 생성하는 스킬을 만들었다. 업종명만 입력하면 웹 검색으로 세무 특성을 조사하고 8단계 체크리스트를 생성한다.
2026년 4월 6일
시리 음성으로 텔레그램 봇 제어하기
Telethon MTProto API를 활용해 시리 음성 명령이 기존 텔레그램 세션에 이어서 작동하도록 구현. HTTP relay → Telethon → 봇 채팅방 전송 방식으로 카플레이에서도 음성으로 세무봇 제어 가능.
2026년 4월 7일
AI에게 SEO 점검과 수정까지 한번에 맡기는 법
주간 점검 봇이 발견만 하지 말고 안전한 범위 안에서 직접 코드 수정·빌드 검증·git push까지 자동으로 처리하도록 업그레이드. 빌드 실패 시 자동 롤백 + 알림.
2026년 4월 7일
Claude Code로 산개된 cron 통합하고 silent failure 잡는 법
11개로 흩어진 cron을 daily/weekly 래퍼 2개로 통합하고, 단계별 exit code 추적과 freshness 자체 점검을 내장. 며칠째 안 돌던 데이터 갱신과 silent하게 실패하던 래퍼 버그를 동시에 해결.
2026년 4월 8일
Claude Code로 산개된 기획 문서 14개를 단일 마스터로 정리하는 법
1년 운영하면서 plan 폴더에 14개로 늘어난 기획 문서를 단일 마스터로 통합. 활성 작업, 보류 plan 인덱스, 폐기 표시를 한 파일에 모으고 운영 가이드는 docs로 분리. 다음 세션에서 어떤 문서가 살아있는 plan인지 즉시 파악 가능.
2026년 4월 8일
Claude Code MCP 설정 일원화하고 새 세션 spawn 테스트로 검증하는 법
프로젝트의 MCP 설정 파일이 두 곳에 흩어져 충돌하던 상태를 단일 소스로 통합. 새 claude 세션을 별도로 띄워서 실제 노출되는 도구를 직접 확인하는 방식으로 검증해 31개 MCP 도구가 정확히 로드되는 것 확인.
2026년 4월 8일
Claude Code로 새 페이지 SEO 풀 최적화 자동화하는 법
신규 페이지를 메인에 통합할 때 빠지기 쉬운 SEO 요소(OG 이미지·breadcrumb·thin content·용도별 메타·시리즈 인터널 링크)를 한 번에 정리하는 방법. 84개 마크다운 자동 인젝션과 8개 동적 메타 생성.
2026년 4월 9일
Claude Code로 UX 버그 추적 - scroll bug 수정
/verdict 페이지에서 사용자가 옵션 선택 시 결과가 viewport 밖으로 사라지는 UX 버그 수정. window.scrollTo(top:0)을 결과 영역 scrollIntoView로 교체.
2026년 4월 9일
Cron 충돌 사고 추적해서 안전 패턴 만들기
여러 cron이 같은 git 작업 트리를 동시에 만지면서 한 cron의 작업물을 다른 cron이 reset --hard로 wipe하는 사고 발견. always-commit + safer-sync + flock 직렬화 3가지 fix 적용 + 운영 원칙 5가지 명문화.
2026년 5월 7일
Cron 데이터 11일 누락 사고 진단 + Layer 2 자체 감사 시스템 구축
update-rankings.sh의 git add 단일 호출에 리팩터로 삭제된 미존재 path가 남아있어 11일째 commit 단계만 silent 실패. 데이터 갱신은 정상이라 외부에선 정상 보였음. 1) 누락분 backfill commit 2) 스크립트 per-path 분리 fix 3) 매일 05 UTC 모든 관리 repo 동기화 감사 스크립트 신규 도입.
2026년 5월 15일
Claude Code로 cron 사고 자가복구 + 무한 false-positive 차단 패턴
주간 검증 cron이 dirty 상태에서 24분 작업 후 산출물이 휘발되는 사고가 발생. 원인 진단 후 abort-on-dirty 정책으로 전환하고, 휴리스틱이 잡지 못하는 운영자 검증 케이스용 override 필드를 도입해 같은 알림이 반복되지 않도록 차단했다.
2026년 5월 16일
Claude Code로 자동화 cron 폭주 직전 차단
주간 사이트 정합성 점검 cron이 도메인 이전 후 옛 도메인으로 curl을 던져 모든 링크가 죽었다고 오판하면 자동 수정·자동 commit·자동 push가 일어나는 구조였다. 발화 직전에 잡아서 SITE 변수 패턴으로 통일하고 다른 시스템 cron도 일괄 점검했다.
2026년 5월 16일
Claude Code로 자동화 알림 무한 반복 패턴 차단
주간 audit이 같은 false-positive 케이스를 매번 알림하던 문제를 운영자 override 메커니즘으로 해결했다. 가격 사이드에도 한국어 사이드와 동일 패턴을 적용해 두 검증 영역 모두 일관된 처리 가능.
2026년 5월 16일
Claude Code 컨텍스트 유지하는 안전한 재시작 명령어 만들기
MCP 플러그인이 끊겨도 직접 봇을 재시작하면서 대화 컨텍스트를 그대로 유지할 수 있는 /resume 명령어를 구축했다. 기존 /restart는 fresh 시작, 신규 /resume은 --continue 옵션으로 이전 세션을 그대로 이어받는다. wrapper 스크립트가 flag 파일을 보고 분기하며, 검증 결과 대화 전체와 진행 중이던 작업 맥락이 100% 보존됨을 확인했다.
2026년 5월 17일
AI로 한국 메인스트림 도구 자동 큐레이션 시스템 만들기
글로벌 + 한국 4가지 source에서 신규 AI 도구를 자동 발견하고 한국 사용자 인지도를 측정해 어드민 승인 요청까지 보내는 파이프라인 완성. 검수 패턴을 자동 학습하는 점수 알고리즘과 정기 발견·시간 단위 등재 자동화까지 풀스택 구축.
2026년 5월 18일
AI 도구 자동 발견 시스템 한국 시장 필터 정밀화
신규 발견 도구 중 일반명, 빅테크 변종, 한국 노출 미미한 영어 전용 서비스를 자동 차단하는 필터 강화. 어드민 검토 풀의 시그널 대비 노이즈 비율 개선.
2026년 5월 18일
AI 봇 컨텍스트 분리로 본업과 IT 역할 분담 시스템 구축
단일 AI 봇이 IT 개발 + 세무 본업을 통합 처리하던 구조를 두 봇 + 공유 스킬 저장소로 완전 분리. 봇별 메모리/지시문/명령어 메뉴 독립으로 도메인 특화 컨텍스트 자동 적용. 한 봇이 다운돼도 다른 봇은 정상 작동하는 격리 효과.
2026년 5월 18일
AI 봇 텔레그램 plugin 멀티봇 충돌 영구 해결
한 봇 재시작 시 다른 봇이 메시지 받지 못하던 root cause 발견. 봇 간 상태 파일 공유로 새 봇이 기존 봇을 stale 프로세스로 오해하고 종료 신호 전송. plugin이 이미 제공하는 환경변수 override 기능으로 봇별 상태 디렉토리 분리. plugin 코드 수정 없이 설정만으로 해결, 의도적 재현 stress test로 검증 통과.
2026년 5월 18일
미사용 mount service fail loop 정리로 시스템 노이즈 제거
21일간 17만번 restart 실패하던 disabled 봇의 mount 서비스 OAuth 토큰 만료 발견. 외부 알림 없이 시스템 로그만 폭증하던 상태. 사용자 영향 0 확인 후 service disable로 정리. 모닝 브리핑 영향 없음 사전 검증.
2026년 5월 18일
AI 도구 디렉토리에 자동 승인 + 즉시 게재 파이프라인 구축하기
그동안 수동으로 검수하던 신규 도구 등록을 v3 룰(절대점수+상대점수+빈자리 부스트)로 자동 승인 cron + 즉시 enrich 통합으로 완전 자동화. 매일 1건씩 게재되며 비는 시간에 슬래시 명령으로 추가 1건도 트리거 가능.
2026년 5월 19일
AI 도구 스팸 자동 차단 필터: 발견 단계에서 사기성 앱 거름
한 APK를 여러 이름으로 재등록하는 사기성 Play Store 리스팅을 발견 단계에서 자동 차단하는 5신호 분류기를 만들었습니다. 발견된 사례: app_id는 트위터 비디오 다운로더, 표시명은 음성-텍스트 메모, 설명은 다른 노트 앱 이름, 개발자명은 키워드 스터핑. 162개 후보 검증 결과 1.2%만 차단, false positive 0으로 정밀도 확보.
2026년 5월 21일
ChatGPT가 자동으로 좋은 AI 도구만 골라주는 시스템 만들기
AI 도구 발견 cron이 자꾸 정크 데이터(마케팅 카피 이름, 셀카 앱 등)를 추천해서 큐레이션 강화. 각 source 점수 상위 10개 + LLM으로 도구 이름 자동 정규화 적용. 무관한 카테고리 차단 + 매월 자동 발화로 검수 부담 감소.
2026년 5월 23일
AI 인사이트 반말 버그 + 관리자 저장 피드백 개선
자동 생성된 직업 인사이트 14건 중 2건이 반말로 나와 존대말 강제 룰을 추가하고, 관리자 편집 저장 시 성공 알림 + 0행 갱신 가드를 더해 회장님이 저장 결과를 즉시 확인할 수 있게 했습니다.
바이브코딩 실전 팁
Claude Code 스킬 시스템 활용
.claude/skills/ 폴더에 SKILL.md 파일만 추가하면 새로운 기능이 자동으로 인식됩니다. 코드 한 줄 없이 마크다운으로 AI의 행동을 정의할 수 있습니다.
MCP로 외부 서비스 연결
Model Context Protocol을 사용하면 Claude가 텔레그램, 구글 드라이브, 캘린더 등을 직접 조작할 수 있습니다. API 래퍼를 만들 필요 없이 MCP 서버 하나만 연결하면 됩니다.
봇 안정성 확보
systemd + bot-manager 조합으로 24시간 안정 운영. 봇이 먹통이어도 텔레그램 /restart로 복구 가능하게 설계했습니다.
자주 묻는 질문
AI 비서를 만드는 데 코딩 지식이 필요한가요?
아닙니다. 이 AI 비서는 100% 바이브코딩(자연어 지시)으로 만들었습니다. Claude Code에 한국어로 "텔레그램 봇 만들어줘"라고 하면 코드 작성부터 배포까지 AI가 수행합니다.
텔레그램 봇 운영 비용은 얼마인가요?
Telegram Bot API는 무료입니다. Claude Max 구독($100/월)과 클라우드 무료 티어 서버만 있으면 24시간 운영 가능합니다. Claude Pro($20/월)로도 시작할 수 있지만, 22개 스킬을 본격 운용하려면 Max 플랜이 필요합니다.
스킬은 어떻게 추가하나요?
.claude/skills/ 폴더에 마크다운 파일(SKILL.md)을 만들면 됩니다. "서류 분석해줘"라고 했을 때 어떻게 동작할지 자연어로 적으면 Claude가 그대로 따릅니다.
몰트봇(Moltbot)이나 오픈클로(OpenClaw)와 뭐가 다른가요?
몰트봇은 범용 AI 텔레그램 봇 서비스입니다. 이 프로젝트는 몰트봇에서 영감을 받아 Claude Code로 직접 만든 맞춤형 AI 비서입니다. 범용 서비스와 달리 업무에 특화된 22개 스킬을 자유롭게 정의하고, Google Drive·Notion·메일 등 내부 시스템과 직접 연동할 수 있습니다.
다른 업종에서도 쓸 수 있나요?
네. 서류 분석은 하나의 활용 사례일 뿐입니다. 스킬 정의만 바꾸면 법률, 의료, 교육, 마케팅 등 어떤 분야에서든 1인 1AI 업무 비서를 만들 수 있습니다.