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.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/mvanhorn/clawdbot-skill-tesla --skill tesla
The command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview
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
Open it in your browser, sign in, and authorize the application
Copy the callback URL from your browser's address bar (starts with https://auth.tesla.com/void/callback?...)
Paste it back into the terminal
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
Generate a public/private key pair on your machine:
Register your public key with Tesla's servers. This requires creating a third-party application at https://developer.tesla.com/ and uploading your public_key.pem to a .well-known endpoint on your registered domain.
Pair your key with each vehicle. Sit inside the vehicle with the key card on the center console, then run:
Tap "Approve" on the vehicle's touchscreen when prompted.
Once paired, commands are end-to-end encrypted between your machine and the vehicle. The tesla-fleet-api package handles signing automatically when it finds your key.
Note: If you are only reading vehicle data (status, location, charge state), VCP is not required. VCP is only needed for sending commands.
Dashboard
Get a unified view of all your vehicles in one command:
python3 {baseDir}/scripts/tesla.py dashboard
Output includes for each vehicle:
Name, model, and state (online/asleep/offline)
Battery level and estimated range
Charging state and time remaining (if charging)
Location as a human-readable address (reverse geocoded from GPS)
Lock status (locked/unlocked)
Climate state (on/off, cabin temperature)
Software version and any pending updates
Sentry mode status
Example output:
--- Dashboard ---
1. Snowflake (Model Y - Online)
Battery: 78% (245 mi) Charging: Not charging
Location: 4521 Mercer Way, Mercer Island, WA 98040
Locked: Yes Sentry: On Climate: Off (68F inside)
Software: 2025.48.3 (up to date)
2. Stella (Model 3 - Asleep)
Battery: 92% (310 mi) Charging: Complete
Location: 1200 NE 45th St, Seattle, WA 98105
Locked: Yes Sentry: Off Climate: Off
Software: 2025.48.3 (update available: 2025.50.1)
Multi-Vehicle Management
List all vehicles
python3 {baseDir}/scripts/tesla.py list
Shows all vehicles on your account with name, VIN, model, state, and battery level.
Select a specific vehicle
Use --car or -c with any command to target a specific vehicle by its display name:
python3 {baseDir}/scripts/tesla.py --car "Snowflake" status
python3 {baseDir}/scripts/tesla.py -c "Stella" lock
python3 {baseDir}/scripts/tesla.py --car "Snowflake" climate on
Without --car, commands target your first vehicle.
Set a default vehicle
If you have multiple vehicles and mostly control one, set a default:
Deprecation:set_scheduled_departure is deprecated. Use add_precondition_schedule / remove_precondition_schedule instead.
Security
# Sentry mode (set_sentry_mode)
python3 {baseDir}/scripts/tesla.py sentry on
python3 {baseDir}/scripts/tesla.py sentry off
# Valet mode (set_valet_mode)
python3 {baseDir}/scripts/tesla.py valet on # Enable valet mode
python3 {baseDir}/scripts/tesla.py valet on --pin 1234 # Enable with PIN
python3 {baseDir}/scripts/tesla.py valet off --pin 1234 # Disable with PIN# Reset valet PIN (reset_valet_pin)
python3 {baseDir}/scripts/tesla.py valet reset-pin
# PIN to drive (set_pin_to_drive)
python3 {baseDir}/scripts/tesla.py pin-to-drive on --pin 1234 # Require PIN to shift out of park
python3 {baseDir}/scripts/tesla.py pin-to-drive off --pin 1234
# Speed limit (speed_limit_activate / speed_limit_deactivate / speed_limit_set_limit)
python3 {baseDir}/scripts/tesla.py speed-limit set 70 # Set limit to 70 mph (50-90 mph range)
python3 {baseDir}/scripts/tesla.py speed-limit activate --pin 1234
python3 {baseDir}/scripts/tesla.py speed-limit deactivate --pin 1234
# Guest mode (guest_mode)
python3 {baseDir}/scripts/tesla.py guest-mode on # Enable guest restrictions
python3 {baseDir}/scripts/tesla.py guest-mode off
# Remote start drive (remote_start_drive) - start without key for 2 minutes
python3 {baseDir}/scripts/tesla.py remote-start
# Erase user data (erase_user_data) - factory reset personal data
python3 {baseDir}/scripts/tesla.py erase-data --confirm # Requires --confirm flag
Fleet API endpoints: navigation_request, navigation_gps_request, navigation_sc_request, navigation_waypoints_request
Media
# Playback
python3 {baseDir}/scripts/tesla.py media play # media_toggle_playback (play/pause)
python3 {baseDir}/scripts/tesla.py media pause # media_toggle_playback# Track navigation
python3 {baseDir}/scripts/tesla.py media next # media_next_track
python3 {baseDir}/scripts/tesla.py media prev # media_prev_track# Favorites
python3 {baseDir}/scripts/tesla.py media next-fav # media_next_fav
python3 {baseDir}/scripts/tesla.py media prev-fav # media_prev_fav# Volume
python3 {baseDir}/scripts/tesla.py media volume up # adjust_volume (increment)
python3 {baseDir}/scripts/tesla.py media volume down # media_volume_down
python3 {baseDir}/scripts/tesla.py media volume 7 # adjust_volume (absolute, 0-11)
Fleet API endpoints: media_toggle_playback, media_next_track, media_prev_track, media_next_fav, media_prev_fav, media_volume_down, adjust_volume
Other Commands
# Honk and flash
python3 {baseDir}/scripts/tesla.py honk # honk_horn
python3 {baseDir}/scripts/tesla.py flash # flash_lights# Boombox (remote_boombox) - external speaker, vehicle must be in park
python3 {baseDir}/scripts/tesla.py boombox play # Play boombox sound
python3 {baseDir}/scripts/tesla.py boombox stop # Stop boombox# Vehicle name (set_vehicle_name)
python3 {baseDir}/scripts/tesla.py set-name "Snowflake"# Software updates (schedule_software_update / cancel_software_update)
python3 {baseDir}/scripts/tesla.py software-update start # Install now
python3 {baseDir}/scripts/tesla.py software-update schedule 120 # Schedule in 120 minutes
python3 {baseDir}/scripts/tesla.py software-update cancel # Cancel pending update# Wake
python3 {baseDir}/scripts/tesla.py wake # Wake sleeping vehicle
Fleet API endpoints: honk_horn, flash_lights, remote_boombox, set_vehicle_name, schedule_software_update, cancel_software_update
Vehicle Sharing (6 endpoints)
Share vehicle access with other Tesla accounts.
# List sharing invitations
python3 {baseDir}/scripts/tesla.py sharing invitations # GET /invitations# Send sharing invitation
python3 {baseDir}/scripts/tesla.py sharing invite user@email.com # POST /invitations# Redeem an invitation (as the recipient)
python3 {baseDir}/scripts/tesla.py sharing redeem <invitation_code> # POST /invitations/redeem# Revoke an invitation
python3 {baseDir}/scripts/tesla.py sharing revoke <invitation_id> # POST /invitations/{id}/revoke# List drivers with access
python3 {baseDir}/scripts/tesla.py sharing drivers # GET /drivers# Remove a driver
python3 {baseDir}/scripts/tesla.py sharing remove-driver <driver_id> # DELETE /drivers
Fleet API endpoints: GET /invitations, POST /invitations, POST /invitations/redeem, POST /invitations/{id}/revoke, GET /drivers, DELETE /drivers
Vehicle Info Endpoints
# Vehicle specifications
python3 {baseDir}/scripts/tesla.py info specs # GET /specs# Vehicle options (original build configuration)
python3 {baseDir}/scripts/tesla.py info options # GET /options# Release notes for current firmware
python3 {baseDir}/scripts/tesla.py info release-notes # GET /release_notes# Recent vehicle alerts
python3 {baseDir}/scripts/tesla.py info alerts # GET /recent_alerts# Service data (maintenance history)
python3 {baseDir}/scripts/tesla.py info service # GET /service_data# Warranty details
python3 {baseDir}/scripts/tesla.py info warranty # GET /warranty_details
Fleet API endpoints: GET /specs, GET /options, GET /release_notes, GET /recent_alerts, GET /service_data, GET /warranty_details
Energy Monitoring (Powerwall / Solar) - 12 endpoints
If your Tesla account includes Powerwall or solar products, you can monitor and control them.
List energy sites
python3 {baseDir}/scripts/tesla.py energy list # GET /products
Shows all energy products on your account (Powerwall, Solar Roof, standalone solar).
Energy status
# Site info (GET /site_info)
python3 {baseDir}/scripts/tesla.py energy info
# Current energy flow (GET /live_status)
python3 {baseDir}/scripts/tesla.py energy status
# Example output:# Home Energy Status:# Solar: 4.2 kW generating# Powerwall: 87% (10.4 kWh stored)# Grid: Exporting 1.8 kW# Home: Using 2.4 kW# Mode: Self-Powered
Energy history
# Energy production/consumption history (GET /calendar_history?kind=energy)
python3 {baseDir}/scripts/tesla.py energy history --days 7 # Watt hours over last 7 days
python3 {baseDir}/scripts/tesla.py energy history --months 1 # Monthly summary# Backup events (GET /calendar_history?kind=backup)
python3 {baseDir}/scripts/tesla.py energy backup-history # Off-grid events log# Wall Connector telemetry (GET /telemetry_history?kind=charge)
python3 {baseDir}/scripts/tesla.py energy wall-connector-history # Wall Connector charge sessions
Powerwall controls
# Set backup reserve percentage (POST /backup)
python3 {baseDir}/scripts/tesla.py energy reserve 20
# Storm watch (POST /storm_mode)
python3 {baseDir}/scripts/tesla.py energy storm-watch on
python3 {baseDir}/scripts/tesla.py energy storm-watch off
# Time-of-use settings (POST /time_of_use_settings)
python3 {baseDir}/scripts/tesla.py energy tou-settings --peak-start 16:00 --peak-end 21:00
# Grid import/export config (POST /grid_import_export)
python3 {baseDir}/scripts/tesla.py energy grid-config --export on --import on
# Off-grid vehicle charging reserve (POST /off_grid_vehicle_charging_reserve)
python3 {baseDir}/scripts/tesla.py energy vehicle-charge-reserve 50 # Reserve 50% for vehicle charging# Operating mode (POST /operation)
python3 {baseDir}/scripts/tesla.py energy mode self-powered # Maximize solar self-consumption
python3 {baseDir}/scripts/tesla.py energy mode time-based # Optimize for time-of-use rates
python3 {baseDir}/scripts/tesla.py energy mode backup-only # Reserve for backup only
Fleet API endpoints: GET /products, GET /site_info, GET /live_status, GET /calendar_history?kind=energy, GET /calendar_history?kind=backup, GET /telemetry_history?kind=charge, POST /backup, POST /storm_mode, POST /time_of_use_settings, POST /grid_import_export, POST /off_grid_vehicle_charging_reserve, POST /operation
Charging History (3 endpoints)
View past charging sessions and invoices.
# Charging history (GET /charging/history)
python3 {baseDir}/scripts/tesla.py charging history# All charging sessions
python3 {baseDir}/scripts/tesla.py charging history --days 30 # Last 30 days
python3 {baseDir}/scripts/tesla.py charging history --type supercharger # Supercharger sessions only# Charging invoice (GET /charging/invoice/{id})
python3 {baseDir}/scripts/tesla.py charging invoice <invoice_id>
# Active charging sessions (GET /charging/sessions)
python3 {baseDir}/scripts/tesla.py charging sessions # Currently active sessions
Fleet API endpoints: GET /charging/history, GET /charging/invoice/{id}, GET /charging/sessions
Charge Station Finder
Find nearby Tesla Superchargers and destination chargers.
# Find Superchargers near your vehicle's current location
python3 {baseDir}/scripts/tesla.py chargers nearby
# Find chargers near a specific address
python3 {baseDir}/scripts/tesla.py chargers nearby --address "Seattle, WA"# Find chargers near GPS coordinates
python3 {baseDir}/scripts/tesla.py chargers nearby --lat 47.6062 --lon -122.3321
# Filter by charger type
python3 {baseDir}/scripts/tesla.py chargers nearby --type supercharger
python3 {baseDir}/scripts/tesla.py chargers nearby --type destination
# Show availability (stalls in use vs total)
python3 {baseDir}/scripts/tesla.py chargers nearby --availability
Example output:
Superchargers near Snowflake (4521 Mercer Way, Mercer Island, WA):
1. Tesla Supercharger - Bellevue, WA (3.2 mi)
1234 Bellevue Way NE - 12 stalls (8 available)
250 kW - Open 24/7
Navigate: https://www.google.com/maps/dir/?api=1&destination=47.6101,-122.2015
2. Tesla Supercharger - Renton, WA (5.8 mi)
800 Rainier Ave S - 8 stalls (5 available)
150 kW - Open 24/7
Navigate: https://www.google.com/maps/dir/?api=1&destination=47.4799,-122.2034
Navigate to charger
# Send navigation to the nearest Supercharger directly to your vehicle
python3 {baseDir}/scripts/tesla.py chargers navigate 1
V2G / Powershare
Tesla's vehicle-to-grid (V2G) and Powershare features allow compatible vehicles to export energy back to the home or grid.
Status
# Check Powershare status (PowershareStatus telemetry field)
python3 {baseDir}/scripts/tesla.py powershare status
# Example output:# Powershare Status:# State: Exporting# Power: 5.2 kW to home# Battery: 72% (reserve set to 50%)
Compatibility
Cybertruck: V2G program available in Texas (launched Feb 2026). Requires Powershare Home Backup Gateway.
Powerwall 3: Native bidirectional capability with compatible vehicles.
Telemetry:PowershareStatus field available via Fleet API telemetry streaming.
Deprecation Warnings
The following Fleet API endpoints are deprecated and will be removed in a future API version:
Deprecated Endpoint
Replacement
Notes
set_scheduled_charging
add_charge_schedule / remove_charge_schedule
New schedule endpoints support multiple schedules and day-of-week filtering
New schedule endpoints support multiple schedules and day-of-week filtering
The skill uses the new endpoints by default. If you have scripts using the old schedule charge-window or schedule precondition syntax, they have been migrated to the new API automatically.
Location
# Get location as address + GPS coordinates + Google Maps link
python3 {baseDir}/scripts/tesla.py location
# GPS coordinates only (no reverse geocoding)
python3 {baseDir}/scripts/tesla.py location --gps-only
# Example output:# Snowflake Location:# Address: 4521 Mercer Way, Mercer Island, WA 98040# GPS: 47.5707, -122.2220# Map: https://www.google.com/maps?q=47.5707,-122.2220# Speed: Parked# Heading: 185 (S)
The location command reverse geocodes GPS coordinates to a human-readable street address using the Nominatim API (OpenStreetMap, no API key needed). Falls back to raw GPS if geocoding fails.
Error Recovery
Authentication expired
If your token has expired (after ~30 days without use), you will see:
Vehicles go to sleep after ~15 minutes of inactivity to save battery. The script automatically wakes the vehicle before sending commands, but if wake fails:
Error: Vehicle did not wake up within 30 seconds
Fix: Try again - the vehicle may need more time. The script retries up to 3 times with 10-second intervals:
python3 {baseDir}/scripts/tesla.py wake
# Then retry your command
python3 {baseDir}/scripts/tesla.py status
If the vehicle is in a deep sleep state (e.g., parked for days), it may take up to 2 minutes to wake. The script handles this automatically with exponential backoff.
VCP not configured
If you see:
Error: vehicle_command_protocol_required
Your vehicle's firmware requires VCP for commands. See the VCP setup section above. Note that read-only operations (status, location, charge status) still work without VCP.
Command timeout
If a command times out:
Error: Command timed out after 30 seconds
The vehicle may be in an area with poor cellular connectivity. The command may still execute - check status before retrying. Common in underground parking or remote areas.
Rate limiting
The Tesla Fleet API enforces rate limits. If you see:
Error: 429 Too Many Requests
Wait 60 seconds before retrying. Avoid polling status more frequently than once per minute.
Vehicle offline
If the vehicle shows as "offline", it has no cellular connection. Commands cannot be sent until it reconnects. This can happen in:
Underground parking garages
Remote areas without cell coverage
When the 12V battery is very low
No fix except waiting for the vehicle to regain connectivity.
Example Chat Usage
Ask naturally and the skill handles the rest:
"Show me my Tesla dashboard"
"Is my Tesla locked?"
"Lock Stella"
"What's Snowflake's battery level?"
"Where is my Model Y?"
"Turn on the AC in Stella and set it to 72"
"Honk the horn on Snowflake"
"Start charging my car"
"Set the charge limit to 80%"
"Open the frunk"
"Set the charge amps to 16"
"Turn on sentry mode"
"Put Stella in dog mode"
"Enable camp mode"
"Turn on bioweapon defense mode"
"Set a speed limit of 65 mph"
"Enable valet mode with PIN 1234"
"Navigate to Pike Place Market"
"Send the nearest Supercharger to my car's nav"
"Navigate with stops through Portland and San Francisco"
