작업 기록
소개
카카오톡 오픈채팅방 하나를 작은 나라처럼 운영하는 게임형 관리봇입니다. 안드로이드 공기계에 메신저봇R 앱을 깔고, 봇 계정으로 방에 들어가 있으면 돌아갑니다. 폰은 충전기에 꽂아 둔 채 켜 둡니다.
목적
국민 등록, 화폐, 출석, 투표와 선거 같은 방 운영 놀이를 명령어 하나씩으로 돌리는 것.
주요 기능
- 국민 등록, 신분증, 국민 목록
- 잔고, 송금, 하루 한 번 관직별 월급, 재산 순위
- 출석 보상과 출석 현황
- 나라 정보, 헌법, 공지, 관직 목록
- 투표, 그리고 끝나면 당선자를 관직에 자동으로 앉히는 선거
- 잔고와 투표 결과는 봇이 기록해 둡니다.
- 관직마다 권한이 있고, 도움말에는 내 권한으로 쓸 수 있는 명령만 보입니다.
- 마지막으로 말한 뒤 쌓인 대화를 요약하는 기능(선택, OpenAI 키가 있을 때만)
적용 기술
- MessengerBot R
- 안드로이드에서 카카오톡 알림을 받아 답하는 앱 (레거시 API)
- JavaScript
- bot.js 파일 하나, 맨 위 CONFIG에서 나라 이름, 관직, 권한, 월급을 설정
- OpenAI API
- 대화 요약 (선택)
- simulator.html
- 카카오톡 없이 PC 브라우저에서 시험하는 화면
- Node.js tests
- npm test
제작 과정
- 봇과 시험 코드, PC용 시뮬레이터를 만들었습니다.
- 메신저봇R에 붙여 넣기 쉬운 압축본을 더하고 문구를 고쳤습니다.
- 휴대폰에서 도움말이 명령어 중간에서 줄바꿈되지 않게 줄을 짧게 했습니다.
구현 중 문제와 해결
- 해결함
문제: 휴대폰 화면에서 도움말 줄이 명령어 중간에서 줄바꿈됐습니다.
고친 방법 도움말 한 줄을 짧게 줄였습니다.
- 해결함
문제: 대화 요약을 켜면 방 대화가 외부 AI로 나갑니다.
고친 방법 API 키가 없으면 요약이 꺼진 채로 동작하고, 켤 때는 방 공지로 멤버들에게 알리도록 안내합니다.
- 플랫폼의 한계
문제: 카카오가 공식으로 지원하는 방식이 아니어서 봇 계정이 제재될 수 있습니다.
고친 방법 반드시 봇 전용 계정을 쓰라고 안내합니다.
- 플랫폼의 한계
문제: 기록이 닉네임 기준이라 닉네임을 바꾸면 다른 사람이 됩니다.
고친 방법 설치 안내에 미리 적어 둡니다.
실제 결과물
테스트 오픈채팅방에서 국민 등록과 잔고 명령이 동작하는 장면을 휴대폰으로 녹화했습니다(0:16).
시연과 체험
- 시뮬레이션
오픈채팅 가상국가 봇
실제 봇 코드(bot.js)를 이 페이지 안에서 돌리는 시뮬레이션입니다. 카카오톡과 연결되어 있지 않고, 보내는 사람과 날짜를 바꿔 가며 시험할 수 있습니다. 기록은 새로고침하면 지워집니다. AI 대화 요약은 대화를 외부로 보내는 기능이라 꺼 두었습니다.
- 시연 영상
시연 영상 0:16, 소리 없음
관련 작업
맡은 일과 AI 도구
직접 한 일
- 실제 카카오톡 테스트 방에서 봇을 돌려 시연 영상을 녹화했습니다.
AI 도구를 쓴 곳
- 봇 코드, 시험, 시뮬레이터, 설치 안내는 AI 코딩 도구(Claude)로 만들었습니다(저장소 기록 2026-10-03).