# Send Kakaotalk to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "kakaotalk",
    "name": "Kakaotalk",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/lifeissea/kakaotalk",
    "canonicalUrl": "https://clawhub.ai/lifeissea/kakaotalk",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/kakaotalk",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kakaotalk",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "api/index.py",
      "package.json",
      "references/kakao-api.md",
      "runtime.txt",
      "scripts/install-service.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "kakaotalk",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T09:06:31.936Z",
      "expiresAt": "2026-05-07T09:06:31.936Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kakaotalk",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kakaotalk",
        "contentDisposition": "attachment; filename=\"kakaotalk-1.2.8.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "kakaotalk"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/kakaotalk"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/kakaotalk",
    "downloadUrl": "https://openagent3.xyz/downloads/kakaotalk",
    "agentUrl": "https://openagent3.xyz/skills/kakaotalk/agent",
    "manifestUrl": "https://openagent3.xyz/skills/kakaotalk/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/kakaotalk/agent.md"
  }
}
```
## Documentation

### 🟡 카카오톡 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          # 설명서
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: lifeissea
- Version: 1.2.8
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T09:06:31.936Z
- Expires at: 2026-05-07T09:06:31.936Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/kakaotalk)
- [Send to Agent page](https://openagent3.xyz/skills/kakaotalk/agent)
- [JSON manifest](https://openagent3.xyz/skills/kakaotalk/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/kakaotalk/agent.md)
- [Download page](https://openagent3.xyz/downloads/kakaotalk)