{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/kakaotalk",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kakaotalk",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "api/index.py",
      "package.json",
      "references/kakao-api.md",
      "runtime.txt",
      "scripts/install-service.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/kakaotalk",
    "agentPageUrl": "https://openagent3.xyz/skills/kakaotalk/agent",
    "manifestUrl": "https://openagent3.xyz/skills/kakaotalk/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/kakaotalk/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "🟡 카카오톡 AI 에이전트 (KakaoTalk Agent)",
        "body": "카카오톡 채널을 통해 나만의 AI 비서와 대화하세요.\nVercel을 이용해 서버 걱정 없이 무료로, 영구적으로 운영할 수 있습니다.\n\n두 가지 모드를 지원합니다.\n\n모드난이도특징추천 대상🅰️ Basic⭐Vercel만 있으면 끝. 빠르고 간단함.단순 챗봇, Q&A 봇🅱️ Relay⭐⭐⭐내 컴퓨터(OpenClaw)와 연결. 기억력(Memory) 있음.개인 비서, 업무 자동화"
      },
      {
        "title": "🚀 공통 준비물",
        "body": "카카오 비즈니스 계정: business.kakao.com (채널 개설)\n카카오 i 오픈빌더: i.kakao.com (봇 생성)\nVercel 계정: vercel.com (배포용)"
      },
      {
        "title": "🅰️ Option A: Basic 모드 (5분 컷)",
        "body": "AI가 단순한 대답만 하면 된다면 이 방법을 쓰세요."
      },
      {
        "title": "1. 배포하기",
        "body": "터미널에서 아래 명령어를 실행하세요. (Gemini API 키 필요)\n\n# 1. 스킬 폴더로 이동\ncd skills/kakaotalk\n\n# 2. Vercel 배포 (환경변수 설정)\n# GEMINI_API_KEY는 본인 키로 변경하세요.\nvercel deploy --prod --env GEMINI_API_KEY=AIzaSy...\n\n배포가 끝나면 https://...vercel.app 주소가 나옵니다.\n스킬 URL: https://[당신의주소].vercel.app/kakao"
      },
      {
        "title": "2. 오픈빌더 연결",
        "body": "스킬 등록: 오픈빌더 > 스킬 > 추가 > URL 입력\n폴백 블록: 시나리오 > 폴백 블록 > 봇 응답 > 스킬데이터 사용 선택\n배포: 우측 상단 [배포] 버튼 클릭\n\n끝! 이제 카톡 채널에서 대화해보세요."
      },
      {
        "title": "🅱️ Option B: Relay 모드 (진짜 비서)",
        "body": "카카오톡으로 \"내 컴퓨터에 있는 파일 읽어줘\" 하거나 \"아까 그 얘기 계속해\" 라고 하려면 이 방법을 쓰세요.\nVercel이 우체통 역할을 하고, 당신의 컴퓨터가 직접 대답합니다."
      },
      {
        "title": "1. Supabase 준비 (우체통)",
        "body": "Supabase 프로젝트 생성.\nSQL Editor에서 아래 쿼리 실행:\ncreate table kakaotalk_queue (\n  id bigint generated by default as identity primary key,\n  user_id text not null, utterance text not null, callback_url text,\n  status text default 'pending', response text, created_at timestamptz default now()\n);"
      },
      {
        "title": "2. Vercel 배포 (우체통지기)",
        "body": "Gemini 키 대신 Supabase 키를 넣어서 배포합니다.\n\n# SUPABASE_URL, SERVICE_KEY는 본인 프로젝트 설정 > API 메뉴에서 확인\nvercel deploy --prod \\\n  --env SUPABASE_URL=https://... \\\n  --env SUPABASE_SERVICE_KEY=eyJ..."
      },
      {
        "title": "3. 오픈빌더 설정 (AI 챗봇)",
        "body": "설정 > AI 챗봇으로 전환 (필수! 콜백 기능을 위해 필요)\n스킬 URL 등록 및 배포 (Basic 모드와 동일)"
      },
      {
        "title": "4. 로컬 왓처 실행 (본체)",
        "body": "내 컴퓨터에서 아래 스크립트를 실행해두면, 카톡 메시지를 처리합니다.\n\n# ~/.openclaw/.env 파일에 SUPABASE_URL, SERVICE_KEY 저장 후:\npython3 skills/kakaotalk/scripts/watcher.py\n\n이제 컴퓨터가 켜져 있는 동안, 카톡 봇은 당신과 똑같은 지능을 갖게 됩니다."
      },
      {
        "title": "🔧 고급 설정 (페르소나 변경)",
        "body": "봇의 말투나 역할을 바꾸고 싶다면, 배포할 때 환경변수를 추가하세요.\n\nvercel deploy --prod \\\n  --env KAKAOTALK_SYSTEM_PROMPT=\"너는 친절한 고양이 로봇이야. 말 끝마다 '냥'을 붙여.\""
      },
      {
        "title": "파일 구조",
        "body": "skills/kakaotalk/\n├── api/\n│   └── index.py      # Vercel 서버 (Basic/Relay 모드 자동 전환)\n├── scripts/\n│   └── watcher.py    # [Relay 모드용] 로컬 처리기\n├── vercel.json       # Vercel 설정\n└── SKILL.md          # 설명서"
      }
    ],
    "body": "🟡 카카오톡 AI 에이전트 (KakaoTalk Agent)\n\n카카오톡 채널을 통해 나만의 AI 비서와 대화하세요.\nVercel을 이용해 서버 걱정 없이 무료로, 영구적으로 운영할 수 있습니다.\n\n두 가지 모드를 지원합니다.\n\n모드\t난이도\t특징\t추천 대상\n🅰️ Basic\t⭐\tVercel만 있으면 끝. 빠르고 간단함.\t단순 챗봇, Q&A 봇\n🅱️ Relay\t⭐⭐⭐\t내 컴퓨터(OpenClaw)와 연결. 기억력(Memory) 있음.\t개인 비서, 업무 자동화\n🚀 공통 준비물\n카카오 비즈니스 계정: business.kakao.com (채널 개설)\n카카오 i 오픈빌더: i.kakao.com (봇 생성)\nVercel 계정: vercel.com (배포용)\n🅰️ Option A: Basic 모드 (5분 컷)\n\nAI가 단순한 대답만 하면 된다면 이 방법을 쓰세요.\n\n1. 배포하기\n\n터미널에서 아래 명령어를 실행하세요. (Gemini API 키 필요)\n\n# 1. 스킬 폴더로 이동\ncd skills/kakaotalk\n\n# 2. Vercel 배포 (환경변수 설정)\n# GEMINI_API_KEY는 본인 키로 변경하세요.\nvercel deploy --prod --env GEMINI_API_KEY=AIzaSy...\n\n\n배포가 끝나면 https://...vercel.app 주소가 나옵니다.\n스킬 URL: https://[당신의주소].vercel.app/kakao\n\n2. 오픈빌더 연결\n스킬 등록: 오픈빌더 > 스킬 > 추가 > URL 입력\n폴백 블록: 시나리오 > 폴백 블록 > 봇 응답 > 스킬데이터 사용 선택\n배포: 우측 상단 [배포] 버튼 클릭\n\n끝! 이제 카톡 채널에서 대화해보세요.\n\n🅱️ Option B: Relay 모드 (진짜 비서)\n\n카카오톡으로 \"내 컴퓨터에 있는 파일 읽어줘\" 하거나 \"아까 그 얘기 계속해\" 라고 하려면 이 방법을 쓰세요.\nVercel이 우체통 역할을 하고, 당신의 컴퓨터가 직접 대답합니다.\n\n1. Supabase 준비 (우체통)\nSupabase 프로젝트 생성.\nSQL Editor에서 아래 쿼리 실행:\ncreate table kakaotalk_queue (\n  id bigint generated by default as identity primary key,\n  user_id text not null, utterance text not null, callback_url text,\n  status text default 'pending', response text, created_at timestamptz default now()\n);\n\n2. Vercel 배포 (우체통지기)\n\nGemini 키 대신 Supabase 키를 넣어서 배포합니다.\n\n# SUPABASE_URL, SERVICE_KEY는 본인 프로젝트 설정 > API 메뉴에서 확인\nvercel deploy --prod \\\n  --env SUPABASE_URL=https://... \\\n  --env SUPABASE_SERVICE_KEY=eyJ...\n\n3. 오픈빌더 설정 (AI 챗봇)\n설정 > AI 챗봇으로 전환 (필수! 콜백 기능을 위해 필요)\n스킬 URL 등록 및 배포 (Basic 모드와 동일)\n4. 로컬 왓처 실행 (본체)\n\n내 컴퓨터에서 아래 스크립트를 실행해두면, 카톡 메시지를 처리합니다.\n\n# ~/.openclaw/.env 파일에 SUPABASE_URL, SERVICE_KEY 저장 후:\npython3 skills/kakaotalk/scripts/watcher.py\n\n\n이제 컴퓨터가 켜져 있는 동안, 카톡 봇은 당신과 똑같은 지능을 갖게 됩니다.\n\n🔧 고급 설정 (페르소나 변경)\n\n봇의 말투나 역할을 바꾸고 싶다면, 배포할 때 환경변수를 추가하세요.\n\nvercel deploy --prod \\\n  --env KAKAOTALK_SYSTEM_PROMPT=\"너는 친절한 고양이 로봇이야. 말 끝마다 '냥'을 붙여.\"\n\n파일 구조\nskills/kakaotalk/\n├── api/\n│   └── index.py      # Vercel 서버 (Basic/Relay 모드 자동 전환)\n├── scripts/\n│   └── watcher.py    # [Relay 모드용] 로컬 처리기\n├── vercel.json       # Vercel 설정\n└── SKILL.md          # 설명서"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/lifeissea/kakaotalk",
    "publisherUrl": "https://clawhub.ai/lifeissea/kakaotalk",
    "owner": "lifeissea",
    "version": "1.2.8",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}