모드	난이도	특징	추천 대상
🅰️ Basic	⭐	Vercel만 있으면 끝. 빠르고 간단함.	단순 챗봇, Q&A 봇
🅱️ Relay

🟡 KakaoTalk AI 代理 (KakaoTalk Agent)

通过 KakaoTalk 频道与专属 AI 助手对话。
使用 Vercel 无需担心服务器，可免费、永久运行。

支持两种模式。

模式	难度	特点	推荐对象
🅰️ 基础版	⭐	只需 Vercel，快速简单。	简单聊天机器人、问答机器人
🅱️ 中继版

⭐⭐⭐ | 连接本地电脑(OpenClaw)。具备记忆功能。 | 个人助手、工作自动化 |

🚀 通用准备事项

1. Kakao 商务账号：business.kakao.com (开通频道)
Kakao i 开放构建器：i.kakao.com (创建机器人)
Vercel 账号：vercel.com (用于部署)

🅰️ 选项 A：基础模式 (5分钟搞定)

如果 AI 只需进行简单回答，请使用此方法。

1. 部署

在终端中执行以下命令。(需要 Gemini API 密钥)

bash

1. 进入技能文件夹

cd skills/kakaotalk

2. Vercel 部署 (设置环境变量)

请将 GEMINIAPIKEY 替换为自己的密钥。

vercel deploy --prod --env GEMINIAPIKEY=AIzaSy...

部署完成后会显示 https://...vercel.app 地址。
技能 URL：https://[你的地址].vercel.app/kakao

2. 连接开放构建器

1. 注册技能：开放构建器 > 技能 > 添加 > 输入 URL
回退模块：场景 > 回退模块 > 机器人响应 > 选择 使用技能数据
部署：点击右上角 [部署] 按钮

完成！现在可以在 KakaoTalk 频道中对话了。

🅱️ 选项 B：中继模式 (真正的助手)

如果想通过 KakaoTalk 说 读取我电脑上的文件 或 继续刚才的话题，请使用此方法。
Vercel 充当邮箱角色，你的电脑直接回答。

1. 准备 Supabase (邮箱)

1. 创建 Supabase 项目。
在 SQL Editor 中执行以下查询：

sql create table kakaotalk_queue ( id bigint generated by default as identity primary key, userid text not null, utterance text not null, callbackurl text, status text default pending, response text, created_at timestamptz default now() );

2. Vercel 部署 (邮箱管理员)

使用 Supabase 密钥 代替 Gemini 密钥进行部署。

bash

SUPABASEURL、SERVICEKEY 请在你的项目设置 > API 菜单中查看

vercel deploy --prod \
--env SUPABASE_URL=https://... \
--env SUPABASESERVICEKEY=eyJ...

3. 开放构建器设置 (AI 聊天机器人)

1. 设置 > 切换为 AI 聊天机器人 (必须！需要回调功能)
注册技能 URL 并部署 (与基础模式相同)

4. 运行本地监听器 (本体)

在本地电脑上运行以下脚本，即可处理 KakaoTalk 消息。

bash

将 SUPABASEURL、SERVICEKEY 保存到 ~/.openclaw/.env 文件后：

python3 skills/kakaotalk/scripts/watcher.py

现在，只要电脑处于开机状态，KakaoTalk 机器人将拥有与你相同的智能。

🔧 高级设置 (更改角色)

如果想改变机器人的语气或角色，可以在部署时添加环境变量。

bash
vercel deploy --prod \
--env KAKAOTALKSYSTEMPROMPT=你是一只友好的猫咪机器人。每句话结尾都要加上喵。

文件结构

skills/kakaotalk/
├── api/
│ └── index.py # Vercel 服务器 (自动切换基础/中继模式)
├── scripts/
│ └── watcher.py # [中继模式用] 本地处理器
├── vercel.json # Vercel 设置
└── SKILL.md # 说明文档

KakaoTalk AgentKakaoTalk代理

KakaoTalk Agent

🟡 카카오톡 AI 에이전트 (KakaoTalk Agent)

🚀 공통 준비물

🅰️ Option A: Basic 모드 (5분 컷)

1. 배포하기

2. 오픈빌더 연결

🅱️ Option B: Relay 모드 (진짜 비서)

1. Supabase 준비 (우체통)

2. Vercel 배포 (우체통지기)

3. 오픈빌더 설정 (AI 챗봇)

4. 로컬 왓처 실행 (본체)

🔧 고급 설정 (페르소나 변경)

파일 구조

🟡 KakaoTalk AI 代理 (KakaoTalk Agent)

🚀 通用准备事项