OpenClaw platform plugin for Tesla vehicle control and telemetry via tescmd
npm install @oceanswave/openclaw-tescmdYour Tesla, orchestrated.
This plugin makes your Tesla a first-class citizen in your agent's toolchain. Combine it with calendars, places, weather, messages — and let your agent handle the rest.
---
The real value isn't controlling your Tesla. It's what happens when your agent combines tools:
> "Send that coffee shop I like to my Cybertruck"
> Agent: looks up your favorite spot → gets the address → sends it to vehicle navigation
> "I'm leaving for the airport in 20 minutes"
> Agent: checks calendar for flight time → pulls up terminal → pre-conditions cabin → sends airport address to nav
> "Road trip to Asheville — find Superchargers along the way"
> Agent: gets coordinates → tescmd_superchargers_route → sends multi-stop nav → sets charge limit to 90%
> "Is there a Supercharger near the restaurant?"
> Agent: gets restaurant coords → tescmd_superchargers_near → returns closest options with stall count and power
Your Tesla becomes one node in a larger workflow. The agent handles the orchestration.
---
``bash`
openclaw plugins install @oceanswave/openclaw-tescmd
The tescmd node bridges your vehicle to the Gateway:
`bash`
pip install tescmd
tescmd setup # One-time auth
tescmd serve
Your agent now has 40 Tesla tools that work alongside everything else — calendars, places, weather, messages, web search, and more.
---
These aren't scripted — they're natural language requests your agent can fulfill by chaining tools:
| Request | Tools Involved |
|---------|---------------|
| "Navigate to my 2pm meeting" | Calendar → Places → tescmd_nav_send |tescmd_superchargers_route
| "Road trip to Asheville, find Superchargers" | goplaces → → agent picks stops |tescmd_superchargers_near
| "Is there a Supercharger near the restaurant?" | (with restaurant coords) |tescmd_get_location
| "Let me know when I'm charged enough to get home" | → distance calc → tescmd_battery_trigger |tescmd_climate_on
| "Prep the car, I'm heading out" | → tescmd_unlock_doors |tescmd_superchargers_search
| "Find Superchargers in Richmond" | |tescmd_location_trigger
| "Open the garage when I get home" | → tescmd_homelink |
---
Status: tescmd_get_battery · tescmd_get_location · tescmd_get_speed · tescmd_get_temperature · tescmd_get_charge_state · tescmd_get_security
Control: tescmd_lock_doors · tescmd_unlock_doors · tescmd_climate_on · tescmd_climate_off · tescmd_set_climate_temp · tescmd_start_charge · tescmd_stop_charge · tescmd_set_charge_limit · tescmd_open_trunk · tescmd_open_frunk · tescmd_flash_lights · tescmd_honk_horn · tescmd_sentry_on · tescmd_sentry_off
Navigation: tescmd_nav_send · tescmd_nav_gps · tescmd_nav_supercharger · tescmd_nav_waypoints · tescmd_homelink
Superchargers: tescmd_superchargers_near · tescmd_superchargers_route · tescmd_superchargers_search
Triggers: tescmd_battery_trigger · tescmd_cabin_temp_trigger · tescmd_outside_temp_trigger · tescmd_location_trigger · tescmd_list_triggers · tescmd_delete_trigger · tescmd_get_telemetry
Meta: tescmd_node_status · tescmd_help · tescmd_run_command
Built-in integration with supercharge.info — a community-maintained database of Tesla Superchargers worldwide:
| Tool | Use Case |
|------|----------|
| tescmd_superchargers_near | Find Superchargers near any coordinates |tescmd_superchargers_route
| | Find Superchargers along a route between two points |tescmd_superchargers_search
| | Search by city, state, or name |
Returns stall count, power level (kW), status, and distance — everything you need to plan charging stops.
Quick actions when you don't need the full agent:
| Command | Action |
|---------|--------|
| /battery | Battery + range |/charge [start\|stop\|80]
| | Charging control |/climate [on\|off\|72]
| | HVAC control |/lock
| /unlock | Door locks |/sentry [on\|off]
| | Sentry Mode |/location
| | GPS + map link |/vehicle
| | Full status |/nav
|
| Send destination |
| /flash /honk | Find your car |
| /trunk /frunk | Trunk control |
| /homelink | Garage door |
| /supercharger [city] | Find Superchargers |$3
The tescmd node streams live data — battery, location, temperature, charge state, security changes — so your agent always has current information without polling.
---
Triggers: Event-Driven Automation
Triggers are push-based — when conditions are met, the agent receives a notification automatically. No polling required.
`
"Alert me if battery drops below 20%"
→ tescmd_battery_trigger(operator='lt', value=20)"Notify me when the car leaves home"
→ tescmd_location_trigger(operator='leave', lat=..., lon=..., radius=500)
"Tell me if cabin gets above 100°F"
→ tescmd_cabin_temp_trigger(operator='gt', value=100)
Combine with other tools for powerful automation:
- Trigger fires → Agent checks weather → Sends you a contextual message
- Geofence exit → Agent locks doors → Enables sentry → Confirms via message
---
Requirements
| Requirement | Purpose |
|-------------|---------|
| Python 3.11+ | tescmd node |
| Tesla account | Fleet API access |
| Git + GitHub CLI | Key hosting (one-time setup) |
---
Configuration
Minimal — the tescmd node handles vehicle config:
json
{
"plugins": {
"entries": {
"openclaw-tescmd": {
"enabled": true
}
}
}
}
`---
CLI Reference
bash
openclaw tescmd status # Connection status
openclaw tescmd commands # Available commands
openclaw tescmd events # Telemetry event types
`---
Development
bash
git clone https://github.com/oceanswave/openclaw-tescmd.git
cd openclaw-tescmd && bun install
bun run check-types && bun run lint
openclaw plugins install -l ./openclaw-tescmd
``---
- tescmd — Python CLI bridging Tesla Fleet API to OpenClaw
- OpenClaw — The agent Gateway this plugin extends
- supercharge.info — Community Supercharger database (powers the discovery tools)
---
MIT
- supercharge.info — Supercharger discovery tools are powered by their community-maintained database of 10,000+ Tesla Superchargers worldwide. Consider supporting them on Patreon.
---
Your Tesla is now part of the workflow.