잘로 개인(비공식)

상태: 실험적. 이 통합은 zca-cli를 통해 개인 Zalo 계정을 자동화합니다.

경고: 이는 비공식 통합이므로 계정이 정지/금지될 수 있습니다. 자신의 책임하에 사용하십시오.

플러그인이 필요합니다

Zalo Personal은 플러그인으로 제공되며 핵심 설치와 함께 번들로 제공되지 않습니다.

• CLI를 통해 설치: openclaw plugins install @openclaw/zalouser
• 또는 소스 체크아웃에서: openclaw plugins install ./extensions/zalouser
• 세부정보: 플러그인

전제조건: zca-cli

게이트웨이 머신에는 PATH에서 사용할 수 있는 zca 바이너리가 있어야 합니다.

• 확인: zca --version
• 누락된 경우 zca-cli를 설치합니다(extensions/zalouser/README.md 또는 업스트림 zca-cli 문서 참조).

빠른 설정(초보자)

1. 플러그인을 설치합니다(위 참조).
2. 로그인(QR, 게이트웨이 시스템):
   • openclaw channels login --channel zalouser
   • Zalo 모바일 앱을 사용하여 단말기의 QR 코드를 스캔하세요.
3. 채널을 활성화합니다:

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

4. 게이트웨이를 다시 시작합니다(또는 온보딩을 완료합니다).
5. DM 액세스는 기본적으로 페어링으로 설정됩니다. 첫 번째 연락 시 페어링 코드를 승인하세요.

그게 뭐야?

• 인바운드 메시지를 수신하기 위해 zca listen를 사용합니다.
• zca msg ...를 사용하여 답변(텍스트/미디어/링크)을 보냅니다.
• Zalo Bot API를 사용할 수 없는 "개인 계정" 사용 사례를 위해 설계되었습니다.

이름 지정

채널 ID는 zalouser입니다. 이는 개인 Zalo 사용자 계정(비공식)을 자동화합니다. 우리는 잠재적인 향후 공식 Zalo API 통합을 위해 zalo를 예약해 둡니다.

ID 찾기(디렉토리)

디렉터리 CLI를 사용하여 피어/그룹 및 해당 ID를 검색합니다.

openclaw directory self --channel zalouser
openclaw directory peers list --channel zalouser --query "name"
openclaw directory groups list --channel zalouser --query "work"

한도

• 아웃바운드 텍스트는 최대 2000자로 청크됩니다(Zalo 클라이언트 제한).
• 스트리밍은 기본적으로 차단되어 있습니다.

액세스 제어(DM)

channels.zalouser.dmPolicy는 다음을 지원합니다: pairing | allowlist | open | disabled (기본값: pairing). channels.zalouser.allowFrom는 사용자 ID 또는 이름을 허용합니다. 마법사는 가능한 경우 zca friend find를 통해 이름을 ID로 확인합니다.

승인 방법:

• openclaw pairing list zalouser
• openclaw pairing approve zalouser <code>

그룹 액세스(선택 사항)

• 기본값: channels.zalouser.groupPolicy = "open" (그룹 허용) 설정되지 않은 경우 기본값을 무시하려면 channels.defaults.groupPolicy를 사용하세요.
• 다음을 사용하여 허용 목록으로 제한합니다.
  • channels.zalouser.groupPolicy = "allowlist"
  • channels.zalouser.groups (키는 그룹 ID 또는 이름입니다)
• 모든 그룹을 차단합니다: channels.zalouser.groupPolicy = "disabled".
• 구성 마법사에서 그룹 허용 목록을 묻는 메시지를 표시할 수 있습니다.
• 시작 시 OpenClaw는 허용 목록의 그룹/사용자 이름을 ID로 확인하고 매핑을 기록합니다. 해결되지 않은 항목은 입력한 대로 유지됩니다.

예:

{
  channels: {
    zalouser: {
      groupPolicy: "allowlist",
      groups: {
        "123456789": { allow: true },
        "Work Chat": { allow: true },
      },
    },
  },
}

다중 계정

계정은 zca 프로필에 매핑됩니다. 예:

{
  channels: {
    zalouser: {
      enabled: true,
      defaultAccount: "default",
      accounts: {
        work: { enabled: true, profile: "work" },
      },
    },
  },
}

문제 해결

zca 찾을 수 없음:

• zca-cli를 설치하고 게이트웨이 프로세스에 대해 PATH에 있는지 확인합니다.

로그인이 유지되지 않습니다:

• openclaw channels status --probe
• 재로그인 : openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser