位置感知

此技能提供需执行的命令。当用户询问位置时，请运行以下适当的命令。

⚠️ 重要提示：所有命令均使用scripts/location.sh

每条命令都必须通过scripts/location.sh运行。例如：

用户提问："步行回家要多久？"
您运行：

scripts/location.sh eta home --mode walk

输出： 4.6公里，步行约45分钟
您直接回复该输出。

请勿直接运行eta或其他子命令——它们不作为独立命令存在。

快速参考——需运行的内容

回复风格：简洁。无需开场白。不要说“这是您的位置：”。直接给出答案。

所有命令

均通过scripts/location.sh <命令>执行：

注意： eta接受已保存的地点名称、坐标 (纬度,经度)，或任何地点名称（通过OpenStreetMap进行地理编码，偏向当前位置）。

注意： status如果在已知地点，则返回区域名称；否则，通过反向地理编码返回街道地址（例如，“市中心主街123号”）。

概念

地理围栏— 保存的地点，包含纬度/经度、半径和可选操作。持久保存。

提醒事项— 与地点关联的一次性提醒。送达后删除。

区域/类别— 用于筛选的可选标签（例如，“市中心”、“酒吧”）。

设置（面向管理员）

提供商配置

编辑scripts/config.json：

Home Assistant（默认）：

{
  "provider": "homeassistant",
  "homeassistant": {
    "url": "https://your-ha.example.com",
    "token": "your-long-lived-token",
    "entity_id": "device_tracker.phone"
  }
}

OwnTracks：

{
  "provider": "owntracks",
  "owntracks": {
    "url": "https://owntracks.example.com",
    "user": "username",
    "device": "phone"
  }
}

通用HTTP：

{
  "provider": "http",
  "http": {
    "url": "https://your-api.com/location",
    "headers": {"Authorization": "Bearer token"}
  }
}

GPSLogger（基于文件）：

{
  "provider": "gpslogger",
  "gpslogger": {
    "file": "/path/to/location.json"
  }
}

密钥支持："env:VAR_NAME"（从环境变量读取）或纯字符串。

替代方案：完全通过环境变量配置（无需config.json）：

环境变量优先于 config.json 中的值。请在~/.openclaw/.env或你的 shell 环境。

输出格式：大多数查询命令默认输出人类可读的文本。添加--json以获得 JSON 输出（对脚本编写很有用）。

出行速度

在scripts/config.json中自定义步行/骑行速度，用于预计到达时间计算：

{
  "speeds_kmh": {
    "walk": 6,
    "bike": 15
  }
}

地理围栏配置

编辑scripts/geofences.json：

{
  "geofences": [
    {
      "id": "grocery",
      "name": "Grocery Store",
      "lat": 40.7128,
      "lon": -74.0060,
      "radius_m": 30,
      "action": "shopping_tasks",
      "cooldown_hours": 4,
      "enabled": true,
      "region": "downtown",
      "category": "shop"
    }
  ],
  "location_reminders": [],
  "proximity_alerts": []
}

自动通知（OpenClaw Cron）

使用 OpenClaw 内置的 cron 来运行定期的位置检查。在~/.openclaw/cron/jobs.json中添加一个任务：

{
  "name": "Location Check",
  "schedule": "*/5 * * * *",
  "prompt": "Run scripts/location.sh check --json and notify me of any triggered actions, reminders, or proximity alerts.",
  "channel": "signal",
  "to": "+1234567890",
  "wakeMode": "now"
}

这使调度保持在 OpenClaw 内部，而不需要外部的 systemd 服务。