Skip to content

mvanhorn/clawdbot-skill-tesla

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tesla Skill for OpenClaw

Complete Tesla Fleet API control from the terminal - all 66 vehicle commands, energy/Powerwall management, vehicle sharing, charging history, navigation, media controls, V2G/Powershare, and multi-vehicle management.

What it does

  • All 66 vehicle commands - doors, charging, climate, security, navigation, media, and more
  • Dashboard - unified view of all vehicles: battery, range, charging, location, lock status, climate, sentry
  • Climate - AC, heat, seat heaters/coolers, steering wheel heater, bioweapon defense, dog/camp mode, cabin overheat protection
  • Charging - start/stop, set limits/amps, charge schedules, port control, charging history and invoices
  • Security - sentry mode, valet mode, PIN to drive, speed limit, guest mode, remote start
  • Navigation - send addresses, GPS coordinates, Superchargers, or multi-stop routes to your car
  • Media - play/pause, next/prev track, favorites, volume control
  • Vehicle sharing - invite drivers, manage access, revoke invitations
  • Vehicle info - specs, options, release notes, alerts, service data, warranty
  • Energy monitoring - Powerwall charge level, solar generation, grid flow, operating mode, time-of-use, storm watch
  • V2G/Powershare - vehicle-to-grid status for Cybertruck and compatible vehicles
  • Charge station finder - nearby Superchargers and destination chargers with availability
  • Multi-vehicle - list, select default, operate on specific cars by name
  • Other - honk, flash, boombox, HomeLink (garage door), rename vehicle, software updates

Quick start

Install the skill

git clone https://github.com/mvanhorn/clawdbot-skill-tesla.git ~/.openclaw/skills/tesla

Authenticate (one-time)

export TESLA_EMAIL="you@email.com"
python3 scripts/tesla.py auth

This opens a Tesla login URL. Sign in, authorize, paste the callback URL back. Token caches for ~30 days and auto-refreshes.

Example chat usage

  • "Show me my Tesla dashboard"
  • "Is my Tesla locked?"
  • "What's Snowflake's battery level?"
  • "Turn on the AC in Stella and set it to 72"
  • "Put my car in dog mode"
  • "Turn on sentry mode"
  • "Set a speed limit of 65 mph"
  • "Navigate to Pike Place Market"
  • "Play next track"
  • "Turn on the seat heater for the driver"
  • "Set the charge amps to 16"
  • "Schedule charging between 11 PM and 6 AM on weekdays"
  • "Find the nearest Supercharger"
  • "How much solar am I generating?"
  • "What's my Powerwall at?"
  • "Invite user@email.com to drive my Tesla"
  • "Show my charging history"
  • "What are my car's specs?"
  • "Install the software update now"
  • "What's my Powershare status?"

Commands (sample)

python3 scripts/tesla.py dashboard                      # All vehicles at a glance
python3 scripts/tesla.py status                          # Vehicle status
python3 scripts/tesla.py lock / unlock                   # Door lock/unlock
python3 scripts/tesla.py climate on / off / temp 72      # Climate control
python3 scripts/tesla.py climate keeper dog              # Dog mode
python3 scripts/tesla.py climate seat-heater driver 2    # Seat heater
python3 scripts/tesla.py charge start / stop / limit 80  # Charging
python3 scripts/tesla.py charge amps 16                  # Set charging amps
python3 scripts/tesla.py charge schedule add 23:00 06:00 # Charge schedule
python3 scripts/tesla.py sentry on / off                 # Sentry mode
python3 scripts/tesla.py valet on --pin 1234             # Valet mode
python3 scripts/tesla.py speed-limit set 70              # Speed limit
python3 scripts/tesla.py navigate "Seattle, WA"          # Send nav destination
python3 scripts/tesla.py navigate --supercharger         # Nav to Supercharger
python3 scripts/tesla.py media next / prev / volume 5    # Media controls
python3 scripts/tesla.py sharing invite user@email.com   # Share vehicle access
python3 scripts/tesla.py info specs / warranty / alerts  # Vehicle info
python3 scripts/tesla.py energy status                   # Solar + Powerwall
python3 scripts/tesla.py energy mode self-powered        # Powerwall mode
python3 scripts/tesla.py charging history                # Charging sessions
python3 scripts/tesla.py powershare status               # V2G status
python3 scripts/tesla.py honk / flash / boombox play     # Fun stuff
python3 scripts/tesla.py homelink                        # Garage door
python3 scripts/tesla.py software-update start           # Install update
python3 scripts/tesla.py --car "Stella" status           # Target specific car

How it works

Uses the Tesla Fleet API at fleet-api.prd.na.vn.cloud.tesla.com. Authenticates via OAuth2 with TESLA_EMAIL. Credentials stored locally only. Refresh token cached in ~/.tesla_cache.json. No data sent to third parties. Vehicles on firmware 2024.26+ use the Vehicle Command Protocol (VCP) for end-to-end encrypted commands.

Covers all 66 vehicle commands, 6 sharing endpoints, 6 vehicle info endpoints, 12 energy endpoints, and 3 charging history endpoints.

See SKILL.md for full documentation including VCP setup, every command with examples, deprecation warnings, error recovery, and energy monitoring details.

License

MIT

About

Full Tesla control from the terminal - dashboard, scheduled preconditioning, energy monitoring, charge station finder, multi-vehicle management via Fleet API. OpenClaw skill.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages