애플 유저의 안드로이드 카카오톡 봇 개발기: 혼자였다면 포기했을 도전

소개

저는 아이폰 출시 이후 계속 아이폰만 사용해와서 안드로이드 폰 사용이 어렵고 낯선데요. 첫 주에는 회사 업무용으로 갖고 있는 서브폰을 무선으로 연결하고 카카오톡 봇 만들기를 시도해보았습니다. 분명 ‘초급’ 스터디인데 저는 왜 이리 어려운지… 😭

첫 주 모각에서 스터디장 현우님의 조근조근 친절한 설명과 주변 스터디원 분들의 도움으로 드디어 성공! 하였고, 오프라인 모각이 없었다면 불가능했을것 같아요.

이번 글에서는 진행 과정에서 제가 겪었던 이슈와 제가 어떻게 해결했는지 경험을 공유해보려고 합니다. 기억을 더듬어 적어본 내용이라 잘못된 정보가 있을 수 있으니, 발견하시면 댓글로 코멘트 부탁 드립니다.

목표: PC와 안드로이드 폰 무선으로 연결하기

  • PC: Windows 환경

  • 폰: 삼성 Z폴드

  • 연결 방식: ADB를 이용한 무선 연결

진행 방법

  1. 프로젝트 폴더 만들기 (최상위 폴더 명은 자유, Bots, PerBot 은 대소문자 주의)

    • Bots_project > Bots > PerBot

  2. 휴대폰 ‘메신저봇’ 앱에 PerBot 생성 (대소문자 주의)

    Perbot Korean 키보드 - 스크린 샷
  3. PC와 휴대폰 모두 같은 네트웍(wifi)에 접속

  4. 휴대폰의 IP주소 확인 (삼성Z폴드)

    • 설정 → 연결 → Wi-Fi → ⚙️ 설정 아이콘 → 더보기 → IP주소

  5. 휴대폰의 IP주소를 클로드 코드에게 알려주고 연결하라고 지시

  6. 1차 고비 : “연결 거부” 에러가 반복됨 → 클로드 데스크탑에 물어봄

    • 클로드의 가이드 : 개발자 옵션 활성화 → USB 디버깅 활성화

    • 무선 연결도 가능하지만 초보자에게는 USB 연결 추천!

  7. 2차 고비 : USB 케이블 없음

    • 클로드의 가이드 : 무선 디버깅 시도

      • 개발자 모드 활성화 : 빌드번호 7번 터치

      • 무선 디버깅 활성화
        (설정 → 개발자 옵션 → 무선 디버깅 ON → 경고 메시지 허용)

      • 페어링하기 : 페어링 코드로 기기 페어링

      '실제 폰'으로 연결해줘. IP주소:포트번호
      ---
      IP 주소와 포트 (예: 192.168.1.100:12345)
      페이링코드 (6자리 숫자)
      ---
      같은 Wi-Fi 네트워크에 폰과 컴퓨터가 연결되어 있어야 함
      Android11 이상에서만 지원
      페어링 코드는 시간 제한이 있어 빨리 입력해야 함
  8. 3차 고비 : 드디어 연결 성공, 그러나 계속 작동이 안되고 에러 메시지

    • 여기서 정말 한참 원인을 못 찾고 헤맴

    • 페어링 후 화면에서 기기 IP 주소와 포트를 다시 한번 전달

      IP 주소와 포트 (예: 192.168.1.100:12345)
      ---
      페어링 시 입력한 IP 주소, 포트 정보와 페어링 후 정보는 다름
  9. 클로드 데스크탑에게 지금까지의 설정 과정을 아티팩트 문서로 만들어달라고 지시

  10. 현우님이 배포해주신 Javascript code를 휴대폰의 메신저봇 앱으로 전송

    봇 코드가 로컬 @Bots/PerBot/PerBot.js 에 있는지 위치를 확인해줘.
    ---
    이 코드를 AVD에 배포해줘. 컴파일은 내가 메신저봇에서 메뉴를 통해 직접할게. 배포만 해줘.
    Perbot C ++ - 스크린 샷
  11. 마지막 고비 : 제작한 봇을 어떻게 추가해서 사용하지? (스터디장님, 모각 참여 멤버분들의 도움으로 성공!)

    • 일반폰에서 오픈채팅방 생성 → JS 파일의 TARGET_ROOMS 에서 지정한 방 이름과 동일해야 함

    • 오픈채팅방 링크를 봇폰의 카톡으로 보내서 입장하도록 함

    • 봇폰의 화면을 꺼두어야 동작함 (카톡 알림을 트리거로 메신저봇이 응답해주는 방식)

    전화 화면의 한국 문자 메시지

성공은 했지만 아직 어려운… 프로필 설정

  • 카톡의 멀티프로필, 오픈프로필과 봇 매칭은 수동

    • 봇은 TARGET_ROOMS 기준으로 동작

    • 카톡에서 TARGET_ROOMS에 어떤 프로필을 설정할지 선택

소감

지피터스는 도전할 용기를 주는 공간인 것 같습니다. 지식과 열정을 아낌없이 나눠주시는 스터디장님들과 멤버들끼리 서로 돕고 격려하는 분위기가 기적을 만들어내는 느낌입니다.

참여한지 이제 겨우 2번째 텀이지만,세상을 보는 관점이 달라지는 것을 느끼고 있습니다. 남은 기간 놓치지 않고 잘 따라가보겠습니다.

도움 받은 글

  • 현우님의 카톡봇 OT 실습준비 자료

  • 현우님의 18기 카톡봇 OT 자료 - 진짜 꼼꼼하게 Step by step으로 잘 정리해주셨어요. 무작정 따라하시면 됩니다. 👍😆

  • 모각때 스탠딩 테이블에 같이 계셨던 17기 선배님들

2개의 답글

뉴스레터 무료 구독

👉 이 게시글도 읽어보세요