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)