Zalo ကိုယ်ရေးကိုယ်တာ (တရားဝင်မဟုတ်)¶

အခြေအနေ: စမ်းသပ်ဆဲ။ ဤပေါင်းစည်းမှုသည် zca-cli ကို အသုံးပြု၍ ကိုယ်ပိုင် Zalo အကောင့် ကို အလိုအလျောက် လုပ်ဆောင်စေပါသည်။

သတိပေးချက်: ဤပေါင်းစည်းမှုသည် တရားဝင်မဟုတ်ပါ။ အကောင့် ရပ်ဆိုင်းခြင်း/ပိတ်ပင်ခြင်း ဖြစ်နိုင်ပါသည်။ မိမိတာဝန်ယူ၍ အသုံးပြုပါ။

လိုအပ်သော Plugin¶

Zalo ကိုယ်ရေးကိုယ်တာသည် plugin အဖြစ် ပေးပို့ထားပြီး core install ထဲတွင် မပါဝင်ပါ။

• CLI ဖြင့် ထည့်သွင်းရန်: openclaw plugins install @openclaw/zalouser
• သို့မဟုတ် source checkout မှ: openclaw plugins install ./extensions/zalouser
• အသေးစိတ်: Plugins

ကြိုတင်လိုအပ်ချက်: zca-cli¶

Gateway စက်တွင် zca binary ကို PATH တွင် ရရှိနိုင်ရပါမည်။

• စစ်ဆေးရန်: zca --version
• မရှိပါက zca-cli ကို ထည့်သွင်းပါ (extensions/zalouser/README.md သို့မဟုတ် upstream zca-cli docs ကို ကြည့်ပါ)။

အမြန်တပ်ဆင်ခြင်း (အစပြုသူ)¶

1. Plugin ကို ထည့်သွင်းပါ (အထက်တွင် ဖော်ပြထားသည်)။
2. လော့ဂ်အင် (QR၊ Gateway စက်ပေါ်တွင်): - openclaw channels login --channel zalouser - Terminal တွင် ပြထားသော QR code ကို Zalo မိုဘိုင်းအက်ပ်ဖြင့် စကန်ဖတ်ပါ။
3. Channel ကို ဖွင့်ပါ:

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

4. Gateway ကို ပြန်လည်စတင်ပါ (သို့မဟုတ် onboarding ကို ပြီးဆုံးပါ)။
5. DM ဝင်ရောက်ခွင့်သည် မူလအားဖြင့် pairing ကို အသုံးပြုသည်။ ပထမဆုံး ဆက်သွယ်ချိန်တွင် pairing code ကို အတည်ပြုပါ။

၎င်းသည် မည်သို့သောအရာလဲ¶

• ဝင်လာသော မက်ဆေ့ချ်များကို လက်ခံရန် zca listen ကို အသုံးပြုသည်။
• ပြန်ကြားချက်များ (စာသား/မီဒီယာ/လင့်ခ်) ပို့ရန် zca msg ... ကို အသုံးပြုသည်။
• Zalo Bot API မရရှိနိုင်သော “ကိုယ်ရေးကိုယ်တာအကောင့်” အသုံးပြုမှုများအတွက် ဒီဇိုင်းပြုလုပ်ထားသည်။

အမည်ပေးခြင်း¶

Channel id ကို zalouser ဟု သတ်မှတ်ထားသည်မှာ ဤအရာသည် ကိုယ်ပိုင် Zalo အသုံးပြုသူ အကောင့် (တရားဝင်မဟုတ်) ကို အလိုအလျောက် လုပ်ဆောင်စေသည်ကို ရှင်းလင်းစွာ ဖော်ပြရန် ဖြစ်သည်။ အနာဂတ်တွင် တရားဝင် Zalo API ပေါင်းစည်းမှု ဖြစ်နိုင်ခြေအတွက် zalo ကို သီးသန့် ထားရှိထားပါသည်။

ID များကို ရှာဖွေရန် (directory)¶

Directory CLI ကို အသုံးပြု၍ peer/group များနှင့် ၎င်းတို့၏ ID များကို ရှာဖွေပါ:

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

ကန့်သတ်ချက်များ¶

• ထွက်သွားသော စာသားကို ~2000 အက္ခရာအထိ ခွဲပို့သည် (Zalo client ကန့်သတ်ချက်)။
• Streaming ကို မူလအားဖြင့် ပိတ်ထားသည်။

ဝင်ရောက်ခွင့်ထိန်းချုပ်မှု (DMs)¶

channels.zalouser.dmPolicy သည် အောက်ပါတို့ကို ပံ့ပိုးပါသည် - pairing | allowlist | open | disabled (မူလတန်ဖိုး - pairing)။ channels.zalouser.allowFrom accepts user IDs or names. The wizard resolves names to IDs via zca friend find when available.

အတည်ပြုရန်:

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

အုပ်စု ဝင်ရောက်ခွင့် (ရွေးချယ်နိုင်)¶

• မူလတန်ဖိုး - channels.zalouser.groupPolicy = "open" (အုပ်စုများ ခွင့်ပြုထားသည်)။ မသတ်မှတ်ရသေးပါက မူလတန်ဖိုးကို ပြောင်းလဲရန် channels.defaults.groupPolicy ကို အသုံးပြုပါ။
• Allowlist ဖြင့် ကန့်သတ်ရန်:
• channels.zalouser.groupPolicy = "allowlist"
• channels.zalouser.groups (ကီးများမှာ အုပ်စု ID များ သို့မဟုတ် အမည်များ ဖြစ်သည်)
• အုပ်စုအားလုံးကို ပိတ်ရန်: channels.zalouser.groupPolicy = "disabled"။
• Configure wizard သည် အုပ်စု allowlist များကို မေးမြန်းနိုင်သည်။
• စတင်ချိန်တွင် OpenClaw သည် allowlist ထဲရှိ အုပ်စု/အသုံးပြုသူ အမည်များကို ID များအဖြစ် ဖြေရှင်းပြီး mapping ကို မှတ်တမ်းတင်သည်။ မဖြေရှင်းနိုင်သော အချက်အလက်များကို ရိုက်ထည့်ထားသည့်အတိုင်း ထားရှိသည်။

ဥပမာ:

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

အကောင့် အများအပြား¶

Accounts map to zca profiles. ဥပမာ —

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

ပြဿနာဖြေရှင်းခြင်း¶

zca ကို မတွေ့ပါက:

• zca-cli ကို ထည့်သွင်းပြီး Gateway process အတွက် PATH တွင် ပါဝင်ကြောင်း သေချာစေပါ။

လော့ဂ်အင် မတည်မြဲပါက:

• openclaw channels status --probe
• ပြန်လည် လော့ဂ်အင်လုပ်ရန်: openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser