# Tescmd

> Control and monitor Tesla vehicles via the tescmd node. Get battery, climate, location, lock/unlock doors, start/stop charging, find Superchargers, and more.

- Skill: `oceanswave-openclaw-tescmd/tescmd` (Agent Skill)
- Install (CLI): `npx skillmds@latest add oceanswave-openclaw-tescmd/tescmd`
- Raw SKILL.md: https://api.skillmd.com/api/skills/oceanswave-openclaw-tescmd/tescmd/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: oceanswave (https://skillmd.com/u/oceanswave-openclaw-tescmd)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/oceanswave-openclaw-tescmd/tescmd

---


# Tesla Vehicle Control (tescmd)

Control and monitor Tesla vehicles through the OpenClaw Gateway. This skill covers **runtime usage** — for installation and setup, see the `tescmd_install` skill.

## Prerequisites

- tescmd node running and connected to the Gateway (preferred), OR
- tescmd CLI installed locally (fallback mode)
- Vehicle paired and authenticated

**Version Note:** The plugin and tescmd node versions are **independent** — they do not need to match. The plugin provides agent tools that invoke commands on whatever node version is connected.

Verify connection:
```bash
openclaw nodes status
```

Or use the agent tool: `tescmd_node_status`

**CLI Fallback**: If no node is connected but the `tescmd` CLI is installed, basic commands (lock, unlock, climate, charge, honk, flash) and data queries (battery, temperature, location) will fall back to CLI execution. Response includes `{ fallback: true }` when CLI is used.

---

## Quick Commands

### Vehicle Status

| Task | Tool | Example |
|------|------|---------|
| Battery level & range | `tescmd_get_battery` | "What's my battery at?" |
| Charge state | `tescmd_get_charge_state` | "Is the car charging?" |
| Location | `tescmd_get_location` | "Where's my car?" |
| Temperature (inside/outside) | `tescmd_get_temperature` | "How cold is it in the car?" |
| Speed | `tescmd_get_speed` | "Is the car moving?" |
| Lock status | `tescmd_get_security` | "Is the car locked?" |

### Climate Control

| Task | Tool |
|------|------|
| Turn on climate | `tescmd_climate_on` |
| Turn off climate | `tescmd_climate_off` |
| Set temperature | `tescmd_set_climate_temp` (temp in °F) |

### Security

| Task | Tool |
|------|------|
| Lock doors | `tescmd_lock_doors` |
| Unlock doors | `tescmd_unlock_doors` |
| Flash lights | `tescmd_flash_lights` |
| Honk horn | `tescmd_honk_horn` |
| Enable sentry mode | `tescmd_sentry_on` |
| Disable sentry mode | `tescmd_sentry_off` |

### Charging

| Task | Tool |
|------|------|
| Start charging | `tescmd_start_charge` |
| Stop charging | `tescmd_stop_charge` |
| Set charge limit | `tescmd_set_charge_limit` (percent 50-100) |

### Trunk/Frunk

| Task | Tool |
|------|------|
| Open/close trunk | `tescmd_open_trunk` |
| Open frunk | `tescmd_open_frunk` |

### Navigation

| Task | Tool | Parameters |
|------|------|------------|
| Send address | `tescmd_nav_send` | `address` (address string) |
| Send GPS coords | `tescmd_nav_gps` | `lat`, `lon`, optional `order` |
| Navigate to supercharger | `tescmd_nav_supercharger` | |
| Multi-stop route | `tescmd_nav_waypoints` | `waypoints` (comma-separated Place IDs) |
| Trigger HomeLink | `tescmd_homelink` | `lat`, `lon` |

---

## Supercharger Discovery

Find Tesla Superchargers anywhere, powered by [supercharge.info](https://supercharge.info):

| Task | Tool | Parameters |
|------|------|------------|
| Find nearby | `tescmd_superchargers_near` | `latitude`, `longitude`, optional `radius_miles`, `limit` |
| Find along route | `tescmd_superchargers_route` | `start_lat`, `start_lon`, `end_lat`, `end_lon`, optional `corridor_miles` |
| Search by name/city | `tescmd_superchargers_search` | `query`, optional `status`, `limit` |

### Example Workflows

**Road trip planning:**
```
"Road trip to Asheville — find Superchargers along the way"
→ Get Asheville coords with goplaces
→ tescmd_superchargers_route with start/end coords
→ Returns Superchargers with distance, stall count, power level
```

**Find charging near destination:**
```
"Is there a Supercharger near the restaurant?"
→ Get restaurant coords
→ tescmd_superchargers_near
→ Returns closest Superchargers with distance
```

---

## Telemetry Triggers

Set up alerts when telemetry values cross thresholds. **Triggers are push-based** — when a trigger fires, the tescmd node automatically notifies the agent. You don't need to poll; just create the trigger and respond when notified.

**Note:** Use domain-specific trigger tools for type safety and correct units. The generic trigger tool has been removed to prevent unit/format errors.

### How Triggers Work

1. **Create a trigger** with a condition (e.g., battery < 20%, location enters geofence)
2. **The node monitors** telemetry in real-time
3. **When the condition fires**, the node pushes a notification to the agent
4. **The agent responds** by taking the requested action

This enables automation like:
- "When I arrive at the gym, post on X that I'm working out"
- "When battery drops below 20%, text me"
- "When cabin temp exceeds 100°F, turn on climate"

### Manage Triggers

| Task | Tool |
|------|------|
| List active triggers | `tescmd_list_triggers` |
| Delete trigger | `tescmd_delete_trigger` |

**Note:** Triggers are push-based. When a trigger fires, the agent receives a system event automatically — no polling required.

### Trigger Tools

Always use these domain-specific tools:

| Tool | Field | Example Use |
|------|-------|-------------|
| `tescmd_cabin_temp_trigger` | InsideTemp | Alert if cabin > 90°F |
| `tescmd_outside_temp_trigger` | OutsideTemp | Alert if freezing |
| `tescmd_battery_trigger` | BatteryLevel | Alert if < 20% |
| `tescmd_location_trigger` | Location | Geofence enter/leave |

### Trigger Operators

- `lt`, `gt`, `lte`, `gte` — less/greater than
- `eq`, `neq` — equals / not equals
- `changed` — any value change
- `enter`, `leave` — geofence (location triggers)

### Example: Low Battery Alert

```
Create a trigger to alert me when battery drops below 20%
→ tescmd_battery_trigger with operator="lt", value=20
→ When fired, the node notifies the agent automatically
```

### Example: Geofence Automation

```
"When I park at the gym, post on X that I'm working out"
→ Use goplaces to get gym coordinates
→ tescmd_location_trigger with operator="enter", lat=39.109, lon=-77.550, radius=100
→ When vehicle enters the geofence, node notifies agent
→ Agent generates image and posts to X
```

---

## Common Workflows

### Pre-conditioning Before a Trip

1. Check current temperature: `tescmd_get_temperature`
2. Turn on climate: `tescmd_climate_on`
3. Optionally set temp: `tescmd_set_climate_temp` with desired °F
4. Check battery: `tescmd_get_battery`

### Send a Route to the Car

1. Use `tescmd_nav_send` with the destination address
2. Or use `tescmd_nav_gps` for exact coordinates
3. For multi-stop routes, see "Multi-Stop Routes with Waypoints" below

### Multi-Stop Routes with Waypoints

The `tescmd_nav_waypoints` tool requires Google Place IDs. **If the `goplaces` skill is installed** (requires `GOOGLE_PLACES_API_KEY`), the agent should automatically resolve addresses to Place IDs.

**Agent behavior for multi-stop routes:**
1. User requests a multi-stop route (e.g., "send my beach route to the car")
2. Check if `goplaces` is available (look for the skill in available_skills)
3. For each stop address, run: `goplaces resolve "<address>" --json`
4. Extract the `place_id` from each result (it's in the JSON array: `[0].place_id`)
5. Combine Place IDs into a comma-separated string
6. Call `tescmd_nav_waypoints` with the combined waypoints

**Example:**
```
User: "Load my beach route: coffee at Hornes Port Royal, Supercharger in Tappahannock, then OBX"

Agent:
1. goplaces resolve "Hornes, Port Royal, VA" --json → ChIJn7WjLIHYtokRCOgQWXQZ5l8
2. goplaces resolve "Tesla Supercharger Tappahannock, VA" --json → ChIJwSd9CKXLsIkR4QPmAJuAO1I
3. goplaces resolve "Outer Banks, NC" --json → ChIJcWxzpzxbpIkRszbSdWERdxs
4. tescmd_nav_waypoints with waypoints="ChIJn7...,ChIJwS...,ChIJcW..."
```

**Note:** If `goplaces` is not configured, inform the user that multi-stop routes require the Google Places API.

### Plan a Road Trip with Charging

1. Get start/end coordinates
2. Call `tescmd_superchargers_route` to find Superchargers along the way
3. Review options (stall count, power level, distance)
4. Send destination with `tescmd_nav_send`

### Monitor Charging

1. Check state: `tescmd_get_charge_state`
2. Check level: `tescmd_get_battery`
3. Set limit if needed: `tescmd_set_charge_limit`
4. Start/stop: `tescmd_start_charge` / `tescmd_stop_charge`

---

## Error Handling

| Error | Cause | Solution |
|-------|-------|----------|
| "no node connected" | tescmd node not running | Start: `tescmd serve <VIN> --openclaw <url>` |
| "vehicle offline" | Car is asleep or out of range | Wait or wake via Tesla app |
| "command timeout" | Vehicle didn't respond in time | Retry; car may be in deep sleep |
| "unauthorized" | Token expired | Run `tescmd auth login` |

---

## Slash Commands

Quick commands available from chat (14 total):

| Command | Description |
|---------|-------------|
| `/battery` | Battery level and range |
| `/charge [start\|stop\|80]` | Charging control |
| `/climate [on\|off\|72]` | Climate/temperature control |
| `/lock` | Lock the vehicle |
| `/unlock` | Unlock the vehicle |
| `/sentry [on\|off]` | Sentry mode control |
| `/location` | Vehicle location with map link |
| `/vehicle` | Full vehicle status summary |
| `/nav <address>` | Send destination to navigation |
| `/flash` | Flash headlights |
| `/honk` | Honk horn |
| `/trunk` | Open/close rear trunk |
| `/frunk` | Open front trunk |
| `/homelink` | Trigger garage door |

---

## Tips

- **Wake time**: If the car is asleep, commands may take 10-30 seconds as it wakes
- **Signed commands**: Door lock/unlock use signed Vehicle Command Protocol for security
- **Telemetry**: Real-time data (location, temp, battery) comes from Fleet Telemetry stream — instant when available, falls back to API polling
- **Triggers**: Require telemetry streaming enabled (default). Use `--fields all` when starting the node for full coverage.
- **Superchargers**: Data from supercharge.info, cached for 1 hour. Community-maintained, 10,000+ locations worldwide.

---

## Full Reference

Call `tescmd_help` for the complete tool reference with all parameters and detailed descriptions.