location-awareness

📍 隐私优先的智能位置管家

牛津大学研究员开发的位置感知工具,支持多源GPS追踪与地理围栏,实现隐私友好的智能位置管理与提醒服务。

收藏
4.4k
安装
1.8k
版本
v1.2.0
CLS 安全性认证2026-05-02
点击查看完整报告 >

使用说明

核心用法

location-awareness 是一款隐私优先的位置感知 Skill,通过统一的 scripts/location.sh 命令接口,整合 Home Assistant、OwnTracks、GPS Logger 等多种位置数据源。用户可通过自然语言查询当前位置、计算到达时间(ETA)、设置基于位置的提醒、管理地理围栏、查询历史轨迹及发现周边兴趣点(POI)。所有命令均通过单一入口脚本执行,支持步行、骑行、驾车三种出行模式的智能时间估算。

显著优点

多源兼容与隐私设计:支持四种主流位置提供商,用户可自主选择数据托管方式,避免单一平台锁定;环境变量配置机制确保敏感凭证(如 API Token)不落入配置文件。

场景化智能服务:地理围栏支持自定义半径、冷却时间与触发动作,配合一次性位置提醒和接近警报,实现"到达超市时提醒买牛奶"这类精细化场景自动化。

开放生态整合:深度集成 OpenStreetMap 生态(Nominatim 地理编码、Overpass POI 搜索、OSRM 路线规划),无需商业地图 API 密钥即可使用核心功能。

OpenClaw 原生集成:通过内置 Cron 机制实现周期性位置检查,无需额外部署 systemd 服务,降低运维复杂度。

潜在缺点与局限性

外部服务依赖风险:核心功能依赖 OSRM 演示服务器、Overpass API 等第三方服务,存在服务中断或速率限制导致的可用性问题;OSRM 演示服务器使用 HTTP 明文传输,存在中间人攻击风险。

位置历史功能受限:历史轨迹查询能力完全取决于位置提供商的支持程度,部分数据源可能无法提供完整的时间线数据。

配置门槛较高:多提供商配置、地理围栏 JSON 编辑、Cron 任务设置等操作对非技术用户存在学习曲线。

精度与隐私权衡:GPS 坐标属于高敏感个人信息,尽管支持本地部署选项,但用户仍需自行承担数据泄露的合规责任。

适合的目标群体

  • 智能家居深度用户:已部署 Home Assistant 或 OwnTracks 的隐私敏感型技术爱好者
  • 效率工具追求者:需要基于位置的自动化提醒与行程规划的移动办公人群
  • 开源生态拥护者:偏好 OpenStreetMap 等开放数据、拒绝商业地图服务绑定的用户
  • 本地化隐私控:希望将位置数据保留在自有基础设施而非云端的企业或个人

使用风险

性能风险:Overpass API 复杂查询可能超时,OSRM 演示服务器在高负载下响应延迟;建议生产环境部署私有 OSRM 实例。

依赖项风险:Python 3 运行时与 requests 等库的版本兼容性需持续关注;GPSLogger 文件模式依赖本地文件系统权限。

数据持久化风险geofences.json.location_state.json 的并发读写未显式加锁,极端情况下可能损坏配置。

合规风险:欧盟 GDPR 等法规对精确位置数据的处理有严格要求,企业用户需评估数据留存策略。

安全解读

核心用法

该 skill 提供完整的位置感知能力,通过 scripts/location.sh 统一入口执行所有命令。核心功能包括:

  • 实时定位:查询当前位置、坐标或生成地图链接
  • ETA 计算:支持步行、骑行、驾车三种模式到任意地点的时间预估(基于 OSRM 开源路线引擎)
  • 地理围栏:保存常用地点,设置进出触发动作和冷却时间
  • 位置提醒:到达指定地点时触发一次性提醒
  • 历史追溯:查询在特定地点的停留时间、最近访问记录
  • POI 发现:搜索附近咖啡馆、酒吧等设施(基于 OpenStreetMap)

典型工作流:配置 Home Assistant / OwnTracks / GPSLogger 作为位置源 → 保存常去地点 → 设置基于位置的自动化规则 → 通过自然语言查询位置相关信息。

显著优点

1. 隐私优先设计:位置数据仅本地处理,不上传至第三方服务器(除用户自选的私有位置提供商外)
2. 多源兼容:支持 Home Assistant、OwnTracks、GPSLogger 及通用 HTTP 接口,无厂商锁定

3. 纯标准库实现:零第三方依赖,消除供应链攻击风险

4. 灵活的自动化:内置 cron 集成,支持周期性位置检查与通知推送

5. 开源服务依赖:地图、路线、POI 查询均使用 OpenStreetMap 等开源服务,无需 API 密钥

潜在缺点与局限性

  • OSRM HTTP 传输:路线规划 API 当前使用 HTTP 而非 HTTPS,存在中间人攻击风险(建议用户自行修改或等待更新)
  • 外部服务依赖:核心功能依赖位置提供商(HA/OwnTracks)的可用性,断网时无法获取实时位置
  • 无内置加密:本地存储的 geofence 配置和历史数据为明文 JSON,多用户环境需注意文件权限
  • 固定 User-Agent:使用 "Clawdbot/1.0" 标识,可能暴露使用环境
  • 文档待完善:缺乏明确的隐私政策说明和数据保留策略文档

适合人群

  • 已部署 Home Assistant 或 OwnTracks 的智能家居用户
  • 注重隐私、不愿将位置数据交给商业服务商的用户
  • 需要轻量级位置自动化(如"到家开灯""离开提醒")的技术爱好者
  • 希望自托管位置历史、避免云服务依赖的进阶用户

常规风险

| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 令牌泄露 | HA 令牌通过环境变量传递,配置不当可能暴露 | 确保 `~/.openclaw/.env` 权限为 600 |
| 中间人攻击 | OSRM 使用 HTTP 传输路线数据 | 手动修改为 HTTPS 或等待官方更新 |
| 数据本地暴露 | 位置历史以明文存储 | 单用户环境风险可控,多用户环境注意权限 |
| 服务可用性 | 依赖外部位置源和 OSM 服务 | 代码含错误处理,断网时优雅降级 |

location-awareness 内容

scripts文件夹
手动下载zip · 13.6 kB
config.jsonapplication/json
请选择文件