สรุปสั้นๆ: เชื่อมต่อ OpenClaw เข้ากับ WeChat โดยการติดตั้งปลั๊กอิน @tencent-weixin/openclaw-weixin สแกน QR โค้ดเพื่ออนุญาตบัญชีของคุณ และรีสตาร์ทเกตเวย์ การตั้งค่าทั้งหมดใช้เวลาไม่ถึง 5 นาที ปลั๊กอินนี้ฟรี โอเพนซอร์ส และรองรับบัญชี WeChat หลายบัญชีพร้อมกัน
บทนำ
การรันผู้ช่วย AI บน WeChat ดูเหมือนจะเป็นเรื่องที่ซับซ้อน โซลูชั่นส่วนใหญ่ต้องเสียค่าสมัครสมาชิก API ราคาแพง, การตั้งค่าเซิร์ฟเวอร์ที่ซับซ้อน หรือบัญชีองค์กร OpenClaw ได้เปลี่ยนสิ่งเหล่านั้นแล้ว
ปลั๊กอิน @tencent-weixin/openclaw-weixin เชื่อมต่อบัญชี WeChat ส่วนตัวของคุณเข้ากับเกตเวย์ AI ของ OpenClaw ได้ภายในไม่กี่นาที ไม่ต้องใช้บัญชีองค์กร ไม่มีค่าธรรมเนียมรายเดือน เพียงแค่สแกน QR โค้ด คุณก็พร้อมใช้งานได้ทันที
คู่มือนี้จะพาคุณไปตลอดการตั้งค่าที่สมบูรณ์ ตั้งแต่การติดตั้งปลั๊กอิน ไปจนถึงการจัดการหลายบัญชีและการแยกบริบทการสนทนา เมื่อเสร็จสิ้น WeChat ของคุณจะมีผู้ช่วย AI ที่ทำงานได้อย่างสมบูรณ์บน OpenClaw
ข้อกำหนดเบื้องต้น
ก่อนเริ่มต้น คุณต้องมีสิ่งเหล่านี้:
- ติดตั้ง OpenClaw แล้ว (เวอร์ชัน
>=2026.3.22สำหรับปลั๊กอิน v2.0.x) - มี
openclawCLI ในเทอร์มินัลของคุณ - บัญชี WeChat (บัญชีส่วนตัวใช้งานได้ — ไม่ต้องใช้บัญชีองค์กร)
- ติดตั้ง Node.js แล้ว (สำหรับการติดตั้งแบบคลิกเดียว)
ตรวจสอบเวอร์ชัน OpenClaw ของคุณ:
openclaw --version
หากคุณใช้เวอร์ชันเก่ากว่า ให้อัปเดตก่อน ปลั๊กอิน v2.0.x ต้องใช้ OpenClaw >=2026.3.22
ความเข้ากันได้ของปลั๊กอิน
| เวอร์ชันปลั๊กอิน | เวอร์ชัน OpenClaw | สถานะ |
|---|---|---|
| 2.0.x | >=2026.3.22 |
ใช้งานอยู่ |
| 1.0.x | >=2026.1.0 <2026.3.22 |
อยู่ระหว่างการบำรุงรักษา |
ปลั๊กอินจะตรวจสอบเวอร์ชันของโฮสต์เมื่อเริ่มต้น หากเวอร์ชัน OpenClaw ของคุณไม่อยู่ในช่วงที่กำหนด ปลั๊กอินจะไม่โหลด
ขั้นตอนที่ 1: ติดตั้งปลั๊กอิน
ตัวเลือก A: ติดตั้งแบบคลิกเดียว (แนะนำ)
npx -y @tencent-weixin/openclaw-weixin-cli install
สิ่งนี้จะจัดการทุกอย่างโดยอัตโนมัติ — การติดตั้งปลั๊กอิน การกำหนดค่า และการตั้งค่าเริ่มต้น
ตัวเลือก B: ติดตั้งด้วยตนเอง
หากโปรแกรมติดตั้งแบบคลิกเดียวไม่ทำงานบนระบบของคุณ ให้ติดตั้งด้วยตนเอง:
1. ติดตั้งปลั๊กอิน:
openclaw plugins install "@tencent-weixin/openclaw-weixin"
2. เปิดใช้งานปลั๊กอิน:
openclaw config set plugins.entries.openclaw-weixin.enabled true
ขั้นตอนที่ 2: สแกน QR โค้ดเพื่ออนุญาต WeChat
เมื่อติดตั้งปลั๊กอินแล้ว ให้เข้าสู่ระบบด้วยบัญชี WeChat ของคุณ:
openclaw channels login --channel openclaw-weixin
QR โค้ดจะปรากฏในเทอร์มินัลของคุณ เปิด WeChat บนโทรศัพท์ แตะไอคอนสแกน แล้วสแกนโค้ด ยืนยันการอนุญาตบนโทรศัพท์ของคุณ

ข้อมูลประจำตัวการเข้าสู่ระบบของคุณจะถูกบันทึกไว้ในเครื่องโดยอัตโนมัติ ไม่จำเป็นต้องสแกนอีกครั้งเว้นแต่คุณจะออกจากระบบ
ขั้นตอนที่ 3: รีสตาร์ทเกตเวย์
หลังจากให้สิทธิ์แล้ว ให้รีสตาร์ทเกตเวย์ OpenClaw เพื่อเปิดใช้งานปลั๊กอิน:
openclaw gateway restart
เรียบร้อย บัญชี WeChat ของคุณเชื่อมต่อกับ OpenClaw แล้ว ข้อความที่ส่งไปยัง WeChat ของคุณจะถูกประมวลผลโดยตัวแทน AI
ขั้นตอนที่ 4: เพิ่มบัญชี WeChat หลายบัญชี (ไม่บังคับ)
OpenClaw รองรับบัญชี WeChat หลายบัญชีพร้อมกัน หากต้องการเพิ่มบัญชีอื่น เพียงแค่รันคำสั่งเข้าสู่ระบบอีกครั้ง:
openclaw channels login --channel openclaw-weixin
การสแกน QR โค้ดแต่ละครั้งจะสร้างรายการบัญชีใหม่ บัญชีทั้งหมดจะทำงานพร้อมกันโดยไม่รบกวนซึ่งกันและกัน
ขั้นตอนที่ 5: แยกบริบทการสนทนา (ไม่บังคับ)
โดยค่าเริ่มต้น ทุกช่องทางจะใช้บริบทการสนทนา AI เดียวกัน ซึ่งหมายความว่าการสนทนา WeChat ของคุณและช่องทางอื่น ๆ (Telegram, Discord ฯลฯ) จะใช้หน่วยความจำ AI เดียวกัน
หากคุณต้องการให้บัญชี WeChat แต่ละบัญชีมีบริบทแยกเป็นของตัวเอง:
openclaw config set agents.mode per-channel-per-peer
ด้วยการตั้งค่านี้ ทุกการรวมกันของ "บัญชี WeChat + ผู้ติดต่อ" จะได้รับหน่วยความจำ AI อิสระเป็นของตัวเอง การสนทนาระหว่างบัญชีที่แตกต่างกันจะไม่ปะปนกัน
ปลั๊กอินทำงานอย่างไรเบื้องหลัง
สำหรับนักพัฒนาที่ต้องการทำความเข้าใจหรือขยายปลั๊กอิน นี่คือวิธีการสื่อสารกับเกตเวย์ OpenClaw
ส่วนหัวการรับรองความถูกต้อง
คำขอ API ทั้งหมดใช้ส่วนหัวเหล่านี้:
| ส่วนหัว | ค่า |
|---|---|
Content-Type |
application/json |
AuthorizationType |
ilink_bot_token |
Authorization |
Bearer <token> |
X-WECHAT-UIN |
uint32 แบบสุ่มเข้ารหัสเป็น base64 |
จุดสิ้นสุด API หลัก
ปลั๊กอินใช้ 5 จุดสิ้นสุด HTTP JSON:
| จุดสิ้นสุด | เส้นทาง | วัตถุประสงค์ |
|---|---|---|
| getUpdates | getupdates |
การส่งข้อความแบบ Long-poll เพื่อรับข้อความใหม่ |
| sendMessage | sendmessage |
ส่งข้อความ/รูปภาพ/วิดีโอ/ไฟล์ |
| getUploadUrl | getuploadurl |
รับ URL อัปโหลด CDN สำหรับสื่อ |
| getConfig | getconfig |
รับการกำหนดค่าบัญชี (typing ticket) |
| sendTyping | sendtyping |
แสดง/ซ่อนตัวบ่งชี้การพิมพ์ |
การรับข้อความ (Long Polling)
ปลั๊กอินใช้ long polling เพื่อรับข้อความ:
// คำขอ
{
"get_updates_buf": ""
}
// การตอบกลับ
{
"ret": 0,
"msgs": [...],
"get_updates_buf": "<new_cursor>",
"longpolling_timeout_ms": 35000
}
ส่งเคอร์เซอร์ get_updates_buf กลับไปในการร้องขอแต่ละครั้งเพื่อรับเฉพาะข้อความใหม่เท่านั้น
การส่งข้อความ
{
"msg": {
"to_user_id": "<target_user_id>",
"context_token": "<session_context_token>",
"item_list": [
{
"type": 1,
"text_item": { "text": "สวัสดี!" }
}
]
}
}
ประเภทข้อความ
| ประเภท | ค่า |
|---|---|
| TEXT | 1 |
| IMAGE | 2 |
| VOICE | 3 |
| FILE | 4 |
| VIDEO | 5 |
การอัปโหลดสื่อ (รูปภาพ, ไฟล์, วิดีโอ)
ไฟล์สื่อจะถูกเข้ารหัสด้วย AES-128-ECB ก่อนการอัปโหลด ขั้นตอนมีดังนี้:
- เรียกใช้
getUploadUrlพร้อมข้อมูลเมตาของไฟล์ (ขนาด, MD5) - รับพารามิเตอร์การอัปโหลด CDN ที่ลงนามล่วงหน้า
- เข้ารหัสไฟล์ด้วย AES-128-ECB
- อัปโหลดไปยัง CDN โดยใช้ URL ที่ลงนามล่วงหน้า
- อ้างอิงไฟล์ CDN ใน
sendMessage
ปัญหาทั่วไปและการแก้ไข
ปลั๊กอินไม่ยอมโหลด
ข้อผิดพลาด: ปลั๊กอินปฏิเสธการโหลดเมื่อเริ่มต้น
วิธีแก้ไข: ตรวจสอบเวอร์ชัน OpenClaw ของคุณ ปลั๊กอิน v2.0.x ต้องใช้ >=2026.3.22
openclaw --version
# หากล้าสมัย ให้อัปเดต OpenClaw ก่อน
QR โค้ดหมดอายุ
ข้อผิดพลาด: QR โค้ดหมดเวลาก่อนที่จะสแกน
วิธีแก้ไข: รันคำสั่งเข้าสู่ระบบอีกครั้ง QR โค้ดจะหมดอายุหลังจากประมาณ 30 วินาที
openclaw channels login --channel openclaw-weixin
ไม่ได้รับข้อความ
ข้อผิดพลาด: ข้อความ WeChat ไม่ถึง OpenClaw
วิธีแก้ไข: รีสตาร์ทเกตเวย์หลังจากเข้าสู่ระบบ
openclaw gateway restart
หลายบัญชีใช้บริบทปะปนกัน
ข้อผิดพลาด: การตอบกลับของ AI จากบัญชีหนึ่งปรากฏในอีกบัญชีหนึ่ง
วิธีแก้ไข: เปิดใช้งานการแยกบริบทต่อช่องทาง
openclaw config set agents.mode per-channel-per-peer
กรณีการใช้งานจริง
ผู้ช่วย AI ส่วนตัว
เชื่อมต่อ WeChat ส่วนตัวของคุณเข้ากับ OpenClaw และให้ผู้ช่วย AI ตอบกลับข้อความเมื่อคุณไม่ว่าง ตั้งค่าการแยกบริบทเพื่อให้ผู้ติดต่อแต่ละรายได้รับการตอบกลับส่วนบุคคลตามประวัติการสนทนาของพวกเขา
การสนับสนุนลูกค้าสำหรับธุรกิจขนาดเล็ก
รันบัญชี WeChat หลายบัญชีสำหรับสายธุรกิจที่แตกต่างกัน แต่ละบัญชีจะจัดการข้อสงสัยของลูกค้าด้วยหน่วยความจำ AI ที่แยกต่างหาก ไม่มีการปะปนกันระหว่างบัญชี
การทดสอบสำหรับนักพัฒนา
ใช้ HTTP JSON API เพื่อสร้างการเชื่อมต่อแบบกำหนดเอง โปรโตคอลแบ็กเอนด์ของปลั๊กอินมีเอกสารครบถ้วน ทำให้ง่ายต่อการขยายหรือแทนที่พฤติกรรมเริ่มต้น
สรุป
การตั้งค่า OpenClaw กับ WeChat ใช้เวลาไม่ถึง 5 นาที ติดตั้งปลั๊กอิน สแกน QR โค้ด รีสตาร์ทเกตเวย์ — เสร็จสิ้น การตั้งค่าฟรีนี้รองรับหลายบัญชี การแยกบริบท และการรองรับสื่อเต็มรูปแบบ (รูปภาพ เสียง ไฟล์ วิดีโอ)
สำหรับนักพัฒนา HTTP JSON API ที่มีเอกสารครบถ้วนทำให้การเชื่อมต่อแบบกำหนดเองเป็นเรื่องง่าย
เริ่มต้นด้วยโปรแกรมติดตั้งแบบคลิกเดียว:
npx -y @tencent-weixin/openclaw-weixin-cli install
ขั้นตอนต่อไป: เมื่อบอท WeChat ของคุณทำงานแล้ว คุณอาจจะต้องเชื่อมต่อกับ API ภายนอก เช่น เกตเวย์การชำระเงิน, CRMs, บริการสภาพอากาศ ฯลฯ ทดสอบ API ของคุณด้วย Apidog เพื่อให้แน่ใจว่าบอทของคุณส่งข้อมูลที่ถูกต้องทุกครั้ง มีแพ็กเกจฟรีให้บริการ ไม่ต้องใช้บัตรเครดิต
คำถามที่พบบ่อย
ถาม: สิ่งนี้ใช้ได้กับบัญชี WeChat ส่วนตัวหรือไม่?
ตอบ: ได้ ไม่เหมือนเครื่องมืออัตโนมัติ WeChat ส่วนใหญ่ ปลั๊กอินนี้ทำงานได้กับบัญชีส่วนตัว ไม่จำเป็นต้องมีบัญชีองค์กรหรือบัญชีทางการ
ถาม: ปลั๊กอินนี้ฟรีหรือไม่?
ตอบ: ได้ ปลั๊กอิน @tencent-weixin/openclaw-weixin ฟรีและเป็นโอเพนซอร์ส คุณเพียงแค่ต้องมีการติดตั้ง OpenClaw ที่ใช้งานได้
ถาม: ฉันสามารถรันบัญชี WeChat หลายบัญชีพร้อมกันได้หรือไม่?
ตอบ: ได้ รัน openclaw channels login --channel openclaw-weixin สำหรับแต่ละบัญชี บัญชีทั้งหมดจะทำงานพร้อมกัน
ถาม: จะเกิดอะไรขึ้นหากฉันรีสตาร์ทคอมพิวเตอร์?
ตอบ: ข้อมูลประจำตัวการเข้าสู่ระบบจะถูกบันทึกไว้ในเครื่อง คุณไม่จำเป็นต้องสแกน QR โค้ดอีกครั้งหลังจากรีสตาร์ท เพียงแค่รีสตาร์ทเกตเวย์ด้วย openclaw gateway restart
ถาม: ฉันสามารถสร้างการเชื่อมต่อแบบกำหนดเองเพิ่มเติมจากสิ่งนี้ได้หรือไม่?
ตอบ: ได้ ปลั๊กอินนี้เปิดเผย HTTP JSON API ที่มีเอกสารประกอบพร้อม 5 จุดสิ้นสุด: getUpdates, sendMessage, getUploadUrl, getConfig, และ sendTyping หากบอทของคุณต้องการเรียกใช้บริการภายนอก ให้ใช้ Apidog เพื่อทดสอบและตรวจสอบการเชื่อมต่อ API ของคุณก่อนที่จะเผยแพร่จริง
