การจับคู่¶
“การจับคู่” คือขั้นตอนการ อนุมัติโดยเจ้าของ อย่างชัดเจนของ OpenClaw ใช้ในสองกรณี: ถูกใช้ในสองตำแหน่ง:
- การจับคู่DM (ใครบ้างที่ได้รับอนุญาตให้คุยกับบอต)
- การจับคู่โหนด (อุปกรณ์/โหนดใดบ้างที่ได้รับอนุญาตให้เข้าร่วมเครือข่าย Gateway)
บริบทด้านความปลอดภัย: Security
1. การจับคู่DM (การเข้าถึงแชทขาเข้า)¶
เมื่อกำหนดค่า channel ด้วยนโยบายDM pairing ผู้ส่งที่ไม่รู้จักจะได้รับรหัสสั้น และข้อความของพวกเขา จะไม่ถูกประมวลผล จนกว่าคุณจะอนุมัติ
นโยบายDMค่าเริ่มต้นมีเอกสารไว้ที่: Security
รหัสการจับคู่:
- ความยาว 8 ตัวอักษร ตัวพิมพ์ใหญ่ ไม่มีอักขระที่คลุมเครือ (
0O1I). - หมดอายุหลัง 1 ชั่วโมง หมดอายุภายใน 1 ชั่วโมง บอตจะส่งข้อความการจับคู่เฉพาะเมื่อมีการสร้างคำขอใหม่ (ประมาณหนึ่งครั้งต่อชั่วโมงต่อผู้ส่ง)
- คำขอจับคู่DMที่รอดำเนินการถูกจำกัดที่ 3 รายการต่อ channel โดยค่าเริ่มต้น คำขอเพิ่มเติมจะถูกเพิกเฉยจนกว่าจะมีรายการหนึ่งหมดอายุหรือได้รับการอนุมัติ
อนุมัติผู้ส่ง¶
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>
ช่องทางที่รองรับ: telegram, whatsapp, signal, imessage, discord, slack.
ตำแหน่งที่สถานะถูกจัดเก็บ¶
จัดเก็บภายใต้ ~/.openclaw/credentials/:
- คำขอที่รอดำเนินการ:
<channel>-pairing.json - ที่เก็บรายการอนุญาตที่ได้รับการอนุมัติ:
<channel>-allowFrom.json
ควรปฏิบัติต่อข้อมูลเหล่านี้เป็นข้อมูลอ่อนไหว(เป็นตัวควบคุมการเข้าถึงผู้ช่วยของคุณ)
2. การจับคู่อุปกรณ์โหนด (iOS/Android/macOS/โหนดแบบไม่แสดงผล)¶
โหนดจะเชื่อมต่อกับ Gateway ในฐานะ อุปกรณ์ ด้วย role: node Gateway
จะสร้างคำขอจับคู่อุปกรณ์ซึ่งต้องได้รับการอนุมัติ Gateway
สร้างคำขอจับคู่อุปกรณ์ที่ต้องได้รับการอนุมัติ
จับคู่ผ่าน Telegram (แนะนำสำหรับ iOS)¶
หากคุณใช้ปลั๊กอิน device-pair คุณสามารถทำการจับคู่อุปกรณ์ครั้งแรกได้ทั้งหมดจาก Telegram:
- ใน Telegram ส่งข้อความถึงบอตของคุณ:
/pair - บอตจะตอบกลับด้วย 2 ข้อความ: ข้อความคำแนะนำ และข้อความ setup code แยกต่างหาก (คัดลอก/วางได้ง่ายใน Telegram)
- บนโทรศัพท์ของคุณ เปิดแอป OpenClaw iOS → Settings → Gateway
- วาง setup code แล้วเชื่อมต่อ
- กลับมาที่ Telegram:
/pair approve
setup code คือ JSON payload ที่เข้ารหัสแบบ base64 ซึ่งประกอบด้วย:
url: Gateway WebSocket URL (ws://...หรือwss://...)token: โทเค็นสำหรับการจับคู่ที่มีอายุสั้น
ดูแล setup code เสมือนเป็นรหัสผ่านในช่วงเวลาที่มันยังใช้งานได้
อนุมัติอุปกรณ์โหนด¶
openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>
ที่จัดเก็บสถานะการจับคู่โหนด¶
จัดเก็บภายใต้ ~/.openclaw/devices/:
pending.json(อายุสั้น; คำขอที่รอดำเนินการจะหมดอายุ)paired.json(อุปกรณ์ที่จับคู่แล้ว + โทเคน)
หมายเหตุ¶
- API แบบเดิม
node.pair.*(CLI:openclaw nodes pending/approve) เป็นที่เก็บการจับคู่ที่ Gateway เป็นเจ้าของแยกต่างหาก โหนดแบบWSยังคงต้องใช้การจับคู่อุปกรณ์ โหนด WS ยังต้องมีการจับคู่อุปกรณ์