tesla

name	tesla
version	3.0.0
description	Complete Tesla Fleet API control - all 66 vehicle commands, energy/Powerwall management, vehicle sharing, charging history, navigation, media, V2G/Powershare, and multi-vehicle management from the terminal.
author	mvanhorn
license	MIT
repository	https://github.com/mvanhorn/clawdbot-skill-tesla
homepage	https://developer.tesla.com/docs/fleet-api
metadata	{"openclaw":{"emoji":"🚗","requires":{"env":["TESLA_EMAIL"]},"primaryEnv":"TESLA_EMAIL","tags":["tesla","vehicle","iot","fleet-api","electric-vehicle","ev","charging","supercharger","powerwall","solar","energy","automotive","cybertruck","v2g","powershare","navigation","media"],"triggers":["tesla","my car","my vehicle","battery level","charge status","lock my car","unlock my car","car location","where is my car","climate control","precondition","supercharger","powerwall","solar panels","energy usage","fleet api","honk horn","flash lights","charge my car","sentry mode","valet mode","dog mode","camp mode","navigate to","media controls","seat heater","steering wheel heater","charge history","share my car","guest mode","speed limit","software update","boombox","bioweapon defense","cabin overheat","v2g","powershare"]}}

Tesla

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

Fleet API (2026): Tesla has deprecated the legacy Owner API. All vehicles now use the Fleet API at fleet-api.prd.na.vn.cloud.tesla.com. Vehicles on firmware 2024.26+ require the Vehicle Command Protocol (VCP). The tesla-fleet-api Python package handles both paths automatically.

---

Setup

Prerequisites

• Python 3.10+
• A Tesla account with at least one vehicle, Powerwall, or solar system
• TESLA_EMAIL environment variable set to your Tesla account email

First-time authentication

TESLA_EMAIL="[e-mail]" python3 {baseDir}/scripts/tesla.py auth

Steps:

1. The script displays a Tesla login URL
2. Open it in your browser, sign in, and authorize the application
3. Copy the callback URL from your browser's address bar (starts with https://auth.tesla.com/void/callback?...)
4. Paste it back into the terminal
5. Token is cached at ~/.tesla_cache.json for ~30 days with automatic refresh

Environment variables

Variable	Required	Description
TESLA_EMAIL	Yes	Your Tesla account email address

Token storage: ~/.tesla_cache.json (auto-created on first auth, auto-refreshes)

---

Vehicle Command Protocol (VCP)

Vehicles running firmware 2024.26 or later require VCP for sending commands. Without VCP configured, status queries will work but commands (lock, unlock, climate, charge start/stop) will fail with a vehicle_command_protocol_required error.

How to check if VCP is needed

python3 {baseDir}/scripts/tesla.py status

If you see a VCP error in the output, your vehicle needs VCP setup.

VCP setup

1. Generate a public/private key pair on your machine:

   openssl ecparam -name prime256v1 -genkey -noout -out private_key.pem
   openssl ec - private_key.pem -pubout -out public_key.pem