- name
- KakaoTalk Agent
- version
- 1.2.7
- description
- 카카오톡 채널을 AI 에이전트로 만드는 스킬. Vercel Serverless 배포 지원. (옵션: 로컬 컴퓨터와 연결하여 파일/메모리 접근 가능)
- author
- Yeomyeonggeori Inc. <iam@dawn.kim>
- license
- MIT
- metadata
- openclaw
- env
- description
- [Basic 모드] Gemini API 키
- required
- false
- description
- [Relay 모드] Supabase 프로젝트 URL
- required
- false
- description
- [Relay 모드] Supabase Service Role Key
- required
- false
- requires
- bins
- ["vercel", "python3"]
🟡 카카오톡 AI 에이전트 (KakaoTalk Agent)
카카오톡 채널을 통해 나만의 AI 비서와 대화하세요. Vercel을 이용해 서버 걱정 없이 무료로, 영구적으로 운영할 수 있습니다.
두 가지 모드를 지원합니다.
| 모드 | 난이도 | 특징 | 추천 대상 |
|---|---|---|---|
| 🅰️ Basic | ⭐ | Vercel만 있으면 끝. 빠르고 간단함. | 단순 챗봇, Q&A 봇 |
| 🅱️ Relay | ⭐⭐⭐ | 내 컴퓨터(OpenClaw)와 연결. 기억력(Memory) 있음. | 개인 비서, 업무 자동화 |
🚀 공통 준비물
- 카카오 비즈니스 계정: business.kakao.com (채널 개설)
- 카카오 i 오픈빌더: i.kakao.com (봇 생성)
- Vercel 계정: vercel.com (배포용)
🅰️ Option A: Basic 모드 (5분 컷)
AI가 단순한 대답만 하면 된다면 이 방법을 쓰세요.
1. 배포하기
터미널에서 아래 명령어를 실행하세요. (Gemini API 키 필요)
# 1. 스킬 폴더로 이동
cd skills/kakaotalk
# 2. Vercel 배포 (환경변수 설정)
# GEMINI_API_KEY는 본인 키로 변경하세요.
vercel deploy --prod --env GEMINI_API_KEY=AIzaSy...배포가 끝나면 https://...vercel.app 주소가 나옵니다. 스킬 URL: https://[당신의주소].vercel.app/kakao
2. 오픈빌더 연결
- 스킬 등록: 오픈빌더 > 스킬 > 추가 > URL 입력
- 폴백 블록: 시나리오 > 폴백 블록 > 봇 응답 > 스킬데이터 사용 선택
- 배포: 우측 상단 [배포] 버튼 클릭
끝! 이제 카톡 채널에서 대화해보세요.
🅱️ Option B: Relay 모드 (진짜 비서)
카카오톡으로 "내 컴퓨터에 있는 파일 읽어줘" 하거나 "아까 그 얘기 계속해" 라고 하려면 이 방법을 쓰세요. Vercel이 우체통 역할을 하고, 당신의 컴퓨터가 직접 대답합니다.
1. Supabase 준비 (우체통)
- Supabase 프로젝트 생성.
- SQL Editor에서 아래 쿼리 실행:
create table kakaotalk_queue (
id bigint generated by default as identity primary key,
user_id text not null, utterance text not null, callback_url text,
status text default 'pending', response text, created_at timestamptz default now()
);2. Vercel 배포 (우체통지기)
Gemini 키 대신 Supabase 키를 넣어서 배포합니다.
# SUPABASE_URL, SERVICE_KEY는 본인 프로젝트 설정 > API 메뉴에서 확인
vercel deploy --prod \
--env SUPABASE_URL=https://... \
--env SUPABASE_SERVICE_KEY=eyJ...3. 오픈빌더 설정 (AI 챗봇)
- 설정 > AI 챗봇으로 전환 (필수! 콜백 기능을 위해 필요)
- 스킬 URL 등록 및 배포 (Basic 모드와 동일)
4. 로컬 왓처 실행 (본체)
내 컴퓨터에서 아래 스크립트를 실행해두면, 카톡 메시지를 처리합니다.
# ~/.openclaw/.env 파일에 SUPABASE_URL, SERVICE_KEY 저장 후:
python3 skills/kakaotalk/scripts/watcher.py이제 컴퓨터가 켜져 있는 동안, 카톡 봇은 당신과 똑같은 지능을 갖게 됩니다.
🔧 고급 설정 (페르소나 변경)
봇의 말투나 역할을 바꾸고 싶다면, 배포할 때 환경변수를 추가하세요.
vercel deploy --prod \
--env KAKAOTALK_SYSTEM_PROMPT="너는 친절한 고양이 로봇이야. 말 끝마다 '냥'을 붙여."파일 구조
skills/kakaotalk/
├── api/
│ └── index.py # Vercel 서버 (Basic/Relay 모드 자동 전환)
├── scripts/
│ └── watcher.py # [Relay 모드용] 로컬 처리기
├── vercel.json # Vercel 설정
└── SKILL.md # 설명서