位置感知服务

技能简介

该技能通过隐私友好的GPS追踪技术，实现个人位置管理与智能提醒。支持多源位置数据接入，包括Home Assistant、OwnTracks及通用GPS Logger，提供实时位置查询、基于位置的提醒设置、历史轨迹回溯、周边兴趣点搜索及行程统计分析等功能。

能做什么

• 查询当前位置坐标与所在区域名称
• 计算到指定地点的步行、骑行或驾车时间与距离
• 设置到达特定地点时的自动提醒
• 记录并管理常用地点（家、公司、自定义场所）
• 查看历史到访记录与停留时长统计
• 搜索周边餐厅、咖啡馆、酒吧等兴趣点
• 配置地理围栏规则，触发自动化动作

使用说明

安装要求：系统需预装Python 3环境。

配置步骤：

1. 克隆技能仓库至本地目录
2. 编辑 scripts/config.json 文件，选择位置数据提供方：
   • Home Assistant：填写实例URL、长期访问令牌及设备追踪实体ID
   • OwnTracks：填写服务器URL、用户名及设备标识
   • 通用HTTP：配置自定义端点地址
3. 保存配置后，所有命令通过 scripts/location.sh 脚本调用

基本用法示例：

# 查询当前位置
scripts/location.sh status

# 计算步行回家时间
scripts/location.sh eta home --mode walk

# 设置位置提醒
scripts/location.sh remind "买牛奶" grocery_store

# 查找附近咖啡馆
scripts/location.sh nearby cafe

输入与输出

见下方输入与输出表格。

风险提示

• 位置数据涉及个人隐私，配置文件中的访问令牌应妥善保管，避免泄露
• 依赖外部位置服务（Home Assistant/OwnTracks）的可用性，服务中断将导致功能失效
• 地理围栏半径设置过小可能导致频繁误触发，建议根据实际场景调整
• 历史轨迹数据存储于本地，需定期清理以防磁盘空间不足

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/hegghammer/location-awareness/SKILL.md
来源类型：GitHub开源项目