Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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): 
{
  "timeoutMs": 10000,
  "maxAgeMs": 15000,
  "desiredAccuracy": "coarse|balanced|precise"
}
Payload respons: 
{
  "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