공식 계정 API를 사용하여 OpenClaw을 Zalo에 연결하세요. 이 가이드에서는 OpenClaw v2026.2+, Zalo OA 설정, API 자격 증명 구성, 메시지 처리 및 자체 호스팅 AI 어시스턴트를 위한 webhook 통합을 다룹니다.
Zalo 연동
OpenClaw을 Zalo에 연결하여 AI 어시스턴트가 즉시 메시지에 응답하도록 하세요.
요약
- ✓ 전제 조건: Node.js 22+, OpenClaw 설치됨
- ✓ 구성: openclaw.json에 Zalo 섹션 추가
- ✓ 소요 시간: 약 10분
- ✓ 필요: Zalo 계정 + OA (공식 계정)
전제 조건
- 1.
OpenClaw 설치됨
아직 설치하지 않았다면 설치 가이드를 따르세요.
- 2.
Zalo 공식 계정 (OA)
oa.zalo.me에서 Zalo 공식 계정을 만들어야 합니다.
- 3.
Zalo API 자격 증명
Zalo OA 대시보드에서 OA ID와 API 키를 가져오세요.
설정 단계
2단계: openclaw.json 구성
openclaw.json 파일에 Zalo 구성을 추가하세요:
{
"channels": {
"zalo": {
"enabled": true,
"oaId": "당신의_oa_id",
"apiKey": "당신의_api_key",
"allowFrom": ["*"]
}
}
}3단계: OpenClaw 시작
Zalo를 활성화하고 OpenClaw을 시작하세요:
openclaw start봇이 Zalo에 연결되어 메시지를 받을 준비가 됩니다.
4단계: AI 어시스턴트 테스트
Zalo를 열고 공식 계정을 검색하세요:
- Zalo 앱 열기
- OA 이름 검색
- 대화를 시작하려면 메시지 보내기
연결됨! Zalo AI 어시스턴트가 준비되었습니다.
고급 구성
특정 사용자 허용
AI 어시스턴트와 상호작용할 수 있는 사용자 제한:
{
"channels": {
"zalo": {
"enabled": true,
"oaId": "당신의_oa_id",
"apiKey": "당신의_api_key",
"allowFrom": ["user_id_1", "user_id_2"]
}
}
}Webhook 구성
고급 기능의 경우 Zalo OA 대시보드에서 webhook을 구성하세요:
- OA 대시보드 → 고급 설정 → Webhook으로 이동
- webhook URL을 OpenClaw 서버로 설정
- 수신할 이벤트 활성화
문제 해결
API 키가 유효하지 않음?
Zalo OA 대시보드에서 API 키를 확인하세요. 계정에서 API가 활성화되어 있는지 확인하세요.
메시지를 받지 못함?
openclaw.json의 Zalo 채널에서 "enabled"가 true로 설정되어 있는지 확인하고 로그를 확인하세요.
OA를 찾을 수 없음?
공식 계정이 확인되고 활성 상태인지 확인하세요. 새 OA는 먼저 승인받아야 할 수 있습니다.
관련 가이드
자주 묻는 질문
Zalo OA는 무료인가요?
Zalo 공식 계정에는 무료와 프리미엄 티어가 있습니다. 기본 API 기능은 제한적으로 무료입니다. 자세한 내용은 Zalo 가격을 확인하세요.
개인 Zalo 계정을 사용할 수 있나요?
아니요, API를 사용하려면 Zalo 공식 계정(OA)이 필요합니다. oa.zalo.me에서 만드세요.
Zalo는 그룹 메시지를 지원하나요?
Zalo OA는 OA와 상호작용한 사용자에게 메시지를 보낼 수 있습니다. 그룹 메시지의 경우 팬 페이지를 관리해야 합니다.
API 자격 증명은 어떻게 얻나요?
oa.zalo.me로 이동하여 OA를 선택하고 고급 설정 → API → API 키 생성을 선택하세요.