location-awareness

What This Skill Does

The location-awareness skill transforms your OpenClaw agent into a personal geolocation assistant. By integrating with privacy-conscious services like Home Assistant, OwnTracks, or GPS Logger, it provides real-time updates on your current status, travel logistics, and place-based automation. The core functionality is centralized within the scripts/location.sh utility, ensuring that all interactions remain secure, consistent, and predictable.

Installation

To integrate this skill, ensure your environment supports the required scripts, then execute the following command in your terminal:

clawhub install openclaw/skills/skills/hegghammer/location-awareness

Use Cases

This skill is designed for users who want to optimize their daily routine through geofencing and historical analysis. Common use cases include:

• Commute Optimization: Quickly calculate travel times to work or home using bike, car, or walking modes.
• Automation Management: Set location-based reminders (e.g., "Remind me to buy milk when I reach the grocery store") or manage complex geofence triggers.
• Life Logging: Track your movement history to answer questions like "Where have I been today?" or "How long was I at the office this week?"
• POI Exploration: Discover nearby services such as cafes or pubs, filtered by proximity or category.

Example Prompts

1. "How long will it take me to walk home right now?"
2. "Remind me to call the insurance provider when I get to the office."
3. "Find me a cafe within 500 meters that is open."

Tips & Limitations

• Response Style: The agent is configured to be terse. Avoid conversational filler; the agent provides data directly as requested.
• Command Integrity: All location functions must be routed through scripts/location.sh. Subcommands such as eta or history will not execute if called directly.
• Privacy: Since this skill handles sensitive location data, ensure your GPS sources (Home Assistant or OwnTracks) are configured with appropriate privacy settings. The skill does not transmit your data to third-party servers; all processing is handled locally via the provided shell scripts.