openclaw qr

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

การใช้งาน

openclaw qropenclaw qr --setup-code-onlyopenclaw qr --jsonopenclaw qr --remoteopenclaw 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 หลักพร้อม scopes: [] และโทเค็นส่งต่อ operator แบบมีขอบเขตสำหรับการเริ่มใช้งานมือถือที่เชื่อถือได้
• โทเค็นตัวดำเนินการที่ส่งต่อถูกจำกัดไว้ที่ operator.approvals, operator.read, operator.talk.secrets และ operator.write; สโคปการกลายพันธุ์การจับคู่และ operator.admin ยังคงต้องใช้การจับคู่ตัวดำเนินการหรือโฟลว์โทเค็นที่ได้รับอนุมัติแยกต่างหาก
• การจับคู่อุปกรณ์มือถือจะล้มเหลวแบบปิดสำหรับ URL Gateway ws:// แบบ Tailscale/สาธารณะ ที่อยู่ 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 SecretRefs สำหรับการยืนยันตัวตน Gateway ภายในเครื่องจะถูก 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 iOS และ Android อย่างเป็นทางการจะเชื่อมต่อโดยอัตโนมัติเมื่อเมทาดาทารหัสตั้งค่าตรงกัน หากคำขอยังคงรอดำเนินการ (เช่น สำหรับไคลเอนต์ที่ไม่เป็นทางการหรือเมทาดาทาไม่ตรงกัน) ให้ตรวจสอบและอนุมัติด้วย:
  • openclaw devices list
  • openclaw devices approve <requestId>

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

• ข้อมูลอ้างอิง CLI
• การจับคู่