OpenClaw + KakaoTalk

BlueStacks 부계정 연동 시스템 아키텍처

시스템 개요

브릿지 서버
localhost:<PORT>
Gateway
<VPN_IP>:<PORT>
에뮬레이터 ADB
127.0.0.1:<PORT>
내부 브릿지 URL
10.0.2.2:<PORT>

아키텍처 다이어그램

텍스트 이미지 BlueStacks + KakaoTalk 안드로이드 에뮬레이터 MessengerBotR 알림 감지 + 응답 ADB Watcher Memento Bridge :<PORT> Storage 이미지 OpenClaw Gateway :<PORT> (VPN) 폴링 N초 Claude AI 텍스트/이미지 분석 응답 반환
텍스트 흐름
이미지 흐름

단계별 데이터 흐름

텍스트 메시지가 카카오톡에서 Claude AI까지 전달되는 과정

이미지가 ADB를 통해 분석되고 결과가 폴링으로 전달되는 과정

1KakaoTalk📱

사용자가 카카오톡 채팅방에서 메시지를 전송합니다.

메시지 수신
2MessengerBotR🤖

알림 감지 후 onMessage 콜백 실행. 메시지와 발신자 정보 추출.

Event.MESSAGE
3Bridge Server🌉

Jsoup HTTP로 브릿지 서버에 POST 요청을 보냅니다.

POST /webhook/memento
4Gateway

세션 키 생성 후 Gateway Chat Completions API 호출.

POST /v1/chat/completions
5Claude AI🧠

메시지 분석 및 응답 생성. 세션별 대화 컨텍스트 유지.

claude-3.5-sonnet
6응답 전송💬

응답이 역순으로 전달되어 카카오톡에 답장.

msg.reply(response)
1KakaoTalk📱

사용자가 카카오톡으로 이미지를 전송합니다.

이미지 메시지
2자동 저장💾

카카오톡 설정에 따라 이미지가 기기에 저장됩니다.

/sdcard/Pictures/KakaoTalk/
3ADB Watcher👁️

Python 스크립트가 주기적으로 새 이미지 감지.

adb shell ls -t
4ADB Pull📥

ADB 명령으로 이미지를 호스트 PC로 다운로드.

adb pull ...
5Bridge🌉

Base64 인코딩 후 브릿지 서버로 전송.

POST /webhook/image
6Storage📁

이미지를 로컬 파일로 저장. Claude가 직접 읽기 가능.

kakao-images/*.jpg
7Gateway

로컬 파일 경로 포함 프롬프트로 분석 요청.

이미지 경로 전달
8Claude Vision🧠

Read 도구로 이미지 분석 및 결과 생성.

멀티모달 분석
9결과 저장💾

분석 결과가 메모리에 저장 (일정 시간 유효).

GET /check-image-result
10응답💬

MessengerBotR이 폴링으로 결과를 가져와 응답.

주기적 폴링

구성요소 상세

📱
BlueStacks + KakaoTalk
안드로이드 에뮬레이터

BlueStacks에서 카카오톡 부계정을 실행합니다. MessengerBotR 앱이 알림을 감지하고 자동 응답합니다.

ADB 주소
127.0.0.1:<PORT>
내부 브릿지
10.0.2.2:<PORT>
이미지 경로
/sdcard/Pictures/KakaoTalk/
필수 설정
ADB 활성화
Settings > Advanced > ADB > Enable
🤖
MessengerBotR
카카오톡 자동응답 앱

카카오톡 알림을 감지하고 JavaScript로 자동 응답합니다. Jsoup 라이브러리로 HTTP 요청을 보냅니다.

브릿지 URL
http://10.0.2.2:<PORT>
HTTP 라이브러리
org.jsoup.Jsoup
타임아웃
30초
최대 메시지
800자
bot.addListener(Event.MESSAGE, onMessage);
🌉
Memento Bridge
Node.js 중계 서버

MessengerBotR과 Gateway 사이를 중계합니다. 세션 관리, 이미지 저장, 명령어 처리를 담당합니다.

포트
<PORT>
파일
memento-bridge.mjs
메시지 엔드포인트
/webhook/memento
이미지 엔드포인트
/webhook/image
node memento-bridge.mjs
👁️
ADB Image Watcher
Python 이미지 모니터

BlueStacks 내 이미지 폴더를 주기적으로 모니터링. 새 이미지 감지 시 로컬로 다운로드 후 브릿지로 전송.

언어
Python 3.8+
체크 간격
N초
파일
adb-image-watcher.py
중복 방지
MD5 해시
python adb-image-watcher.py --auto-port
OpenClaw Gateway
AI 에이전트 게이트웨이

Claude API를 래핑하는 게이트웨이. 세션 관리, 도구 호출, 인증 담당. VPN을 통해 접근.

주소
<VPN_IP>:<PORT>
네트워크
VPN
인증
Bearer Token
설정
openclaw.json
openclaw gateway status
📁
Image Storage
로컬 이미지 저장소

브릿지가 이미지를 로컬 파일로 저장. Claude Code가 Read 도구로 직접 분석 가능.

경로
%USERPROFILE%\...\kakao-images\
파일명
chat-{ts}-{sender}.jpg
HTTP 접근
GET /images/{file}
포맷
JPG, PNG, GIF, WebP
🧠
Claude AI
Anthropic AI 모델

텍스트와 이미지를 분석하고 응답 생성. Gateway의 세션 관리로 대화 컨텍스트 유지.

모델
Claude 3.5 Sonnet
비전
멀티모달 지원
세션
사용자별 컨텍스트
폴백
Gemini Flash

명령어 레퍼런스

명령어를 탭하면 선택됩니다

카카오톡 명령어

봇 실행 확인
브릿지 연결
시스템 상태
세션 초기화
그룹톡 AI

시스템 명령어

브릿지
ADB 감시
Gateway