Tesla Fleet Api
Use when integrating with Tesla's official Fleet API to read vehicle/energy device data or issue remote commands (e.g. start HVAC preconditioning, wake vehicle, charge controls). Covers onboarding (developer app registration, regions/base URLs), OAuth token flows (third-party + partner tokens, refresh rotation), required domain/public-key hosting, and using Tesla's official vehicle-command/tesla-http-proxy for signed vehicle commands.
Rank
62
Safety
84
Downloads
2.5k
Updated
Apr 15, 2026
Version
1.5.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 2.5K downloads reported by the source. Last updated 4/15/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Apr 15, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Apr 15, 2026
- Adoption signal
- 2.5K downloadsadoption · observed Apr 15, 2026
- Latest release
- 1.5.0release · observed Feb 13, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install kn7c7fek4a503rbvj0bxbwx6dx7yw25e:tesla-fleet-api- Install using `clawhub skill install kn7c7fek4a503rbvj0bxbwx6dx7yw25e:tesla-fleet-api` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/odrobnik/tesla-fleet-api before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-odrobnik-tesla-fleet-api/snapshot"
Documentation
CLAWHUB
37,331 characters of source documentation, loaded on request.
Extracted files
3 files captured from the source.
SKILL.md
---
name: tesla-fleet-api
description: Use when integrating with Tesla's official Fleet API to read vehicle/energy device data or issue remote commands (e.g. start HVAC preconditioning, wake vehicle, charge controls). Covers onboarding (developer app registration, regions/base URLs), OAuth token flows (third-party + partner tokens, refresh rotation), required domain/public-key hosting, and using Tesla's official vehicle-command/tesla-http-proxy for signed vehicle commands.
version: 1.5.0
homepage: https://github.com/odrobnik/tesla-fleet-api-skill
metadata:
openclaw:
emoji: "🚗"
requires:
bins: ["python3", "openssl"]
env: ["TESLA_CLIENT_ID", "TESLA_CLIENT_SECRET"]
optionalEnv: ["TESLA_AUDIENCE", "TESLA_REDIRECT_URI", "TESLA_DOMAIN", "TESLA_BASE_URL", "TESLA_CA_CERT", "TESLA_ACCESS_TOKEN", "TESLA_REFRESH_TOKEN", "TESLA_SCOPE"]
---
# Tesla Fleet API
Control Tesla vehicles via the official Fleet API.
## Scripts Overview
| Script | Purpose |
|--------|---------|
| `command.py` | Vehicle commands (climate, charging, locks, etc.) |
| `vehicle_data.py` | Read vehicle data (battery, climate, location, etc.) |
| `vehicles.py` | List vehicles + refresh cache |
| `auth.py` | Authentication and configuration |
| `tesla_oauth_local.py` | OAuth helper with local callback server |
| `start_proxy.sh` | Start the signing proxy (for vehicle commands) |
| `stop_proxy.sh` | Stop the signing proxy |
---
## Setup / Configuration
Setup is documented in **`SETUP.md`**:
- [SETUP.md](SETUP.md)
State directory: `{workspace}/tesla-fleet-api/`
- `config.json` (provider creds + non-token config)
- `auth.json` (tokens)
- `vehicles.json` (cached vehicle list)
- `places.json` (named locations)
- `proxy/` (TLS material for signing proxy)
No `.env` file loading — credentials in `config.json` or environment variables.
---
## command.py - Vehicle Commands
Execute commands on your Tesla. Vehicle is auto-selected if you only have one.
### Usage
```bash
command.py [VEHICLE] <command> [options]
```
- `VEHICLE` - Vehicle name or VIN (optional if single vehicle)
- Commands can be run without specifying vehicle: `command.py honk`
- Or with vehicle name: `command.py flash honk` (vehicle "flash", command "honk")
---
### Climate Control
#### Start/Stop Climate
```bash
command.py climate start
command.py climate stop
command.py flash climate start # specific vehicle
```
#### Set Temperature
```bash
command.py climate temps <driver_temp> [passenger_temp]
command.py climate temps 21 # both seats 21°C
command.py climate temps 22 20 # driver 22°C, passenger 20°C
```
#### Climate Keeper Mode
```bash
command.py climate keeper <mode>
```
Modes: `off`, `keep`, `dog`, `camp`
---
### Seat Heater
```bash
command.py seat-heater --level <level> [--position <position>]
command.py seat-heater -l <level> [-p <position>]
```
**Levels:**
| Value | Name |
|-------|------|
| 0 | off |
| 1 | low |
| 2 | medium |
| 3 | high |
**Posi_meta.json
{
"ownerId": "kn7c7fek4a503rbvj0bxbwx6dx7yw25e",
"slug": "tesla-fleet-api",
"version": "1.5.0",
"publishedAt": 1771003588072
}SETUP.md
# Tesla Fleet API Skill — Setup Guide
This guide covers **setup + configuration** for the Tesla Fleet API skill.
If you just want the CLI command reference, see `SKILL.md`.
---
## Prerequisites
- Tesla Developer Account + an app created
- A domain you control (for public key hosting + virtual key enrollment)
- `python3`
- `openssl` (for key generation + TLS certs)
- macOS (scripts tested on macOS)
- For proxy setup: `go` (on macOS: `brew install go`) — only needed once to compile the proxy binary
---
## State / Files
All runtime state lives in your workspace:
`{workspace}/tesla-fleet-api/`
Files:
- `config.json` — provider creds (client id/secret), non-token config (audience, base_url, ca_cert, redirect_uri, domain)
- `auth.json` — tokens (access/refresh)
- `vehicles.json` — cached vehicle list
- `places.json` — named locations (`{"home": {"lat": ..., "lon": ...}}`)
- `proxy/` — TLS material for the signing proxy
- `private-key.pem` — your Tesla EC private key (fixed name)
Credentials come from `config.json` or environment variables (`TESLA_CLIENT_ID`, `TESLA_CLIENT_SECRET`). No `.env` file loading.
---
## 1) Create & host your EC keypair
```bash
# Generate P-256 keypair
openssl ecparam -name prime256v1 -genkey -noout -out private-key.pem
openssl ec -in private-key.pem -pubout -out public-key.pem
# Host public key at:
# https://YOUR_DOMAIN/.well-known/appspecific/com.tesla.3p.public-key.pem
```
Store your private key in the workspace with a fixed name:
`{workspace}/tesla-fleet-api/private-key.pem`
---
## 2) Configure provider credentials
```bash
python3 scripts/auth.py config set \
--client-id "YOUR_CLIENT_ID" \
--client-secret "YOUR_CLIENT_SECRET" \
--redirect-uri "http://localhost:18080/callback" \
--audience "https://fleet-api.prd.eu.vn.cloud.tesla.com"
```
This writes to `{workspace}/tesla-fleet-api/config.json`.
---
## 3) OAuth login (creates auth.json)
Interactive login (manual code paste):
```bash
python3 scripts/auth.py login
```
Automatic login via local callback server:
```bash
python3 scripts/tesla_oauth_local.py --prompt-missing-scopes
```
---
## 4) Register domain + enroll virtual key
```bash
python3 scripts/auth.py register --domain YOUR_DOMAIN.com
```
Then, on your phone (Tesla app installed):
`https://tesla.com/_ak/YOUR_DOMAIN.com`
---
## 5) Proxy Setup (for signed commands only)
> **Note:** The proxy is only needed for **sending signed commands** to the vehicle (climate, locks, charging, honk, etc.). Reading vehicle data (battery, location, temperatures) works without the proxy — those requests go directly to the Tesla Fleet API.
### Install tesla-http-proxy
Requires Go (`brew install go` on macOS).
```bash
# Pin to a specific version for supply-chain safety
go install github.com/teslamotors/vehicle-command/cmd/[email protected]
```
This installs `tesla-http-proxy` to `~/go/bin/`.
### Generate TLS certificates
```bash
mkdir -p {workspace}/tesla-fleet-api/proxy
cd {workspace}/tactivepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/odrobnik/tesla-fleet-api",
"sourceUrl": "https://clawhub.ai/odrobnik/tesla-fleet-api",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-04-15T00:45:39.800Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-odrobnik-tesla-fleet-api/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-odrobnik-tesla-fleet-api/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-04-15T00:45:39.800Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "2.5K downloads",
"href": "https://clawhub.ai/odrobnik/tesla-fleet-api",
"sourceUrl": "https://clawhub.ai/odrobnik/tesla-fleet-api",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-04-15T00:45:39.800Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.5.0",
"href": "https://clawhub.ai/odrobnik/tesla-fleet-api",
"sourceUrl": "https://clawhub.ai/odrobnik/tesla-fleet-api",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-02-13T17:26:28.072Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-odrobnik-tesla-fleet-api/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-odrobnik-tesla-fleet-api/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.5.0",
"description": "- Dropped the Go runtime dependency; Go is no longer required to use the skill. - Updated required environment variables and optional settings, removing obsolete entries related to signing proxy and public key. - Improved documentation for setup, reflecting dependency changes. - start_proxy.sh script and related requirements simplified due to proxy/signing changes. - Version bumped to 1.5.0.",
"href": "https://clawhub.ai/odrobnik/tesla-fleet-api",
"sourceUrl": "https://clawhub.ai/odrobnik/tesla-fleet-api",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-02-13T17:26:28.072Z",
"isPublic": true
}
]
}Record generated Oct 9, 2026.
