​

Lệnh vị trí (các node)

​

Tóm tắt nhanh

• location.get là lệnh cho node (thông qua node.invoke).
• Mặc định tắt.
• Cài đặt ứng dụng Android sử dụng bộ chọn: Tắt / Khi Sử Dụng.
• Công tắc riêng: Vị trí Chính Xác.

​

Tại sao dùng bộ chọn (không chỉ là công tắc)

• iOS/macOS có thể hiển thị Khi Sử Dụng hoặc Luôn Luôn trong thông báo hệ thống/Cài đặt.
• Ứng dụng Android hiện chỉ hỗ trợ vị trí nền trước.
• Vị trí chính xác là quyền riêng biệt (iOS 14+ “Chính Xác”, Android “chính xác” so với “gần đúng”).

​

Mô hình cài đặt

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

• Chọn whileUsing yêu cầu quyền nền trước.
• Nếu hệ điều hành từ chối cấp độ yêu cầu, quay lại cấp độ cao nhất đã được cấp và hiển thị trạng thái.

​

Ánh xạ quyền truy cập (node.permissions)

​

Lệnh: location.get

{
  "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: bộ chọn đang tắt.
• LOCATION_PERMISSION_REQUIRED: thiếu quyền cho chế độ yêu cầu.
• LOCATION_BACKGROUND_UNAVAILABLE: ứng dụng đang chạy nền nhưng chỉ cho phép Khi Sử Dụng.
• LOCATION_TIMEOUT: không có kết quả trong thời gian quy định.
• LOCATION_UNAVAILABLE: lỗi hệ thống / không có nhà cung cấp.

​

Hành vi nền

• Ứng dụng Android từ chối location.get khi chạy nền.
• Giữ OpenClaw mở khi yêu cầu vị trí trên Android.
• Các nền tảng node khác có thể khác.

​

Tích hợp mô hình/công cụ

• Bề mặt công cụ: công cụ nodes thêm hành động location_get (cần node).
• CLI: openclaw nodes location get --node <id>.
• Hướng dẫn cho agent: chỉ gọi khi người dùng đã bật vị trí và hiểu phạm vi.

​

Nội dung UX (đề xuất)

• Tắt: “Chia sẻ vị trí đã bị vô hiệu hóa.”
• Khi Sử Dụng: “Chỉ khi OpenClaw đang mở.”
• Chính Xác: “Sử dụng vị trí GPS chính xác. Tắt để chia sẻ vị trí gần đúng.”