核心用法
location-awareness 是一个多源位置服务聚合工具，支持 Home Assistant、OwnTracks、GPSLogger 及通用 HTTP API 四种数据源。用户可通过单一命令接口 scripts/location.sh 完成位置查询、地理围栏管理、智能提醒、POI 发现及出行规划等操作。
主要功能模块：
- 实时定位：获取当前坐标、所在区域及地图链接
- ETA 计算：支持步行、骑行、驾车三种模式，基于 OpenStreetMap 数据估算时间与距离
- 地理围栏：自定义半径、区域标签、冷却时间，支持启用/禁用及自动化触发
- 位置提醒：一次性到达提醒，触发后自动删除
- 历史追溯：查询特定地点的到访时间、今日轨迹及停留时长统计
- POI 发现：按类别（咖啡馆、酒吧等）搜索周边设施，支持距离筛选
显著优点
1. 隐私优先设计：支持自托管数据源（Home Assistant、GPSLogger），位置数据无需经过第三方云服务；纯本地配置文件管理，支持环境变量注入敏感信息
2. 多源兼容性：四种主流方案覆盖从智能家居生态到极简文件追踪的不同场景
3. 灵活的自动化集成：通过 OpenClaw 内置 cron 实现周期性检查与通知，无需外部 systemd 服务
4. 语义化地理围栏：支持区域（region）和类别（category）标签，便于批量筛选与管理
5. 离线友好：基于 OpenStreetMap 的地理编码与 POI 数据，减少商业 API 依赖
潜在缺点与局限性
- 数据源依赖：需用户自行配置并维护 Home Assistant、OwnTracks 或 GPSLogger，无开箱即用的托管服务
- 精度受限：GPSLogger 文件模式存在刷新延迟；HTTP 模式依赖外部 API 稳定性
- 移动端适配：无原生移动应用，依赖第三方追踪工具的数据推送
- 电池消耗：持续 GPS 追踪对移动设备电量影响需用户自行权衡
- 地理编码局限：OpenStreetMap 在某些地区的 POI 覆盖度和地址解析准确性可能不及 Google Maps
适合人群
- 已部署 Home Assistant 或注重自托管隐私的技术用户
- 需要基于位置的自动化工作流（如到家触发家务提醒、离开公司发送状态更新）
- 通勤规划与日常轨迹管理的效率工具爱好者
- 对商业位置服务数据收集持谨慎态度的隐私敏感用户
常规风险
- 位置数据泄露：配置文件若权限设置不当，可能导致家庭坐标等敏感信息暴露
- API 令牌管理：Home Assistant/OwnTracks 的长期访问令牌需安全存储，建议优先使用环境变量注入
- 地理围栏误触发：半径设置过小或 GPS 漂移可能导致频繁误报；冷却时间配置不当可能遗漏有效触发
- 自动化依赖：cron 任务若配置错误可能导致提醒遗漏或重复通知