Nodes and media

Perintah lokasi

Ringkasan

location.get adalah perintah node (melalui node.invoke).
Nonaktif secara default.
Pengaturan aplikasi Android menggunakan pemilih: Nonaktif / Saat Digunakan.
Toggle terpisah: Lokasi Tepat.

Mengapa pemilih (bukan sekadar switch)

Izin OS bertingkat. Kita dapat mengekspos pemilih dalam aplikasi, tetapi OS tetap menentukan pemberian izin yang sebenarnya.

iOS/macOS dapat menampilkan Saat Digunakan atau Selalu di prompt/Pengaturan sistem.
Aplikasi Android saat ini hanya mendukung lokasi foreground.
Lokasi tepat adalah izin terpisah (iOS 14+ "Precise", Android "fine" vs "coarse").

Pemilih di UI mengarahkan mode yang kita minta; pemberian izin sebenarnya berada di pengaturan OS.

Model pengaturan

Per perangkat node:

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

Perilaku UI:

Memilih whileUsing meminta izin foreground.
Jika OS menolak tingkat yang diminta, kembalikan ke tingkat tertinggi yang diberikan dan tampilkan status.

Pemetaan izin (node.permissions)

Opsional. Node macOS melaporkan location melalui peta izin; iOS/Android dapat menghilangkannya.

Perintah: `location.get`

Dipanggil melalui node.invoke.

Parameter (disarankan):

json

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

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 nonaktif.
LOCATION_PERMISSION_REQUIRED: izin tidak ada untuk mode yang diminta.
LOCATION_BACKGROUND_UNAVAILABLE: aplikasi berjalan di latar belakang tetapi hanya Saat Digunakan yang diizinkan.
LOCATION_TIMEOUT: tidak ada fix tepat waktu.
LOCATION_UNAVAILABLE: kegagalan sistem / tidak ada penyedia.

Perilaku latar belakang

Aplikasi Android menolak location.get saat berjalan di latar belakang.
Biarkan OpenClaw tetap terbuka saat meminta lokasi di Android.
Platform node lain mungkin berbeda.

Integrasi model/tooling

Permukaan tool: tool nodes menambahkan tindakan location_get (node wajib).
CLI: openclaw nodes location get --node <id>.
Panduan agen: hanya panggil saat pengguna mengaktifkan lokasi dan memahami cakupannya.

Salinan UX (disarankan)

Nonaktif: "Berbagi lokasi dinonaktifkan."
Saat Digunakan: "Hanya saat OpenClaw terbuka."
Tepat: "Gunakan lokasi GPS yang tepat. Matikan toggle untuk membagikan lokasi perkiraan."

Terkait

Was this useful?