AI 랩으로 돌아가기
🤖
AI 비서
Claude Code + Telegram으로 만든 21개 스킬 업무 자동화 비서
자연어 한 줄이면 계약서 작성, 서류 분석, 리스크 스캔, 메일 발송까지. 코딩 없이 Claude Code 바이브코딩만으로 구축한 실전 AI 비서 시스템입니다.
21개
보유 스킬
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 고객 데이터베이스 검색
파일 검색/전송
고객 폴더에서 파일을 찾아 텔레그램으로 전송
고객 폴더 검색
고객명으로 폴더 구조 표시
소통
메일 자동 발송
Notion 템플릿 기반 자료요청 메일 발송
상담 메모 저장
상담 내용을 정리하여 고객 폴더에 저장
신규 고객 등록
신규 고객 폴더 생성 및 초기 설정
관리
할일 관리
Notion 연동 세무 업무 할일 추가/완료/조회
뉴스 브리핑
세무/경제 뉴스 웹 검색 후 텔레그램 전송
빌드 로그 기록
AI 랩 빌드 로그를 GitHub에 자동 push
학습
정답노트 퀴즈
시험 정답 문장 저장 + 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일
Oracle Cloud 무료 ARM 서버를 자동으로 확보하는 스크립트 만들기
클라우드 무료 서버 인스턴스를 자동으로 생성 시도하는 스크립트 구축. 성공하면 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 세무봇 ARM 서버 이전 + 멀티봇 인프라 리팩토링
클라우드 서버 이전 후 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월 4일
웹사이트 광고 수익 차단 문제 해결하는 법
CSP(Content Security Policy) 설정 오류로 카카오 애드핏과 쿠팡 파트너스 광고가 전면 차단되어 있던 문제를 발견하고 즉시 수정. 광고 도메인 3곳을 허용 목록에 추가하여 정상화했다.
2026년 4월 4일
AI 랩 프로젝트 상세 페이지 구축 — 바이브코딩으로 SEO 최적화 페이지 만들기
AI 랩의 3개 핵심 프로젝트에 독립 상세 페이지를 추가했다. 기술스택, 개발 타임라인, 스킬 카탈로그, FAQ를 구조화하고 JSON-LD SEO까지 적용.
2026년 4월 5일
AI 꿀조합 54개 + 직업 도구 검증 + 랭킹 자동화 — 하루만에 완성한 콘텐츠 허브
AI 도구 조합 워크플로우 54개를 구축하고 직업별 연동, 도구 매핑 검증, SEO 최적화, 랭킹 자동 갱신까지 완성했다. 콘텐츠 보강과 할루시네이션 검증까지 포함.
바이브코딩 실전 팁
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/월)로도 시작할 수 있지만, 21개 스킬을 본격 운용하려면 Max 플랜이 필요합니다.
스킬은 어떻게 추가하나요?
.claude/skills/ 폴더에 마크다운 파일(SKILL.md)을 만들면 됩니다. "서류 분석해줘"라고 했을 때 어떻게 동작할지 자연어로 적으면 Claude가 그대로 따릅니다.
몰트봇(Moltbot)이나 오픈클로(OpenClaw)와 뭐가 다른가요?
몰트봇은 범용 AI 텔레그램 봇 서비스입니다. 이 프로젝트는 몰트봇에서 영감을 받아 Claude Code로 직접 만든 맞춤형 AI 비서입니다. 범용 서비스와 달리 업무에 특화된 21개 스킬을 자유롭게 정의하고, Google Drive·Notion·메일 등 내부 시스템과 직접 연동할 수 있습니다.
다른 업종에서도 쓸 수 있나요?
네. 서류 분석은 하나의 활용 사례일 뿐입니다. 스킬 정의만 바꾸면 법률, 의료, 교육, 마케팅 등 어떤 분야에서든 1인 1AI 업무 비서를 만들 수 있습니다.