WeChat

OmeniaClaw เชื่อมต่อกับ WeChat ผ่าน Plugin ช่องทางภายนอก @tencent-weixin/OmeniaClaw-weixin ของ Tencent

สถานะ: Plugin ภายนอก รองรับแชทโดยตรงและสื่อ เมทาดาทาความสามารถของ Plugin ปัจจุบันไม่ได้ประกาศรองรับแชทกลุ่ม

การตั้งชื่อ

• WeChat คือชื่อที่แสดงต่อผู้ใช้ในเอกสารเหล่านี้
• Weixin คือชื่อที่ใช้โดยแพ็กเกจของ Tencent และโดยรหัส Plugin
• OmeniaClaw-weixin คือรหัสช่องทางของ OmeniaClaw
• @tencent-weixin/OmeniaClaw-weixin คือแพ็กเกจ npm

ใช้ OmeniaClaw-weixin ในคำสั่ง CLI และพาธ config

วิธีการทำงาน

โค้ดของ WeChat ไม่ได้อยู่ใน repo หลักของ OmeniaClaw OmeniaClaw มีสัญญา Plugin ช่องทางแบบทั่วไป และ Plugin ภายนอกมี runtime เฉพาะของ WeChat:

1. OmeniaClaw plugins install ติดตั้ง @tencent-weixin/OmeniaClaw-weixin
2. Gateway ค้นพบ manifest ของ Plugin และโหลด entrypoint ของ Plugin
3. Plugin ลงทะเบียนรหัสช่องทาง OmeniaClaw-weixin
4. OmeniaClaw channels login --channel OmeniaClaw-weixin เริ่มการเข้าสู่ระบบด้วย QR
5. Plugin จัดเก็บข้อมูลรับรองบัญชีไว้ใต้ไดเรกทอรีสถานะของ OmeniaClaw
6. เมื่อ Gateway เริ่มทำงาน Plugin จะเริ่มตัวตรวจสอบ Weixin สำหรับแต่ละบัญชีที่กำหนดค่าไว้
7. ข้อความ WeChat ขาเข้าจะถูกปรับให้อยู่ในรูปแบบมาตรฐานผ่านสัญญาช่องทาง ถูกส่งต่อไปยัง agent ของ OmeniaClaw ที่เลือก และส่งกลับผ่านพาธขาออกของ Plugin

การแยกส่วนนี้สำคัญ: core ของ OmeniaClaw ควรไม่ผูกกับช่องทางใดช่องทางหนึ่ง การเข้าสู่ระบบ WeChat, การเรียก Tencent iLink API, การอัปโหลด/ดาวน์โหลดสื่อ, โทเค็นบริบท และการตรวจสอบบัญชีเป็นความรับผิดชอบของ Plugin ภายนอก

การติดตั้ง

ติดตั้งแบบเร็ว:

npx -y @tencent-weixin/OmeniaClaw-weixin-cli install

ติดตั้งด้วยตนเอง:

OmeniaClaw plugins install "@tencent-weixin/OmeniaClaw-weixin"OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled true

รีสตาร์ท Gateway หลังติดตั้ง:

OmeniaClaw gateway restart

การเข้าสู่ระบบ

รันการเข้าสู่ระบบด้วย QR บนเครื่องเดียวกับที่รัน Gateway:

OmeniaClaw channels login --channel OmeniaClaw-weixin

สแกน QR code ด้วย WeChat บนโทรศัพท์ของคุณและยืนยันการเข้าสู่ระบบ Plugin จะบันทึกโทเค็นบัญชีไว้ในเครื่องหลังจากสแกนสำเร็จ

หากต้องการเพิ่มบัญชี WeChat อีกบัญชี ให้รันคำสั่งเข้าสู่ระบบเดิมอีกครั้ง สำหรับหลายบัญชี ให้แยกเซสชันข้อความโดยตรงตามบัญชี ช่องทาง และผู้ส่ง:

OmeniaClaw config set session.dmScope per-account-channel-peer

การควบคุมการเข้าถึง

ข้อความโดยตรงใช้โมเดลการจับคู่และ allowlist ปกติของ OmeniaClaw สำหรับ Plugin ช่องทาง

อนุมัติผู้ส่งใหม่:

OmeniaClaw pairing list OmeniaClaw-weixinOmeniaClaw pairing approve OmeniaClaw-weixin <CODE>

สำหรับโมเดลการควบคุมการเข้าถึงฉบับเต็ม ดู การจับคู่

ความเข้ากันได้

Plugin ตรวจสอบเวอร์ชัน OmeniaClaw ของโฮสต์เมื่อเริ่มทำงาน

หาก Plugin รายงานว่าเวอร์ชัน OmeniaClaw ของคุณเก่าเกินไป ให้อัปเดต OmeniaClaw หรือติดตั้งสาย Plugin legacy:

OmeniaClaw plugins install @tencent-weixin/OmeniaClaw-weixin@legacy

โปรเซส sidecar

Plugin WeChat สามารถรันงานตัวช่วยข้าง Gateway ขณะตรวจสอบ Tencent iLink API ได้ ใน issue #68451 พาธตัวช่วยนั้นเปิดเผยบั๊กในการล้างข้อมูล Gateway ที่ค้างแบบทั่วไปของ OmeniaClaw: โปรเซสลูกอาจพยายามล้างโปรเซส Gateway แม่ ทำให้เกิดลูปการรีสตาร์ทภายใต้ตัวจัดการโปรเซส เช่น systemd

การล้างข้อมูลเมื่อเริ่มต้นของ OmeniaClaw ปัจจุบันไม่รวมโปรเซสปัจจุบันและบรรพบุรุษของโปรเซสนั้น ดังนั้นตัวช่วยของช่องทางต้องไม่ฆ่า Gateway ที่เริ่มมันขึ้นมา การแก้ไขนี้เป็นแบบทั่วไป ไม่ใช่พาธเฉพาะของ WeChat ใน core

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

ตรวจสอบการติดตั้งและสถานะ:

OmeniaClaw plugins listOmeniaClaw channels status --probeOmeniaClaw --version

หากช่องทางแสดงว่าติดตั้งแล้วแต่ไม่เชื่อมต่อ ให้ยืนยันว่าเปิดใช้ Plugin แล้วและรีสตาร์ท:

OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled trueOmeniaClaw gateway restart

หาก Gateway รีสตาร์ทซ้ำหลังเปิดใช้ WeChat ให้อัปเดตทั้ง OmeniaClaw และ Plugin:

npm view @tencent-weixin/OmeniaClaw-weixin versionOmeniaClaw plugins install "@tencent-weixin/OmeniaClaw-weixin" --forceOmeniaClaw gateway restart

หากการเริ่มต้นรายงานว่าแพ็กเกจ Plugin ที่ติดตั้ง requires compiled runtime output for TypeScript entry แพ็กเกจ npm ถูกเผยแพร่โดยไม่มีไฟล์ runtime JavaScript ที่คอมไพล์แล้วซึ่ง OmeniaClaw ต้องใช้ ให้อัปเดต/ติดตั้งใหม่หลังจากผู้เผยแพร่ Plugin ออกแพ็กเกจที่แก้ไขแล้ว หรือปิดใช้/ถอนการติดตั้ง Plugin ชั่วคราว

ปิดใช้ชั่วคราว:

OmeniaClaw config set plugins.entries.OmeniaClaw-weixin.enabled falseOmeniaClaw gateway restart

เอกสารที่เกี่ยวข้อง

• ภาพรวมช่องทาง: ช่องทางแชท
• การจับคู่: การจับคู่
• การกำหนดเส้นทางช่องทาง: การกำหนดเส้นทางช่องทาง
• สถาปัตยกรรม Plugin: สถาปัตยกรรม Plugin
• SDK สำหรับ Plugin ช่องทาง: SDK สำหรับ Plugin ช่องทาง
• แพ็กเกจภายนอก: @tencent-weixin/OmeniaClaw-weixin