OpenClaw Zalo Personal 연동: 5분 만에 자동화 설정하기

가끔 공식 API가 없거나 제한적일 때, 개인 계정을 자동화하고 싶은 마음이 굴뚝같죠. 하지만 직접 구현하려면 인증부터 통신 프로토콜까지 신경 쓸 게 한두 가지가 아니에요. 이런 고민을 해결해 줄 Zalo Personal 플러그인을 소개할게요.

이 플러그인은 OpenClaw에서 Zalo를 지원하며, 네이티브 zca-js를 사용해 일반 Zalo 사용자 계정을 자동화해요.

경고: 비공식 자동화는 계정 정지나 차단으로 이어질 수 있어요. 모든 책임은 사용자 본인에게 있으니 주의해서 사용해 주세요.

명칭

채널 ID는 zalouser예요. 이건 비공식적으로 개인 Zalo 사용자 계정을 자동화한다는 점을 명확히 하기 위해서죠. 나중에 공식 Zalo API 연동이 추가될 경우를 대비해 zalo라는 이름은 따로 남겨두었어요.

실행 환경

이 플러그인은 Gateway 프로세스 내부에서 실행돼요.

만약 원격 Gateway를 사용 중이라면, Gateway가 실행되고 있는 장비에 플러그인을 설치하고 설정한 다음 Gateway를 재시작해 주세요. 별도의 zca나 openzca CLI 바이너리는 설치할 필요가 없어요.

설치

방법 A: npm으로 설치하기

openclaw plugins install @openclaw/zalouser

설치 후 Gateway를 재시작해 주세요.

방법 B: 로컬 폴더에서 설치하기 (개발용)

PLUGIN_SRC=./path/to/local/zalouser-plugin
openclaw plugins install "$PLUGIN_SRC"
cd "$PLUGIN_SRC" && pnpm install

설치 후 Gateway를 재시작해 주세요.

설정

채널 설정은 plugins.entries.*가 아니라 channels.zalouser 아래에 작성해요.

{
  channels: {
    zalouser: {
      enabled: true,
      dmPolicy: "pairing",
    },
  },
}

CLI 명령어

openclaw channels login --channel zalouser
openclaw channels logout --channel zalouser
openclaw channels status --probe
openclaw message send --channel zalouser --target <threadId> --message "Hello from OpenClaw"
openclaw directory peers list --channel zalouser --query "name"

에이전트 도구

도구 이름: zalouser

사용 가능한 액션: send, image, link, friends, groups, me, status

채널 메시지 액션에서는 메시지 반응을 위한 react 기능도 지원해요.

---

설정 중에 도움이 필요하다면 AI Setup Assistant에게 물어보세요!

다음 단계

• Gateway 설정 가이드
• 채널 관리 방법