位置命令（Nodes）

简要说明

• location.get 是节点命令（通过 node.invoke 调用）。
• 默认关闭。
• Android 应用设置使用选择器：关闭 / 使用时开启。
• 独立开关：精确位置。

为什么用选择器而不是简单开关

操作系统权限是多级的。我们可以在应用内暴露选择器，但实际授权由操作系统决定。

• iOS/macOS 可能在系统提示/设置中提供使用时或始终选项。
• Android 应用目前仅支持前台位置。
• 精确位置是独立授权（iOS 14+ 的"精确"、Android 的"精细"与"粗略"）。

UI 中的选择器驱动我们请求的模式；实际授权保存在操作系统设置中。

设置模型

每个节点设备：

• location.enabledMode：off | whileUsing
• location.preciseEnabled：布尔值

UI 行为：

• 选择 whileUsing 会请求前台权限。
• 操作系统拒绝请求的级别时，回退到最高已授权级别并显示状态。

权限映射（node.permissions）

可选。macOS 节点通过权限映射上报 location；iOS/Android 可能省略。

命令：location.get

通过 node.invoke 调用。

参数（建议）：

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

响应载荷：

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

错误码（稳定）：

• LOCATION_DISABLED：选择器已关闭。
• LOCATION_PERMISSION_REQUIRED：请求的模式缺少权限。
• LOCATION_BACKGROUND_UNAVAILABLE：应用在后台但仅授予了"使用时"权限。
• LOCATION_TIMEOUT：未能在时限内获取定位。
• LOCATION_UNAVAILABLE：系统故障/无提供商。

后台行为

• Android 应用在后台时拒绝 location.get。
• 在 Android 上请求位置时，请保持 OpenClaw 在前台运行。
• 其他节点平台行为可能不同。

模型/工具集成

• 工具接口：nodes 工具添加 location_get 动作（需要节点）。
• CLI：openclaw nodes location get --node <id>。
• Agent 指南：仅在用户启用位置并了解范围时调用。

建议的 UX 文案

• 关闭："位置共享已禁用。"
• 使用时开启："仅在 OpenClaw 打开时共享位置。"
• 精确："使用精确 GPS 定位。关闭后共享近似位置。"