# openclaw qr

สร้าง QR สำหรับจับคู่อุปกรณ์มือถือและรหัสตั้งค่าจากการกำหนดค่า Gateway ปัจจุบันของคุณ

# การใช้งาน

openclaw qr
openclaw qr --setup-code-only
openclaw qr --json
openclaw qr --remote
openclaw qr --url wss://gateway.example/ws

# ตัวเลือก

• --remote: ให้ใช้ gateway.remote.url ก่อน หากไม่ได้ตั้งค่าไว้ gateway.tailscale.mode=serve|funnel ยังสามารถให้ URL สาธารณะระยะไกลได้
• --url <url>: แทนที่ URL ของ gateway ที่ใช้ในเพย์โหลด
• --public-url <url>: แทนที่ URL สาธารณะที่ใช้ในเพย์โหลด
• --token <token>: แทนที่ว่าโฟลว์บูตสแตรปจะยืนยันตัวตนกับโทเค็น gateway ใด
• --password <password>: แทนที่ว่าโฟลว์บูตสแตรปจะยืนยันตัวตนกับรหัสผ่าน gateway ใด
• --setup-code-only: พิมพ์เฉพาะรหัสตั้งค่า
• --no-ascii: ข้ามการเรนเดอร์ QR แบบ ASCII
• --json: ส่งออก JSON (setupCode, gatewayUrl, auth, urlSource)

# หมายเหตุ

• --token และ --password ใช้ร่วมกันไม่ได้
• ตอนนี้รหัสตั้งค่าเองจะพก bootstrapToken แบบไม่เปิดเผยรายละเอียดและมีอายุสั้น ไม่ใช่โทเค็น/รหัสผ่าน Gateway ที่ใช้ร่วมกัน
• ในโฟลว์บูตสแตรป Node/operator ในตัว โทเค็น Node หลักยังคงลงเอยด้วย scopes: []
• หากการส่งต่อบูตสแตรปออกโทเค็น operator ด้วย โทเค็นนั้นจะยังถูกจำกัดอยู่ในรายการอนุญาตของบูตสแตรป: operator.approvals, operator.read, operator.talk.secrets, operator.write
• การตรวจสอบ scope ของบูตสแตรปมีคำนำหน้าตามบทบาท รายการอนุญาตของ operator นั้นตอบสนองได้เฉพาะคำขอของ operator; บทบาทที่ไม่ใช่ operator ยังต้องมี scope ภายใต้คำนำหน้าบทบาทของตนเอง
• การจับคู่อุปกรณ์มือถือจะปิดการทำงานเมื่อ URL ของ Tailscale/Gateway สาธารณะเป็น ws:// ที่อยู่ LAN ส่วนตัวและโฮสต์ Bonjour .local ยังคงรองรับผ่าน ws:// แต่เส้นทางมือถือแบบ Tailscale/สาธารณะควรใช้ Tailscale Serve/Funnel หรือ URL ของ Gateway แบบ wss://
• เมื่อใช้ --remote OpenClaw ต้องมี gateway.remote.url หรือ gateway.tailscale.mode=serve|funnel
• เมื่อใช้ --remote หากข้อมูลประจำตัวระยะไกลที่มีผลใช้งานอยู่ถูกกำหนดค่าเป็น SecretRefs และคุณไม่ได้ส่ง --token หรือ --password คำสั่งจะ resolve ค่าจากสแนปช็อต Gateway ที่ใช้งานอยู่ หาก gateway ไม่พร้อมใช้งาน คำสั่งจะล้มเหลวทันที
• เมื่อไม่ใช้ --remote local gateway auth SecretRefs จะถูก resolve เมื่อไม่ได้ส่งการแทนที่การยืนยันตัวตนจาก CLI:
  • gateway.auth.token จะ resolve เมื่อการยืนยันตัวตนด้วยโทเค็นสามารถชนะได้ (gateway.auth.mode="token" แบบระบุชัดเจน หรือโหมดที่อนุมานเมื่อไม่มีแหล่งรหัสผ่านใดชนะ)
  • gateway.auth.password จะ resolve เมื่อการยืนยันตัวตนด้วยรหัสผ่านสามารถชนะได้ (gateway.auth.mode="password" แบบระบุชัดเจน หรือโหมดที่อนุมานเมื่อไม่มีโทเค็นจาก auth/env ใดชนะ)
• หากกำหนดค่าทั้ง gateway.auth.token และ gateway.auth.password ไว้ (รวมถึง SecretRefs) และไม่ได้ตั้งค่า gateway.auth.mode การ resolve รหัสตั้งค่าจะล้มเหลวจนกว่าจะตั้งค่าโหมดอย่างชัดเจน
• หมายเหตุเรื่องเวอร์ชัน Gateway ไม่ตรงกัน: เส้นทางคำสั่งนี้ต้องใช้ gateway ที่รองรับ secrets.resolve; gateway รุ่นเก่าจะส่งคืนข้อผิดพลาดวิธีการที่ไม่รู้จัก
• หลังจากสแกนแล้ว ให้อนุมัติการจับคู่อุปกรณ์ด้วย:
  • openclaw devices list
  • openclaw devices approve <requestId>

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

• เอกสารอ้างอิง CLI
• การจับคู่