Zalo ส่วนบุคคล

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Plugin ที่รวมมาให้

• ติดตั้งผ่าน CLI: openclaw plugins install @openclaw/zalouser
• เวอร์ชันที่ปักหมุด: openclaw plugins install @openclaw/zalouser@2026.5.2
• หรือจากซอร์สที่เช็กเอาต์ไว้: openclaw plugins install ./path/to/local/zalouser-plugin
• รายละเอียด: Plugin

​

การตั้งค่าอย่างรวดเร็ว (ผู้เริ่มต้น)

1. ตรวจสอบให้แน่ใจว่า Plugin Zalo Personal พร้อมใช้งาน
   • OpenClaw รุ่นแพ็กเกจปัจจุบันรวมไว้แล้ว
   • การติดตั้งเก่ากว่า/แบบกำหนดเองสามารถเพิ่มเองได้ด้วยคำสั่งด้านบน
2. เข้าสู่ระบบ (QR บนเครื่อง Gateway):
   • openclaw channels login --channel zalouser
   • สแกนโค้ด QR ด้วยแอปมือถือ Zalo
3. เปิดใช้งานช่องทาง:

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

4. รีสตาร์ต Gateway (หรือทำการตั้งค่าให้เสร็จ)
5. ค่าเริ่มต้นของการเข้าถึงข้อความโดยตรงคือการจับคู่ อนุมัติรหัสจับคู่เมื่อมีการติดต่อครั้งแรก

​

คืออะไร

• ทำงานทั้งหมดในโปรเซสผ่าน zca-js
• ใช้ตัวรับฟังเหตุการณ์แบบเนทีฟเพื่อรับข้อความขาเข้า
• ส่งคำตอบโดยตรงผ่าน JS API (ข้อความ/สื่อ/ลิงก์)
• ออกแบบมาสำหรับกรณีใช้งานแบบ “บัญชีส่วนตัว” ที่ Zalo Bot API ไม่พร้อมใช้งาน

​

การตั้งชื่อ

​

การค้นหา ID (ไดเรกทอรี)

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

​

ข้อจำกัด

• ข้อความขาออกจะถูกแบ่งเป็นส่วนละประมาณ 2000 อักขระ (ข้อจำกัดของไคลเอนต์ Zalo)
• การสตรีมถูกบล็อกตามค่าเริ่มต้น

​

การควบคุมการเข้าถึง (ข้อความโดยตรง)

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

​

การเข้าถึงกลุ่ม (ไม่บังคับ)

• ค่าเริ่มต้น: channels.zalouser.groupPolicy = "open" (อนุญาตกลุ่ม) ใช้ channels.defaults.groupPolicy เพื่อแทนที่ค่าเริ่มต้นเมื่อไม่ได้ตั้งค่า
• จำกัดเป็นรายการที่อนุญาตด้วย:
  • channels.zalouser.groupPolicy = "allowlist"
  • channels.zalouser.groups (คีย์ควรเป็น ID กลุ่มที่เสถียร ชื่อจะถูกแก้ไขเป็น ID เมื่อเริ่มต้นระบบเท่านั้นเมื่อเปิดใช้งาน channels.zalouser.dangerouslyAllowNameMatching: true)
  • channels.zalouser.groupAllowFrom (ควบคุมว่าผู้ส่งรายใดในกลุ่มที่อนุญาตสามารถเรียกบอตได้ กลุ่มการเข้าถึงผู้ส่งแบบคงที่สามารถอ้างอิงด้วย accessGroup:<name>)
• บล็อกทุกกลุ่ม: channels.zalouser.groupPolicy = "disabled"
• วิซาร์ดกำหนดค่าสามารถถามรายการกลุ่มที่อนุญาตได้
• เมื่อเริ่มต้นระบบ OpenClaw จะแก้ไขชื่อกลุ่ม/ผู้ใช้ในรายการที่อนุญาตให้เป็น ID และบันทึกการแมปเฉพาะเมื่อเปิดใช้งาน channels.zalouser.dangerouslyAllowNameMatching: true
• การจับคู่รายการกลุ่มที่อนุญาตใช้เฉพาะ ID ตามค่าเริ่มต้น ชื่อที่แก้ไขไม่ได้จะถูกละเว้นสำหรับการยืนยันสิทธิ์ เว้นแต่จะเปิดใช้งาน channels.zalouser.dangerouslyAllowNameMatching: true
• channels.zalouser.dangerouslyAllowNameMatching: true เป็นโหมดความเข้ากันได้สำหรับกรณีฉุกเฉินที่เปิดใช้การแก้ไขชื่อเมื่อเริ่มต้นระบบที่เปลี่ยนแปลงได้และการจับคู่ชื่อกลุ่มขณะรันไทม์อีกครั้ง
• หากไม่ได้ตั้งค่า groupAllowFrom รันไทม์จะถอยกลับไปใช้ allowFrom สำหรับการตรวจสอบผู้ส่งในกลุ่ม
• การตรวจสอบผู้ส่งใช้กับทั้งข้อความกลุ่มปกติและคำสั่งควบคุม (เช่น /new, /reset)

{
  channels: {
    zalouser: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["1471383327500481391"],
      groups: {
        "123456789": { allow: true },
        "Work Chat": { allow: true },
      },
    },
  },
}

​

การกั้นด้วยการกล่าวถึงในกลุ่ม

• channels.zalouser.groups.<group>.requireMention ควบคุมว่าการตอบกลับในกลุ่มต้องมีการกล่าวถึงหรือไม่
• ลำดับการแก้ไข: ID/ชื่อกลุ่มตรงกันแบบเป๊ะ -> slug กลุ่มที่ปรับให้เป็นมาตรฐาน -> * -> ค่าเริ่มต้น (true)
• ใช้กับทั้งกลุ่มในรายการที่อนุญาตและโหมดกลุ่มแบบเปิด
• การอ้างข้อความของบอตนับเป็นการกล่าวถึงโดยนัยสำหรับการเปิดใช้งานกลุ่ม
• คำสั่งควบคุมที่ได้รับอนุญาต (เช่น /new) สามารถข้ามการกั้นด้วยการกล่าวถึงได้
• เมื่อข้อความกลุ่มถูกข้ามเพราะต้องมีการกล่าวถึง OpenClaw จะจัดเก็บไว้เป็นประวัติกลุ่มที่รอดำเนินการ และรวมไว้ในข้อความกลุ่มถัดไปที่ถูกประมวลผล
• ค่าเริ่มต้นของขีดจำกัดประวัติกลุ่มคือ messages.groupChat.historyLimit (ค่าถอยกลับ 50) คุณสามารถแทนที่เป็นรายบัญชีด้วย channels.zalouser.historyLimit

{
  channels: {
    zalouser: {
      groupPolicy: "allowlist",
      groups: {
        "*": { allow: true, requireMention: true },
        "Work Chat": { allow: true, requireMention: false },
      },
    },
  },
}

​

หลายบัญชี

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

​

การพิมพ์ การโต้ตอบ และการรับทราบการส่งมอบ

• OpenClaw ส่งเหตุการณ์การพิมพ์ก่อนส่งคำตอบ (พยายามอย่างดีที่สุด)
• รองรับการกระทำโต้ตอบข้อความ react สำหรับ zalouser ในการกระทำของช่องทาง
  • ใช้ remove: true เพื่อลบอีโมจิการโต้ตอบที่ระบุออกจากข้อความ
  • ความหมายของการโต้ตอบ: การโต้ตอบ
• สำหรับข้อความขาเข้าที่มีเมทาดาทาเหตุการณ์ OpenClaw จะส่งการรับทราบว่าส่งถึงแล้ว + เห็นแล้ว (พยายามอย่างดีที่สุด)

​

การแก้ไขปัญหา

• openclaw channels status --probe
• เข้าสู่ระบบใหม่: openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser

• ใช้ ID ตัวเลขใน allowFrom/groupAllowFrom และ ID กลุ่มที่เสถียรใน groups หากคุณตั้งใจต้องใช้ชื่อเพื่อน/กลุ่มที่ตรงกันแบบเป๊ะ ให้เปิดใช้งาน channels.zalouser.dangerouslyAllowNameMatching: true

• ลบสมมติฐานเดิมเกี่ยวกับโปรเซส zca ภายนอกออก
• ตอนนี้ช่องทางทำงานทั้งหมดใน OpenClaw โดยไม่มีไบนารี CLI ภายนอก

​

ที่เกี่ยวข้อง

• ภาพรวมช่องทาง — ช่องทางทั้งหมดที่รองรับ
• การจับคู่ — การยืนยันตัวตนข้อความโดยตรงและโฟลว์การจับคู่
• กลุ่ม — พฤติกรรมแชตกลุ่มและการกั้นด้วยการกล่าวถึง
• การกำหนดเส้นทางช่องทาง — การกำหนดเส้นทางเซสชันสำหรับข้อความ
• ความปลอดภัย — โมเดลการเข้าถึงและการเสริมความแข็งแกร่ง