Chuyển đến nội dung chính

​
Lệnh vị trí (nodes)

​
Tóm tắt nhanh

  • location.get là một lệnh node (qua node.invoke).
  • Tắt theo mặc định.
  • Cài đặt dùng bộ chọn: Tắt / Khi đang dùng / Luôn luôn.
  • Công tắc riêng: Vị trí chính xác.

​
Vì sao dùng bộ chọn (không chỉ là công tắc)

Quyền hệ điều hành có nhiều cấp độ. Chúng tôi có thể hiển thị bộ chọn trong ứng dụng, nhưng hệ điều hành vẫn quyết định cấp quyền thực tế.
  • iOS/macOS: người dùng có thể chọn While Using hoặc Always trong các lời nhắc/Settings của hệ thống. Ứng dụng có thể yêu cầu nâng cấp, nhưng hệ điều hành có thể yêu cầu vào Settings.
  • Android: vị trí nền là một quyền riêng; trên Android 10+ thường cần một luồng qua Cài đặt.
  • Vị trí chính xác là một quyền riêng (iOS 14+ “Precise”, Android “fine” vs “coarse”).
Bộ chọn trong UI điều khiển chế độ ta yêu cầu; quyền thực tế nằm trong cài đặt hệ điều hành.

​
Mô hình cài đặt

Theo từng thiết bị node:
  • location.enabledMode: off | whileUsing | always
  • location.preciseEnabled: bool
Hành vi UI:
  • Chọn whileUsing sẽ yêu cầu quyền tiền cảnh.
  • Chọn always trước tiên đảm bảo whileUsing, sau đó yêu cầu quyền nền (hoặc đưa người dùng đến Cài đặt nếu cần).
  • Nếu hệ điều hành từ chối mức đã yêu cầu, quay về mức cao nhất đã được cấp và hiển thị trạng thái.

​
Ánh xạ quyền (node.permissions)

Tùy chọn. macOS node reports location via the permissions map; iOS/Android may omit it.

​
Lệnh: location.get

Được gọi qua node.invoke. Tham số (đề xuất): 
{
  "timeoutMs": 10000,
  "maxAgeMs": 15000,
  "desiredAccuracy": "coarse|balanced|precise"
}
Payload phản hồi: 
{
  "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"
}
Lỗi (mã ổn định):
  • 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 ở nền nhưng chỉ cho phép Khi đang dùng.
  • LOCATION_TIMEOUT: không có bản fix kịp thời.
  • LOCATION_UNAVAILABLE: lỗi hệ thống / không có nhà cung cấp.

​
Hành vi nền (tương lai)

Mục tiêu: mô hình có thể yêu cầu vị trí ngay cả khi node ở nền, nhưng chỉ khi:
  • Người dùng đã chọn Luôn luôn.
  • Hệ điều hành cấp quyền vị trí nền.
  • Ứng dụng được phép chạy nền cho vị trí (chế độ nền iOS / dịch vụ tiền cảnh Android hoặc cho phép đặc biệt).
Luồng kích hoạt bằng push (tương lai):
  1. Gateway gửi push tới node (silent push hoặc dữ liệu FCM).
  2. Node thức dậy trong thời gian ngắn và yêu cầu vị trí từ thiết bị.
  3. Node chuyển tiếp payload tới Gateway.
Ghi chú:
  • iOS: Always permission + background location mode required. Silent push may be throttled; expect intermittent failures.
  • Android: vị trí nền có thể yêu cầu dịch vụ tiền cảnh; nếu không, dự kiến sẽ bị từ chối.

​
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 (yêu cầu node).
  • CLI: openclaw nodes location get --node <id>.
  • Hướng dẫn cho tác tử: chỉ gọi khi người dùng đã bật vị trí và hiểu rõ phạm vi.

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

  • Tắt: “Chia sẻ vị trí đang bị tắt.”
  • Khi đang dùng: “Chỉ khi OpenClaw đang mở.”
  • Always: “Cho phép vị trí nền. Yêu cầu quyền hệ thống.”
  • Precise: “Sử dụng vị trí GPS chính xác. Tắt để chia sẻ vị trí xấp xỉ.”