카페24 쇼핑몰을 에이전트와 연동하기
💡 요약 정리
- 카페24 에이전트 호스팅(OpenClaw / Hermes)를 이용 중인 쇼핑몰 사장님을 위한 안내서입니다.
- 코딩·터미널·서버 지식이 전혀 없어도 됩니다.
- 스킬 팩 ZIP을 에이전트에게 올리고 "카페24 쇼핑몰 연결해줘" 한 마디면 연동이 시작됩니다.
- 연동 후에는 매출 브리핑, 주문·배송 조회, 재고 확인을 말 걸듯 요청할 수 있습니다.
시작 전에 — 이 두 가지 설정이 먼저입니다
이 가이드는 에이전트가 켜져 있고, 두뇌(LLM)가 연결된 상태에서 시작합니다. 아직이라면 아래 공식 문서를 순서대로 먼저 진행해 주세요.
| 순서 | 할 일 | OpenClaw VPS | Hermes Agent VPS |
|---|---|---|---|
| ① | VPS 초기 설정 — 에이전트 켜기 | 초기 설정 가이드 | 초기 설정 가이드 |
| ② | LLM Router 연동 — 에이전트에 두뇌 연결 | 연동 가이드 | 연동 가이드 |
💡 팁: ②를 진행하기 전에 LLM Router 가입부터 하세요. 가입하면 무료 크레딧이 지급되는데, 그 계정으로 연동을 마치고 이 가이드를 따라오면 — 스킬 설치부터 쇼핑몰 연결, 첫 아침 브리핑까지 무료 크레딧만으로 전부 체험할 수 있습니다.
①②가 끝났다면 준비 완료입니다. 이제 이 문서만 따라오시면 됩니다.
전체 과정은 딱 세 동작입니다:① 링크에서 스킬 팩 ZIP 다운로드
② 대시보드 또는 텔레그램 대화방에 ZIP을 그대로 올리고 "스킬 설치해줘"
③ "카페24 쇼핑몰 연결해줘"
────────────────────────────────
이후는 에이전트가 단계별로 안내합니다. 따라가기만 하세요.
0. 시작 전 준비 확인 (2분)
딱 3가지만 확인하면 됩니다. 가입 후 초기 설정(온보딩)을 마치셨다면 ①②는 이미 완료된 상태입니다.
① 에이전트 설정을 마쳤나요?
OpenClaw / Hermes Agent 초기 설정과 LLM Router 연동을 마쳤다면 에이전 트가 이미 켜져 있는 상태입니다. 아직이라면 각 상품의 초기 설정 가이드(OpenClaw / Hermes)를 먼저 진행해 주세요.
② 에이전트와 대화할 수 있나요?
- 텔레그램: 초기 설정 때 직접 만든 봇(예:
@my_agent_bot)의 대화방을 엽니다. 봇 이름이 기억나지 않으면 텔레그램에서 @봇이름으로 검색하면 됩니다. 대화방에서 "안녕"이라고 보내봅니다. 몇 초 안에 답장이 오면 준비 완료입니다. - 대시보드 채팅 (OpenClaw): 대시보드의 채팅 화면에서 "안녕"을 보내도 됩니다. 텔레그램과 완전히 같은 에이전트입니다.
- 텔레그램 대화방 하단에 [시작(START)] 버튼이 보이면 먼저 누르세요.
- 그래도 안 오면 초기 설정(특히 메신저 연결·페어링)이 정상 완료됐는지 다시 확인하고, 문제가 계속되면 고객센터로 문의해 주세요.
③ 스킬 팩 ZIP 파일을 다운로드했나요?
스킬 팩은 다운로드 링크로 제공됩니다 (가입 완료 안내 및 관리 대시보드의 [스킬 팩 다운로드]에서 받을 수 있습니다). 팩은 2가지입니다.
| 팩 | 파일 | 구성 | 언제 받나 |
|---|---|---|---|
| 기본 팩 ⭐ 먼저 이것부터 | cafe24-skill-pack-basic.zip 다운로드 | 스킬 4종 (연결·엔진·비서실장·아침 보고) | 모든 고객이 처음에 설치 |
| 확장 팩 | cafe24-skill-pack-full.zip 다운로드 | 스킬 5종 (기본 4종 포함 + 운영 담당) | 보고만 받다가 실제 업무까지 맡기고 싶어질 때 |
⭐ 처음에는 반드시 "기본 팩"부터 설치하세요. 기본 팩이 가장 안전하고 빠르게 시작하는 방법입니다 — 조회·보고만 하므로 쇼핑몰에 아무 변경도 가하지 않고, 설치·연결도 몇 분이면 끝납니다. 확장 팩은 나중에 언제든 추가할 수 있습니다.
다운로드한 ZIP은 에이전트와 대화하는 그 기기(휴대폰 또는 PC)에 저장돼 있어야 합니다. 휴대폰은 보통 "다운로드" 폴더에 저장됩니다.
⚠️ ZIP 파일의 압축을 풀지 마세요. 받은 그대로 두면 됩니다. 압축 해제는 에이전트가 합니다.
1. 스킬 팩이 뭔가요?
스킬 팩은 에이전트에게 "카페24 쇼핑몰 관리 업 무"를 가르치는 업무 매뉴얼 세트입니다. 설치하면 에이전트가 사장님의 쇼핑몰 비서팀이 됩니다.
기본 팩 4종 — 연결하고, 보고받는다
| 스킬 | 역할 (비유) | 하는 일 |
|---|---|---|
cafe24-mall-connect | 🔑 열쇠 담당 | 내 쇼핑몰을 에이전트에 연결 (최초 1회) |
cafe24-mall-api | ⚙️ 실무 엔진 | 카페24와 통신하는 정확한 방법 (다른 스킬들이 사용) |
cafe24-mall-pm | 👔 비서실장 | 우리 가게와 사장님 취향을 기억하고, 요청을 담당 비서에게 배분 |
cafe24-daily-briefing | 📋 아침 보고 | "오늘 장사 어땠어?" — 매출·주문·문의·품절 요약 보고 |
확장 팩 +1종 — 실제 업무를 맡긴다 (기본 4종 포함 총 5종)
| 스킬 | 역할 (비유) | 하는 일 |
|---|---|---|
cafe24-mall-ops | 🛠️ 운영 담당 | 주문·배송·클레임 처리 + 상품·재고·가격 관리 + 문의·답변 등록까지 실무 전담 |
💡 확장 팩 ZIP에는 기본 팩 4종이 이미 들어 있습니다. 나중에 확장할 때 확장 팩 하나만 올리면 되고, 이미 설치된 기본 스킬 위에 덮어써도 안전합니다.
2. 설치하기 — ZIP을 그대로 올리면 끝납니다 (5분)
다운로드한 ZIP 파일을 압축을 풀지 말고, 그대로 에이전트에게 올리는 것이 설치의 전부입니다. 올리는 곳은 둘 중 편한 쪽을 고르면 됩니다 — 결과는 같습니다.
| 올리는 곳 | 이런 분께 |
|---|---|
| 관리 대시보드 채팅 (OpenClaw) | PC로 다운로드 받았다 → 브라우저에서 바로 끌어다 놓기가 제일 빠릅니다 |
| 텔레그램 대화방 | 휴대폰으로 받았다 / 평소 텔레그램으로 대화한다 |
2-1. 파일 올리기 — 경로별 단계
🖥️ 관리 대시보드 채팅에서 (OpenClaw):- 대시보드의 채팅 화면을 엽니다.
- 다운로드한
cafe24-skill-pack-basic.zip을 채팅창으로 끌어다 놓습니다(드래그). (또는 첨부 버튼 → 파일 선택) - 아래 문장을 함께 보냅니다.
- 내 에이전트 봇 대화방을 엽니다.
- 메시지 입력창 옆의 클립 📎 버튼을 누릅니다.
- [파일]을 선택합니다. — ⚠️ [갤러리/사진]이 아니라 반드시 [ 파일]입니다.
- "다운로드" 폴더에서
cafe24-skill-pack-basic.zip을 선택합니다.- 안 보이면 파일 선택 화면에서 [찾아보기] → [다운로드]를 열어보세요.
- 보내기 전 캡션(파일 아래 글 쓰는 칸)에 아래 문장을 붙여넣고 전송합니다.
- 내 에이전트 봇 대화방을 엽니다.
- ZIP 파일을 대화창으로 끌어다 놓거나(드래그), 클립 📎 버튼 → 파일 선택으로 첨부합니다.
- 캡션 입력칸에 아래 문장을 붙여넣고 [보내기]를 누릅니다.
카페24 스킬 팩이야. ZIP 안의 INSTALL.md 지침대로 설치해줘.
💡 설치 방법·순서·주의사항은 전부 ZIP 안의 INSTALL.md에 들어 있어서, 에이전트가 그걸 읽고 알아서 정확하게 설치합니다. 문장 없이 파일만 먼저 보냈다면, 다음 메시지로 위 문장을 보내면 됩니다.
2-2. 설치되는 동안 — 이런 대화가 오갑니다
파일을 보내면 에이전트가 잠깐(수 초 ~ 수십 초) 작업한 뒤 대략 이렇게 답합니다.
👤 사장님: (ZIP 파일 첨부 + 문장)
🤖 에이전트: 파일을 받았습니다. 압축을 풀어 스킬을 설치하겠습니다.
🤖 에이전트: 설치가 완료되었습니다. 설치된 스킬 4개:
1. cafe24-mall-connect (쇼핑몰 연결)
2. cafe24-mall-api (실무 엔진)
3. cafe24-mall-pm (비서실장)
4. cafe24-daily-briefing (아침 보고)
이 제 "카페24 쇼핑몰 연결해줘"라고 말씀하시면 시작할 수 있습니다.
(문구는 조금씩 다를 수 있습니다. 기본 팩은 4개, 확장 팩은 5개 설치가 확인되면 성공입니다.)
2-3. 설치 확인
에이전트의 답장만으로 애매하면 아래 문장을 보내보세요.
지금 설치된 스킬 목록 보여줘. cafe24로 시작하는 게 4개 있어야 해.
(확장 팩을 설치했다면 "5개 있어야 해"로 바꿔 보내세요.) 개수가 모자라면 이렇게 보내면 됩니다.
개수가 안 맞네. 아까 보낸 ZIP 파일로 빠진 스킬을 다시 설치해줘.
2-4. 이것만은 하지 마세요 (흔한 실수)
| ❌ 하지 마세요 | ✅ 대신 이렇게 |
|---|---|
| ZIP 압축을 미리 풀어서 파일을 따로따로 올리기 | ZIP 그대로 1개만 올리기 — 폴더 구조가 유지되어야 설치가 정확합니다 |
| 스킬 문서 내용을 채팅창에 복사-붙여넣기 | 텔레그램은 글자 수 제한(4,096자)으로 긴 문서가 잘립니다. 항상 ZIP 파일로 올리세요 |
| 텔레그램에서 [사진/갤러리]로 파일 전송 | 반드시 [파일]로 전송 — 사진으로 보내면 에이전트가 내용물을 읽지 못합니다 |
| 설치가 몇 분째 안 끝나는데 기다리기 | 에이전트가 파일을 새로 만들고 있는 것입니다. 이렇게 보내세요: "멈춰. ZIP 안의 INSTALL.md 지침대로 압축 해제만 해서 설치해." |
3. 쇼핑몰 연결하기 — 이 한 마디면 가이드는 끝입니다
설치가 끝났으면 이렇게 보내세요.
카페24 쇼핑몰 연결해줘.
여기까지가 이 가이드에서 외울 전부입니다. 이후는 연결 스킬이 온보딩을 알아서 진행합니다 — 매 답장 첫 줄에 [2/4단계]처럼 진행 상황이 표시되고, 필요한 것을 한 번에 하나씩 물어보며, 어려운 용어는 풀어서 설명해줍니다. 사장님은 대화를 따라가기만 하면 됩니다.
전체 여정은 4단계입니다.
① 카페24 앱 준비 → ② 앱 정보 입력 → ③ 승인하기(링크 클릭) → ④ 연결 확인
미리 준비해두면 빠른 것 (에이전트가 물어보는 것들)
없어도 됩니다 — 없다고 하면 에이전트가 찾는 방법부터 알려줍니다. 다만 미리 준비하면 3분 만에 끝납니다.
| 준비물 | 찾는 곳 |
|---|---|
| 쇼핑몰 ID | 관리자 주소 https://여기.cafe24.com의 "여기" 부분 |
| 앱 아이디 / 앱 비밀키 | developers.cafe24.com → 내 앱 → "인증 정보" 화면 |
| 승인 후 돌아올 주소 (Redirect URI) | 앱 설정에 등록한 주소 그대로 (카페24 안내 공통 콜백 페이지 사용 권장) |
권한 패키지 — 어디까지 맡길지 정하기
연결 중에 에이전트가 물어보는 권한 수준은 아래와 같습니다. 기본 팩만 쓴다면 '소'로 충분합니다.
| 패키지 | 에이전트가 할 수 있는 일 | 어울리는 팩 |
|---|---|---|
| 소 (조회만) | 매출 브리핑, 주문·배송 조회, 재고·품절 확인 | 기본 팩 |
| 중 (조회+처리) | 위 전부 + 송장 등록·주문 처리, 가격·재고 수정, 문의 답변 등록 | 확장 팩 |
🔒 어떤 권한이든 주문 처리·가격 변경·답변 등록처럼 무언가를 바꾸는 작업은, 에이전트가 "이렇게 바뀝니다"를 먼저 보여주고 사장님이 승인해야만 실행됩니다. 조회는 바로바로 해줍니다.
4. 연결 직후 해두면 좋은 것 (권장, 3분)
① 가게 소개하기 — 에이전트가 가게 특성을 파악해 몰 프로필(가게 수첩)을 만듭니다. 이후 모든 보고가 우리 가게에 맞춰집니다.
연결 끝났어. 우리 가게 파 악해서 프로필 만들어줘.
그리고 나는 보고는 짧게 핵심만, 존댓말로 받는 걸 좋아해.
② 아침 브리핑 예약 — 한 번만 설정하면 매일 아침 텔레그램으로 보고가 옵니다.
매일 아침 9시에 데일리 브리핑 보내줘.
취향과 시간은 언제든 말로 바꿀 수 있습니다: "앞으로 표로 상세하게 보여줘", "브리핑 8시로 바꿔줘", "주말엔 브리핑 쉬어".
5. 일상 사용 — 이렇게 말을 걸면 됩니다
이제부터는 그냥 말하듯 물어보면 됩니다. 아래는 복사해서 바로 쓸 수 있는 예시입니다.
📋 매출·현황 — 기본 팩
오늘 장사 어땠어?
어제 매출 어때? 지난주 같은 요일이랑 비교해줘.
이번 주 브리핑해줘.
📦 주문·배송 — 확장 팩
어제 주문 보여줘.
입금 안 된 주문 있어?
배송 중인 주문 몇 건이야?
주문번호 20260702-0000123 자세히 보여줘.
이 주문 어디까지 갔어? 송장 번호 알려줘.
취소 신청 들어온 거 있어?
처리 요청('중' 권한) — 에이전트가 변경 내용을 먼저 보여주고 확인을 받습니다.
주문번호 XXXX에 송장 등록해줘. 택배사는 CJ대한통운, 송장번호는 1234567890.
🏷️ 상품·재고 — 확장 팩
품절된 상품 뭐 있어?
재고 10개 이하로 남은 거 알려줘.
"딸기잼" 상품 재고 얼마나 남았어?
진열 안 된 상품 목록 보여줘.
수정 요청('중' 권한) — 변경 전/후 표를 보여주고 확인 후 실행합니다.
"딸기잼 500g" 가격을 12,900원으로 바꿔줘.
"수제쿠키 세트" 품절 처리하고 진열 내려줘.
💬 문의·리뷰 — 확장 팩 ('중' 권한 필요)
안 읽은 문의 있어?
이번 주 리뷰 보여줘.
1번 문의에 답변 초안 써줘.
답변은 초안을 먼저 보여주고, 사장님이 "올려"라고 해야만 실제 게시판에 등록됩니다.
👔 뭘 시켜야 할지 모르겠을 때 — 기본 팩
네가 우리 가게에서 해줄 수 있는 일 알려줘.
요즘 우리 가게에서 신경 써야 할 것 있어?
6. 확장 팩으로 업그레이드하기
기본 팩으로 보고를 받다가 주문 처리·상품 관리·문의 답변까지 맡기고 싶어지면, 두 가지만 하면 됩니다.
① 확장 팩 설치 — 확장 팩 다운로드 링크에서 cafe24-skill-pack-full.zip을 받아, 2장과 완전히 같은 방법으로 올립니다. 기본 팩이 이미 설치돼 있어도 괜찮습니다 — 확장 팩에 기본 4종이 포함돼 있고, 덮어써도 안전합니다.
② 권한 올리기 (소 → 중) — 처리 업무를 시키면 에이전트가 먼저 안내합니다.
"이 작업은 '중' 패키지부터 가능합니다. 권한을 올릴까요? (재승인 1번)"
"응, 올려줘"라고 답하면 에이전트가 새 승인 링크를 만들어줍니 다. 처음 연결 때와 똑같이 링크 승인 → 주소 복사 → 붙여넣기 하면 끝입니다. 쇼핑몰을 다시 등록할 필요는 없습니다.
7. 자주 묻는 질문 (FAQ)
Q. 기본 팩과 확장 팩, 뭐부터 설치해야 하나요?
기본 팩부터입니다. 조회·보고만 하므로 쇼핑몰에 아무 변경도 가하지 않아 가장 안전하고, 설치~연결이 몇 분 만에 끝납니다. 확장 팩은 필요해질 때 올리면 됩니다.
Q. 처음부터 확장 팩을 설치해도 되나요?
됩니다 — 확장 팩에 기본 4종이 포함돼 있어 그것만 올려도 전부 설치됩니다. 다만 처리 업무에는 '중' 권한 승인이 추가로 필요하므로, 익숙해질 때까지는 기본 팩 + '소' 권한으로 시작하는 것을 권장합니다.
Q. 스킬을 설치하면 바로 뭔가 실행되나요?
아닙니다. 스킬은 "매뉴얼"일 뿐이라 설치만으로는 아무 일도 일어나지 않습니다. 사장님이 말을 걸어야 움직입니다.
Q. "권한이 없다", "403" 같은 말이 나와요.
지금 권한 패키지보다 높은 작업을 요청한 경우입니다. 에이전트가 안내하는 대로 "권한 올려줘"라고 하면 됩니다. (6장 참고)
Q. 연결이 끊긴 것 같아요.
아래처럼 보내면 에이전트가 스스로 점검하고 필요하면 재연결을 안내합니다.
카페24 연결 상태 확인해줘.
Q. 쇼핑몰이 2개예요.
"카페24 쇼핑몰 하나 더 연결해줘"라고 하면 됩니다. 같은 앱이면 두 번째부터는 쇼핑몰 ID만 물어봅니다. 이후 요청 시 "본점 어제 매출 알려줘"처럼 가게 이름을 붙이면 됩니다.
Q. 앱 비밀키를 채팅으로 보내도 안전한가요?
비밀키는 에이전트 서버 안에 저장되고, 대화 기록에서는 가려집니다(시크릿 마스킹). 다만 보내신 메시지는 입력 직후 채팅방에서 직접 삭제해 두시면 더 안전합니다.
카페24 연결을 해제해줘.
Q. 에이전트가 마음대로 주문을 취소하거나 가격을 바꾸지 않나요?
않습니다. 데이터를 바꾸는 모든 작업은 ① 무엇이 어떻게 바뀌는지 먼저 보여주고 ② 사장님이 승인한 뒤에만 ③ 한 건씩 실행하도록 스킬에 규칙으로 박혀 있습니다.
8. 한눈에 보는 여정 요약
① 링크에서 기본 팩 ZIP 다운로드 (압축 풀지 않기) (1분)
② 대시보드 또는 텔레그램에 ZIP 올리고 "스킬 설치해줘" (5분, 1회)
③ "카페24 쇼핑몰 연결해줘" → 이후 에이전트 안내 따라가기 (5분, 1회)
④ "우리 가게 파악해서 프로필 만들어줘" (3분, 권장)
⑤ "매일 아침 9시에 브리핑 보내줘" (10초, 권장)
─────────────────────────────────────────────
이후엔 그냥 말 걸기: "오늘 장사 어땠어?" 📱
필요해지면: 확장 팩 ZIP 올리기 + "권한 올려줘" (6장)