OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Nodes and media

Perintah lokasi

Ringkasan

  • location.get adalah perintah node yang dipanggil melalui node.invoke atau openclaw nodes location get.
  • Dinonaktifkan secara default.
  • Build Android pihak ketiga menggunakan pemilih: Nonaktif / Saat Digunakan / Selalu. Build Play tetap menggunakan Nonaktif / Saat Digunakan.
  • Lokasi Akurat merupakan pengalih terpisah.

Mengapa menggunakan pemilih (bukan sekadar pengalih)

Izin lokasi OS memiliki beberapa tingkat. Lokasi akurat juga merupakan izin OS yang terpisah (iOS 14+ "Precise", Android "fine" dibandingkan dengan "coarse"). Pemilih dalam aplikasi menentukan mode yang diminta, tetapi OS tetap menentukan izin yang benar-benar diberikan.

Model pengaturan

Per perangkat node:

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

Perilaku UI:

  • Memilih whileUsing akan meminta izin latar depan.
  • Memilih always dalam build Android pihak ketiga akan terlebih dahulu meminta izin latar depan, menjelaskan akses latar belakang, lalu membuka pengaturan aplikasi Android untuk izin Allow all the time yang terpisah.
  • Build Android Play tidak mendeklarasikan izin lokasi latar belakang atau menampilkan always.
  • Jika OS menolak tingkat yang diminta, aplikasi kembali ke tingkat tertinggi yang diberikan dan menampilkan status.

Pemetaan izin (node.permissions)

Opsional. Node macOS melaporkan location melalui peta permissions pada node.list/node.describe; iOS/Android dapat menghilangkannya.

Perintah: location.get

Dipanggil melalui node.invoke, atau pembantu CLI:

bash
openclaw nodes location get --node <idOrNameOrIp>openclaw nodes location get --node <idOrNameOrIp> --accuracy precise --max-age 15000 --location-timeout 10000

Parameter:

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

Flag CLI dipetakan secara langsung: --location-timeout -> timeoutMs, --max-age -> maxAgeMs, --accuracy -> desiredAccuracy.

Payload respons:

json
{  "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"}

Kesalahan (kode stabil):

  • LOCATION_DISABLED: pemilih dinonaktifkan.
  • LOCATION_PERMISSION_REQUIRED: izin untuk mode yang diminta belum diberikan.
  • LOCATION_BACKGROUND_UNAVAILABLE: aplikasi berada di latar belakang, tetapi hanya izin Saat Digunakan yang diberikan.
  • LOCATION_TIMEOUT: lokasi tidak diperoleh tepat waktu.
  • LOCATION_UNAVAILABLE: kegagalan sistem atau tidak ada penyedia.

Perilaku latar belakang

  • Build Android pihak ketiga menerima location.get di latar belakang hanya jika pengguna memilih Always dan Android memberikan izin lokasi latar belakang. Layanan node persisten yang sudah ada menambahkan jenis layanan location dan menampilkan Location: Always saat aktif.
  • Build Android Play dan mode While Using menolak location.get saat berada di latar belakang.
  • Platform node lainnya mungkin berbeda.

Integrasi model/peralatan

  • Alat agen: tindakan location_get milik alat nodes (node wajib ditentukan).
  • CLI: openclaw nodes location get --node <id>.
  • Panduan agen: hanya panggil jika pengguna telah mengaktifkan lokasi dan memahami cakupannya.

Teks UX (disarankan)

  • Nonaktif: "Berbagi lokasi dinonaktifkan."
  • Saat Digunakan: "Hanya saat OpenClaw terbuka."
  • Selalu: "Izinkan pemeriksaan lokasi yang diminta saat OpenClaw berada di latar belakang."
  • Akurat: "Gunakan lokasi GPS yang akurat. Nonaktifkan untuk membagikan perkiraan lokasi."

Terkait

Was this useful?
On this page

On this page