OpenClaw를 카카오톡 챗봇에 연동하는 방법

openclaw가 이미 설치된 서버에서 카카오톡 챗봇과 연동하는 과정을 정리하였습니다.

– Apache HTTPS 프록시와 Kakao Relay를 이용하였으며
 구성은 다음과 같습니다.

카카오톡 사용자 → 카카오 챗봇 스킬 Webhook → Apache HTTPS 프록시
→ Kakao Relay → OpenClaw Gateway → AI 모델 응답 → 카카오톡 답변

 

 – OpenClaw Gateway가 내부 포트에서 실행 중인지 먼저 확인합니다.

 

• OpenClaw Gateway: 127.0.0.1:18789
• Kakao Relay: 127.0.0.1:8080

– 카카오 챗붓 스킬의 URL은 https로만 통신을 합니다. 테스트 용으로 sslip.io을 이용하여 사용하였습니다.

apache를 설치해준 후 SSL 위한 작업을 준비해줍니다.

• https://YOUR_SERVER_IP.sslip.io/kakao/webhook

– apache 가상호스트 파일을 만듭니다.

– vi /etc/apache2/sites-available/kakao-relay-sslip.conf

– KaKao Relay 만들기

– 카카오 챗붓 스킬과 openwlcaw 사이에 relay 서버를 둡니다.

• 카카오 Webhook 요청 수신
• OpenClaw SSE 세션 연결
• OpenClaw 답변을 카카오 응답 포맷으로 변환

(해당 부분은 일부분만 발췌한 부분이며, 전체적인 코드는 내용이 길어 작성하지 않았습니다.)

– /root/.nvm/versions/node/v24.15.0/bin/node –check /root/kakao-relay-lite/server.js

Relay를 systemd 서비스로 등록

– vi /etc/systemd/system/kakao-relay-lite.service

OpenClaw 설정

– vi /root/.openclaw/openclaw.json

– 모델 provider는 아래처럼 설정합니다.
   실제 API 키는 YOUR_API_KEY 자리에 넣습니다. 

– 카카오 챗봇 관리자 센터 설정

• 카카오 비즈니스센터에서 채널을 만듭니다.
• 카카오 챗봇 관리자센터로 넘어와 스킬을 만듭니다.
• 스킬 -> 스킬 목록 -> 스킬 생성
• 스킬명 : 예)openclaw
• 연동 :  URL: https://YOUR_SERVER_IP.sslip.io/kakao/webhook은 다음과 같이합니다.

* 스킬 상세 화면에서 기본 스킬로 설정을 체크한 뒤 저장합니다.

– 다음 순서는 다음과 같습니다. 

• 시나리오 → 블록 선택 → 봇 응답 → 스킬데이터 사용
• 저장 → 배포 → 운영 배포

 해당 부분들을 설정해줍니다.

 

– 카카오톡 페어링

– journalctl -u kakao-relay-lite -n 80 –no-pager | grep ‘pairing-code’

해당 명령어를 통해 페어링 코드를 알 수 있습니다.

카카오톡 채널 채팅방에서 페어링 코드를 연동이 되면 응답을 해줍니다.

 

– 연동 후 해당 채팅방에 질문시 openclaw와 연동되어 대답을 해줍니다.

– 카카오톡 연동은 테스트나 데모 용도로는 가능하며
  OpenClaw를 메인 AI 에이전트 채널로 운영하기에는 추천하지 않습니다. 
  구성이 복잡하고, 디버깅이 어렵고, 긴 AI 응답이나 도구 실행 흐름과 잘 맞지 않아 사용이 어렵습니다. 
  운영용이라면 Telegram,Slack,Discord 같은 메신저들이 사용 및 관리에 있어 더 안정적으로 보입니다.

 

• 이 글은 본인의 실제 경험과 학습을 기반으로 작성하였으며, AI는 참고용으로만 활용하였습니다.