Zalo personal plugin

기준일: 2026-07-26
공식 기준: Zalo personal plugin

Zalo personal plugin 문서는 OpenClaw 공식 문서(plugins/zalouser)를 한국어로 정리한 가이드입니다. Zalo Personal plugin: QR login + messaging via native zca-js (plugin install + channel config + tool) 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Zalo Personal plugin: QR login + messaging via native zca-js (plugin install + channel config + tool)

한국어 가이드 범위: plugins/zalouser 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• Naming
• Where it runs
• 설치
• From npm
• From a local folder (dev)
• 구성
• CLI
• Agent tool
• 관련 문서

상세 내용

본문

Zalo Personal support for OpenClaw via a plugin that uses native zca-js to automate a normal Zalo user account. No external zca/openzca CLI binary is required.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Naming

Channel id is zalouser to make it explicit this automates a personal Zalo user account (unofficial). The separate zalo channel id is the official, bundled Zalo Bot/webhook integration - see Zalo.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Where it runs

This plugin runs inside the Gateway process. For a remote Gateway, install/configure it on that host, then restart the Gateway.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

설치

이 섹션의 세부 항목은 공식 문서 설치를 참고하세요.

From npm

Use the bare package to follow the current official release tag; pin an exact version only when you need a reproducible install. Restart the Gateway afterwards.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

openclaw plugins install @openclaw/zalouser

From a local folder (dev)

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

구성

Channel config lives under channels.zalouser (not plugins.entries.*):

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

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

CLI

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

Agent tool

Actions: send, image, link, friends, groups, me, status

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

관련 문서

주요 항목:

• Zalo personal channel config
• Zalo (official Bot/webhook channel)
• Building plugins
• ClawHub

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/plugins/zalouser
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

openclaw plugins install @openclaw/zalouser

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

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

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

관련 링크

• 공식 원문: plugins/zalouser
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.