Charger

charger

Higher-level EV charger checker built on Google Places (New) EV charge data.

This skill includes a bin/charger CLI (Node.js) for checking charger availability.

Setup

• Requirements:

  • Node.js 18+ (Clawdbot already has Node)
  • GOOGLE_PLACES_API_KEY (recommended in ~/.clawdbot/.env)

• Put the CLI on your PATH (example):

  • ln -sf "$(pwd)"/bin/charger /home/claw/clawd/bin/charger

• Add a favorite:

  • charger favorites add home --place-id <placeId>

Commands

• Check a favorite / place id / query:

  • charger check home
  • charger check "Wien Energie Charging Station Liniengasse 2 1060 Wien"

• Find nearby:

  • charger nearby --lat 48.188472 --lng 16.348854 --radius 2000 --max 10

Notifications

The recommended pattern is:

1. charger (this skill) produces a clear Any free: YES|NO result.
2. A scheduled job (Gateway cron) runs a small helper that only prints output when it should notify.

Helper script (what actually decides to notify)

This bundle includes scripts/charger-notify.sh.

What it does:

• Runs charger check <target>
• If Any free: YES and the last run was not YES, it prints a single notification line.
• Otherwise it prints nothing.

So: no output = no notification.

State:

• Stores last state in ~/.cache/charger-notify/<target>.state so it only notifies on the change NO/UNKNOWN → YES.

Usage:

• bash scripts/charger-notify.sh home

Example notification output:

• EV charger available: Tanke Wien Energie Charging Station — Amtshausgasse 9, 1050 Wien, Austria — 1/2 available (OOS 0) (updated 2026-01-21T21:05:00Z)

Typical cron schedule (how you actually get Telegram pings)

Cron is the scheduler. It runs the helper script on a timer and sends you whatever the script prints. Because the helper prints only when it becomes available, you only get messages when it matters.

Check every 10 minutes:

• */10 * * * *

If you want me to wire this into Clawdbot Gateway cron (so you get Telegram pings), tell me:

• target (home)
• interval (every 5/10/20 min)
• quiet hours (optional)