位置命令

- location.get 是一个节点命令（通过 node.invoke）。

- 默认关闭。

- 配置使用选择器：关闭 / 使用中 / 始终。

- 独立开关：精确位置。

操作系统权限是多级的。我们可以在应用中公开选择器，但操作系统决定实际授予的权限。

- iOS/macOS：用户可以在系统提示/设置中选择使用中或始终。应用可以请求升级，但操作系统可能需要设置。

- Android：后台位置是单独的权限；Android 10+ 通常需要设置流程。

- 精确位置是单独的授予（iOS 14+ "精确"，Android "fine" 与 "coarse"）。

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

每个节点设备：

- location.enabledMode：off | whileUsing | always

- location.preciseEnabled：布尔值

UI 行为：

- 选择 whileUsing 请求前台权限。

- 选择 always 首先确保存 whileUsing，然后请求后台（如果需要，将用户发送到设置）。

- 如果操作系统拒绝请求的级别，则恢复到授予的最高级别并显示状态。

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

通过 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：系统故障 / 无提供者。

目标：即使节点在后台，模型也可以请求位置，但前提是：

- 用户选择了始终。

- 操作系统授予了后台位置。

- 应用被允许后台运行（iOS 后台模式 / Android 前台服务或特殊许可）。

推送触发流程（未来）：

1. 网关向节点发送推送（静默推送或 FCM 数据）。

2. 节点临时唤醒并从设备请求位置。

3. 节点将负载转发回网关。

注意：

- iOS：需要始终权限 + 后台位置模式。静默推送可能会受到限制；预期断歇性失败。

- Android：后台位置可能需要前台服务；否则预期拒绝。

- 工具表面：nodes 工具添加 location_get 动作（需要节点）。

- CLI：openclaw nodes location get --node <id>。

- Agent 指南：仅在用户启用了位置并理解范围时调用。

- 关闭："位置共享已禁用。"

- 使用中："仅当 OpenClaw 打开时。"

- 始终："允许后台位置。需要系统权限。"

- 精确："使用精确 GPS 位置。切换关闭以共享大致位置。"