WeChat

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

สถานะ: Plugin ภายนอกที่ดูแลโดยทีม Tencent Weixin รองรับการแชตโดยตรงและ สื่อ เมทาดาทาความสามารถของ Plugin ไม่ได้ระบุว่ารองรับการแชตแบบกลุ่ม (ระบุเฉพาะการแชตโดยตรง)

การตั้งชื่อ

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

ใช้ openclaw-weixin ในคำสั่ง CLI และพาธการกำหนดค่า

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

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

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

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

การติดตั้ง

ติดตั้งอย่างรวดเร็ว:

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

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

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

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

openclaw gateway restart

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

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

openclaw channels login --channel openclaw-weixin

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

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

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

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

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

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

openclaw pairing list openclaw-weixinopenclaw pairing approve openclaw-weixin <CODE>

สำหรับรูปแบบการควบคุมการเข้าถึงทั้งหมด โปรดดู การจับคู่

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

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

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

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

โปรเซสประกอบ

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

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

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

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

openclaw plugins listopenclaw channels status --probeopenclaw --version

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

openclaw config set plugins.entries.openclaw-weixin.enabled trueopenclaw gateway restart

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

npm view @tencent-weixin/openclaw-weixin versionopenclaw plugins install "@tencent-weixin/openclaw-weixin" --forceopenclaw gateway restart

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

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

openclaw config set plugins.entries.openclaw-weixin.enabled falseopenclaw gateway restart

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

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