คำสั่งตำแหน่งที่ตั้ง

# สรุปสั้น ๆ

• location.get เป็นคำสั่งของโหนด (ผ่าน node.invoke)
• ปิดโดยค่าเริ่มต้น
• การตั้งค่าแอป Android ใช้ตัวเลือก: ปิด / ขณะใช้งาน
• สวิตช์แยกต่างหาก: ตำแหน่งที่แม่นยำ

# ทำไมจึงใช้ตัวเลือก (ไม่ใช่แค่สวิตช์)

สิทธิ์ของระบบปฏิบัติการมีหลายระดับ เราสามารถแสดงตัวเลือกในแอปได้ แต่ระบบปฏิบัติการยังคงเป็นผู้ตัดสินการอนุญาตจริง

• iOS/macOS อาจแสดง ขณะใช้งาน หรือ เสมอ ในพรอมป์/การตั้งค่าของระบบ
• แอป Android ปัจจุบันรองรับเฉพาะตำแหน่งขณะใช้งานเบื้องหน้าเท่านั้น
• ตำแหน่งที่แม่นยำเป็นสิทธิ์แยกต่างหาก (iOS 14+ "แม่นยำ", Android "ละเอียด" เทียบกับ "คร่าว ๆ")

ตัวเลือกใน UI กำหนดโหมดที่เราขอ ส่วนการอนุญาตจริงอยู่ในการตั้งค่าของระบบปฏิบัติการ

# โมเดลการตั้งค่า

ต่ออุปกรณ์โหนด:

• location.enabledMode: off | whileUsing
• location.preciseEnabled: bool

พฤติกรรมของ UI:

• การเลือก whileUsing จะขอสิทธิ์เบื้องหน้า
• หากระบบปฏิบัติการปฏิเสธระดับที่ขอ ให้ย้อนกลับไปยังระดับสูงสุดที่ได้รับอนุญาตและแสดงสถานะ

# การแมปสิทธิ์ (node.permissions)

ไม่บังคับ โหนด macOS รายงาน location ผ่านแมปสิทธิ์; iOS/Android อาจไม่รายงาน

# คำสั่ง: location.get

เรียกผ่าน node.invoke

พารามิเตอร์ (แนะนำ):

{
  "timeoutMs": 10000,
  "maxAgeMs": 15000,
  "desiredAccuracy": "coarse|balanced|precise"
}

เพย์โหลดการตอบกลับ:

{
  "lat": 48.20849,
  "lon": 16.37208,
  "accuracyMeters": 12.5,
  "altitudeMeters": 182.0,
  "speedMps": 0.0,
  "headingDeg": 270.0,
  "timestamp": "2026-01-03T12:34:56.000Z",
  "isPrecise": true,
  "source": "gps|wifi|cell|unknown"
}

ข้อผิดพลาด (โค้ดแบบเสถียร):

• LOCATION_DISABLED: ตัวเลือกถูกปิด
• LOCATION_PERMISSION_REQUIRED: ไม่มีสิทธิ์สำหรับโหมดที่ขอ
• LOCATION_BACKGROUND_UNAVAILABLE: แอปอยู่เบื้องหลัง แต่อนุญาตเฉพาะขณะใช้งาน
• LOCATION_TIMEOUT: ไม่พบตำแหน่งทันเวลา
• LOCATION_UNAVAILABLE: ระบบล้มเหลว / ไม่มีผู้ให้บริการ

# พฤติกรรมเบื้องหลัง

• แอป Android ปฏิเสธ location.get ขณะอยู่เบื้องหลัง
• เปิด OpenClaw ค้างไว้เมื่อขอตำแหน่งบน Android
• แพลตฟอร์มโหนดอื่นอาจแตกต่างออกไป

# การผสานรวมกับโมเดล/เครื่องมือ

• พื้นผิวเครื่องมือ: เครื่องมือ nodes เพิ่มแอ็กชัน location_get (ต้องระบุโหนด)
• CLI: openclaw nodes location get --node <id>
• แนวทางสำหรับเอเจนต์: เรียกใช้เฉพาะเมื่อผู้ใช้เปิดใช้งานตำแหน่งและเข้าใจขอบเขตแล้ว

# ข้อความ UX (แนะนำ)

• ปิด: "การแชร์ตำแหน่งถูกปิดใช้งาน"
• ขณะใช้งาน: "เฉพาะเมื่อ OpenClaw เปิดอยู่"
• แม่นยำ: "ใช้ตำแหน่ง GPS ที่แม่นยำ ปิดสวิตช์เพื่อแชร์ตำแหน่งโดยประมาณ"

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

• การแยกวิเคราะห์ตำแหน่งของช่องทาง
• การจับภาพจากกล้อง
• โหมดพูดคุย