카카오 봇 프로젝트햄
카카오톡 자동화의 걸림돌은 로그인이 아니라, '보냈다'고 믿는 순간이다. 공식 앱을 그대로 조작하는 CLI를 살펴봤다.
이 아티클의 핵심 내용 요약과 글로벌 검색·AI 엔진을 위한 테이크어웨이입니다.
✦ KR 주제: 카카오 봇 프로젝트햄: openkakao-cli와 카카오 자동화 생태계
✦ KR 핵심 요약: openkakao-cli는 macOS 손쉬운 사용으로 이미 로그인된 공식 카카오톡 앱을 제어해 읽기·전송·검색·리액션을 수행하고, 전송 결과를 화면에서 재확인하는 CLI다. 추가 로그인이나 프로토콜 통신, DB 복호화 없이 동작하는 점이 핵심이며, kakao-tone-bot과 kakao-bot은 각각 오픈빌더 스킬 서버와 안드로이드 알림 기반이라는 다른 경로를 쓴다.
🌐 Global Takeaway: openkakao-cli automates KakaoTalk on macOS by driving the already-logged-in official app through Accessibility, with no extra login, no direct server communication, and no database decryption. Its verified-on-screen send confirmation is the design detail worth borrowing for any agent automation.
카카오톡은 국내에서 가장 널리 쓰이는 메신저지만, 자동화 관점에서는 유난히 다루기 까다로운 대상이다. 로그인 세션과 프로토콜, 로컬 데이터베이스가 모두 보호되어 있기 때문이다. Threads 게시물(@ham_cifer)과 GitHub 저장소를 통해 확인되는 '프로젝트햄' 관련 카카오 봇 프로젝트는 이 벽을 정면으로 뚫는 대신, 이미 로그인된 공식 macOS 카카오톡 앱을 그대로 조작하는 쪽을 택했다. 그 중심에 있는 저장소가 JungHoonGhae/openkakao-cli다.
openkakao-cli: 로그인 없는 카카오톡 자동화
README의 첫 문장은 "카카오톡 일을 AI 에이전트에게 맡기는 macOS CLI"다. 저장소 설명에는 보내기, 읽기, 리액션, 검색, 백업, 정리까지 공식 앱을 통해 수행한다고 적혀 있다. 중요한 건 '공식 앱을 통한다'는 부분이다. 별도 로그인도, 카카오 서버와의 직접 통신도, 로컬 대화 DB 복호화도 없다고 저장소는 밝힌다.
동작 원리: 손쉬운 사용(Accessibility)
macOS의 손쉬운 사용 API로 이미 로그인된 카카오톡 Mac 앱의 UI를 읽고 누른다. 실행 전에는 현재 떠 있는 카카오톡이 카카오의 공식 코드 서명을 가졌는지 먼저 검사하고, 서명이 확인된 앱이 화면에 보여 주는 구조만 읽는다는 것이 저장소가 제시하는 전제다. 다른 기기로 로그인하지 않고, 카카오 서버와 직접 통신하지 않고, 로컬 대화 DB를 풀어 읽지 않는다는 세 가지 원칙이 여기서 나온다.
실제 명령은 단순하다. 최근 메시지는 openkakao-cli ax-read "가족" -n 20, 텍스트 전송은 openkakao-cli local-send "가족" "회의 끝나고 전화할게", 파일 전송은 openkakao-cli local-send-file "김대리" ~/Downloads/견적서.pdf, 기록 검색은 openkakao-cli ax-search "김대리" "계약서" 형태다. 별도 설정 파일 없이도 대화방 이름과 메시지를 인자로 넘기는 구조라, 에이전트가 호출하기 쉬운 인터페이스를 갖췄다.
또 하나 실용적인 설계는 키보드와 마우스를 빼앗지 않는다는 점이다. 기본 경로에서는 카카오톡 창을 앞으로 끌어오지도, 키 입력을 보내지도 않는다. 카카오톡 창이 다른 데스크톱(Space)에 떠 있어도 그 자리에서 읽고 텍스트를 보낸다. 사용자는 같은 Mac으로 하던 작업을 그대로 이어 갈 수 있다.
전송 '성공'을 화면에서 다시 확인한다
자동화에서 가장 위험한 실패는 조용한 실패다. 명령은 정상 종료됐는데 메시지는 가지 않은 경우다. openkakao-cli는 이 지점을 명시적으로 다룬다.
보낸 메시지는 화면에서 다시 읽어 확인합니다. — README
구체적으로 새 말풍선이 생겼는지, 파일 업로드가 끝나 '공유' 버튼이 떴는지, '수정됨' 표시가 붙었는지, 리액션 수가 늘었는지를 성공 조건으로 삼는다. 확인하지 못하면 성공했다고 알리지 않고 멈춘다. 에이전트 입장에서는 실패를 성공으로 착각할 여지를 줄이는 장치다.
속도도 화면 캡처 기반 자동화와 결이 다르다. 화면을 이미지로 떠서 템플릿 매칭을 하는 대신 앱의 UI 구조를 직접 읽는다. 저장소에 적힌 측정값은 텍스트 전송·확인 0.5~0.7초, 최근 메시지 20개 읽기 0.3~0.5초다(Mac Studio, 카카오톡 26.8 환경 기준). 물론 이 수치는 하드웨어와 앱 버전에 따라 달라질 수 있다.
같은 문제, 다른 접근: 카카오 봇 생태계 비교
검색에서 함께 확인되는 프로젝트들과 나란히 놓으면 설계 철학 차이가 선명해진다.
| 프로젝트 | 접근 방식 | 특징 | 확인되는 제약 |
|---|---|---|---|
| openkakao-cli | macOS 손쉬운 사용으로 공식 앱 UI 제어 | 추가 로그인·프로토콜 통신·DB 복호화 없음, 전송 결과 화면 검증 | macOS 전용, 카카오톡 앱 실행·로그인 상태 전제 |
| kakao-tone-bot | 카카오 i 오픈빌더 스킬 서버(FastAPI) + LLM API | 받는 사람·상황에 맞춰 문장 교정, 기본 Gemini·Claude 전환 가능 | 채널 챗봇 형태, Python 3.11 이상 |
| kakao-bot | 안드로이드 알림을 메신저봇R로 읽어 UDP 서버에서 처리 | ChatGPT 질의응답, 서비스 인터페이스로 기능 추가 | 안드로이드 기기 필요, 카카오톡 9.6.7 권장 |
세 프로젝트는 이름만 '카카오 봇'으로 비슷할 뿐 풀고 있는 문제가 다르다. openkakao-cli는 내 카카오톡 계정의 실제 대화방을 자동화하는 도구이고, kakao-tone-bot은 채널 챗봇에 말투 교정 기능을 붙이는 예제이며, kakao-bot은 알림 기반 응답 봇이다. kakao-tone-bot은 받는 사람(상사, 교수님 등)과 상황(조의, 축하, 결석 연락 등)을 미리 고르고, 대충 쓴 문장을 바로 보낼 수 있는 문장으로 다듬는 구조다. kakao-bot은 안드로이드 알림을 기기 밖 서버로 전달해 처리 후 알림으로 답장하는 방식이라, 모바일 기기가 항상 켜져 있어야 한다는 제약이 따른다.
AI 에이전트와 붙일 때 고려할 점
openkakao-cli가 'AI 에이전트용'을 표방하는 만큼, 에이전트가 호출하기 좋은 조건을 갖추고 있다. 명령이 짧고, 결과가 화면 검증으로 이어지며, 사람의 입력 장치를 점유하지 않는다. 저장소에는 skills/openkakao-cli 디렉터리와 AGENTS.md가 포함되어 있어 에이전트 연동을 전제로 한 문서화가 이루어져 있는 것으로 확인된다.
반대로 전제 조건도 분명하다. macOS 환경이어야 하고, 카카오톡 앱이 실행 중이며 로그인되어 있어야 하며, 손쉬운 사용 권한이 부여되어야 한다. 이 중 하나라도 빠지면 자동화는 성립하지 않는다. 확인되는 범위에서 저장소는 409개 커밋 이력을 갖고 있고, Cargo.toml과 rust-toolchain.toml이 포함되어 있어 Rust 기반으로 작성된 것으로 보인다. install.sh, config.example.toml, examples/launchd, bench, tests, CHANGELOG.md 같은 구성은 설치·벤치마크·변경 추적을 염두에 둔 구조다.
핵심 정리
- openkakao-cli는 macOS에서 이미 로그인된 공식 카카오톡 앱을 손쉬운 사용으로 조작해 읽기·전송·파일 전송·검색·리액션·백업을 수행하는 CLI다.
- 추가 로그인, 카카오 서버 직접 통신, 로컬 DB 복호화를 사용하지 않으며, 실행 중인 앱의 공식 코드 서명을 먼저 확인한다.
- 전송 성공을 말풍선 생성, 업로드 완료와 '공유' 버튼, '수정됨' 표시, 리액션 증가 같은 화면 변화로 재확인하고, 확인 실패 시 성공으로 보고하지 않는다.
- kakao-tone-bot과 kakao-bot은 각각 오픈빌더 스킬 서버, 안드로이드 알림 기반이라는 전혀 다른 경로를 사용한다.
실무 적용 포인트
- 자동화 범위를 먼저 정한다. 단순 알림이나 리마인더라면 채널 챗봇이나 알림 기반 봇이 가볍고, 이미 쓰는 카카오톡 대화방을 그대로 다뤄야 한다면 openkakao-cli 쪽이 맞다.
- '보냈다'와 '보였다'를 분리해서 설계한다. openkakao-cli의 화면 검증처럼 자동화 결과를 별도 신호로 확인하는 단계가 없으면, 운영 중 조용한 실패를 놓치기 쉽다.
- 권한과 환경을 문서화한다. 손쉬운 사용 권한, 카카오톡 로그인 상태, macOS 버전, 앱 버전 같은 전제 조건이 결과 품질을 좌우한다.
- 개인 계정 자동화는 속도보다 안전이 우선이다. 대량 전송이나 반복 전송, 민감한 대화방 접근은 별도 정책과 승인 절차를 두는 편이 낫다.
- 저장소를 그대로 신뢰하기보다 릴리스와 변경 이력을 확인한다. openkakao-cli는 CHANGELOG, ROADMAP, CONTRIBUTING, AGENTS 문서와 테스트·벤치 디렉터리를 함께 두고 있어 동작 변경을 추적할 재료가 있다.
- 여러 봇을 조합할 때는 역할을 나눈다. 문장 교정은 kakao-tone-bot 같은 스킬 서버에, 실제 대화방 실행은 openkakao-cli에 맡기는 식의 분업이 현실적이다.
마무리
'프로젝트햄'으로 공유된 카카오 봇 프로젝트의 핵심은 새로운 프로토콜을 만드는 것이 아니라, 이미 존재하는 공식 앱의 화면을 정직하게 다루는 데 있다. 로그인을 우회하지 않고, 서버를 흉내 내지 않고, 확인되지 않은 성공을 주장하지 않는 설계는 자동화를 오래 굴리려는 팀에 시사하는 바가 크다. 다만 macOS 전용이고 앱 실행 상태에 의존한다는 전제는 분명히 감안해야 한다.
자주 묻는 질문
Q. openkakao-cli는 카카오 계정으로 새로 로그인해야 하나요?
A. 아닙니다. 저장소 설명에 따르면 이미 로그인된 공식 카카오톡 Mac 앱을 손쉬운 사용으로 조작하는 방식이며, 추가 로그인이나 다른 기기 로그인, 카카오 서버와의 직접 통신, 로컬 대화 DB 복호화를 사용하지 않습니다.
Q. 메시지가 실제로 전송됐는지는 어떻게 알 수 있나요?
A. 보낸 뒤 화면에서 다시 읽어 확인합니다. 새 말풍선이 생기고, 파일 업로드가 끝나 '공유' 버튼이 뜨고, '수정됨'이 붙고, 리액션 수가 늘어야 성공으로 판단합니다. 확인하지 못하면 성공이라고 알리지 않고 멈춥니다.
Q. kakao-tone-bot이나 kakao-bot과 무엇이 다른가요?
A. openkakao-cli는 내 카카오톡 대화방을 직접 자동화하는 macOS CLI입니다. kakao-tone-bot은 카카오 i 오픈빌더 스킬 서버와 LLM API로 문장을 교정하는 채널 챗봇이고, kakao-bot은 안드로이드 알림을 메신저봇R로 읽어 서버에서 처리하는 알림 기반 봇입니다.



댓글 0개