4月 19, 2026

OpenClaw Node 定位（Location）功能完整攻略｜初學者指南：取得座標、權限設定、錯誤排除

OpenClaw Node 定位（Location）功能完整攻略

這是給 OpenClaw 初學者的教學文章，幫助你了解如何使用 OpenClaw Node 的定位功能。

測試日期：2026-04-19

測試節點：V2514（Vivo V2514, Android 16）

OpenClaw 版本：ui v2026.4.17-dev

一、什麼是 Location 功能？

想像一下

當你連接手機到 OpenClaw Gateway 後，AI 助手可以幫你取得手機的目前位置。

這個功能可以用在：

📍 問 AI「我現在在哪裡？」取得座標
🏠 結合日曆功能，自動記錄會議地點
📱 遠端確認手機位置（找手機時很有用）

二、Location 功能只有一個指令

指令	功能	危險程度
`location.get`	取得目前位置	✅ 安全（僅讀取）

沒有了！ Location 功能在 Android 上只有一個指令，非常單純。

三、location.get 完整說明

基本用法

openclaw nodes invoke --node "V2514" --command location.get --params '{}'

實際回傳

{
  "ok": true,
  
  "command": "location.get",
  "payload": {
    "lat": "已遮蔽",
    "lon": "已遮蔽",
    "accuracyMeters": 100,
    "altitudeMeters": 95.9000015258789,
    "timestamp": "2026-04-19T05:06:45.410Z",
    "isPrecise": true,
    "source": "network"
  },
  "payloadJSON": null
}

欄位說明

欄位	說明	範例值
`lat`	緯度	（已遮蔽）
`lon`	經度	（已遮蔽）
`accuracyMeters`	精確度（公尺）	`100`（誤差約 100 公尺）
`altitudeMeters`	海拔高度（公尺）	`95.9`
`timestamp`	時間戳記（ISO 格式）	`2026-04-19T05:06:45.410Z`
`isPrecise`	是否為精確位置	`true` / `false`
`source`	位置來源	`gps`、`wifi`、`cell`、`network`、`unknown`

四、支援的參數

完整參數範例

openclaw nodes invoke --node "V2514" --command location.get --params '{
  "desiredAccuracy": "precise",
  "timeoutMs": 10000,
  "maxAgeMs": 15000
}'

參數說明

參數	類型	預設值	說明
`desiredAccuracy`	String	-	`"precise"`（精確 GPS）或 `"coarse"`（模糊）
`timeoutMs`	Long	`10000`	逾時時間（毫秒），範圍 1000-60000
`maxAgeMs`	Long	-	快取位置的最大年齡（毫秒）

參數組合測試結果

參數組合	isPrecise	source
`{}`（無參數）	`true`	`network`
`{"desiredAccuracy": "precise"}`	`true`	`network`
`{"desiredAccuracy": "coarse"}`	`false`	`network`

五、準確度說明

desiredAccuracy 選項

值	說明	精確度
`"precise"`	精確定位（使用 GPS）	約 10-100 公尺
`"coarse"`	模糊定位（網路基地台/WiFi）	約 100-1000 公尺

isPrecise 欄位含義

值	說明
`true`	使用精確位置（Fine Location）
`false`	使用模糊位置（Coarse Location）

六、位置來源說明（source）

值	說明
`gps`	GPS 衛星定位（最精確）
`wifi`	WiFi 定位
`cell`	行動網路基地台定位
`network`	網路定位（結合多種來源）
`unknown`	未知來源

七、重要限制

根據官方文件，Location 功能有一些重要限制：

1. 預設關閉

Location 功能預設是關閉的！ 需要在 OpenClaw App 設定中開啟。

開啟方式：

打開 OpenClaw App
找到「設定」或「Location」相關設定
選擇「While Using」（使用時）或「Always」（永遠）

2. 僅限前景

Android 的 OpenClaw App 在背景執行時，無法取得位置。取得位置時，App 必須在前景執行。

3. 需要權限

需要在手機設定中開啟「位置」權限：

精確位置（Precise）：使用 GPS，較精確但較耗電
模糊位置（Coarse）：使用網路，較不精確但較省電

八、錯誤代碼

如果位置取得失敗，可能收到以下錯誤：

錯誤代碼	說明	解決方法
`LOCATION_DISABLED`	Location 功能未開啟	在 App 設定中開啟位置
`LOCATIONPERMISSIONREQUIRED`	缺少位置權限	在手機設定中授權位置
`LOCATIONBACKGROUNDUNAVAILABLE`	App 在背景執行	把 OpenClaw App 放到前景
`LOCATION_TIMEOUT`	取得位置逾時	增加 timeoutMs 參數
`LOCATION_UNAVAILABLE`	系統無法取得位置	檢查網路連線或 GPS 是否正常

九、實用應用場景

場景一：隨時查詢位置

問 AI：「幫我查一下我現在在哪裡？」

AI 會回傳目前的經緯度座標。

場景二：結合日曆記錄地點

在建立會議時，讓 AI 自動記錄會議地點的座標。

場景三：確認手機位置

當手機不見時，遠端查詢手機目前位置（需要手機開機且連線）。

十、V2514 實際測試結果

測試環境

項目	值
裝置	Vivo V2514
系統	Android 16
位置權限	已授權（精確位置）

測試結果

測試	結果
取得位置	✅ 成功
精確度	100 公尺
位置來源	網路（network）
是否精確	true

V2514 目前位置

根據測試，V2514 目前位於：

📍 緯度：（已遮蔽）
📍 經度：（已遮蔽）
📍 地點：（已遮蔽）

十一、常見問題

Q: 為什麼收到的位置不精確？

可能原因：

使用了模糊定位（coarse）
GPS 訊號被遮蔽（室內、高樓大廈間）
網路定位精確度有限

解決方法：

確保在空曠戶外環境測試
使用 desiredAccuracy: "precise" 參數
確認手機有精確位置權限

Q: 為什麼一直取得不到位置？