{"id":46729955,"url":"https://github.com/Oceanswave/openclaw-tescmd","last_synced_at":"2026-03-23T16:01:07.529Z","repository":{"id":336004826,"uuid":"1147723305","full_name":"Oceanswave/openclaw-tescmd","owner":"Oceanswave","description":"OpenClaw platform plugin for Tesla vehicle control and telemetry via tescmd","archived":false,"fork":false,"pushed_at":"2026-02-09T23:23:05.000Z","size":219,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-10T03:37:16.860Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Oceanswave.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-02T06:03:56.000Z","updated_at":"2026-02-09T23:22:57.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Oceanswave/openclaw-tescmd","commit_stats":null,"previous_names":["oceanswave/openclaw-tescmd"],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/Oceanswave/openclaw-tescmd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oceanswave%2Fopenclaw-tescmd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oceanswave%2Fopenclaw-tescmd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oceanswave%2Fopenclaw-tescmd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oceanswave%2Fopenclaw-tescmd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Oceanswave","download_url":"https://codeload.github.com/Oceanswave/openclaw-tescmd/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oceanswave%2Fopenclaw-tescmd/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30863009,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-23T14:38:03.667Z","status":"ssl_error","status_checked_at":"2026-03-23T14:38:01.683Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-03-09T15:00:26.394Z","updated_at":"2026-03-23T16:01:07.516Z","avatar_url":"https://github.com/Oceanswave.png","language":"TypeScript","funding_links":["https://www.patreon.com/supercharge_info"],"categories":["Skills vs Plugins: What's the Difference?","Other Notable Plugins"],"sub_categories":["Bundled Plugins","Smart Home \u0026 IoT"],"readme":"# openclaw-tescmd\n\n**Your Tesla, orchestrated.**\n\nThis 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.\n\n[![npm version](https://img.shields.io/npm/v/@oceanswave/openclaw-tescmd.svg)](https://www.npmjs.com/package/@oceanswave/openclaw-tescmd)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n---\n\n## The Power of Composition\n\nThe real value isn't controlling your Tesla. It's what happens when your agent *combines* tools:\n\n\u003e **\"Send that coffee shop I like to my Cybertruck\"**  \n\u003e Agent: looks up your favorite spot → gets the address → sends it to vehicle navigation\n\n\u003e **\"I'm leaving for the airport in 20 minutes\"**  \n\u003e Agent: checks calendar for flight time → pulls up terminal → pre-conditions cabin → sends airport address to nav\n\n\u003e **\"Road trip to Asheville — find Superchargers along the way\"**  \n\u003e Agent: gets coordinates → `tescmd_superchargers_route` → sends multi-stop nav → sets charge limit to 90%\n\n\u003e **\"Is there a Supercharger near the restaurant?\"**  \n\u003e Agent: gets restaurant coords → `tescmd_superchargers_near` → returns closest options with stall count and power\n\nYour Tesla becomes one node in a larger workflow. The agent handles the orchestration.\n\n---\n\n## Quick Start\n\n### 1. Install the Plugin\n\n```bash\nopenclaw plugins install @oceanswave/openclaw-tescmd\n```\n\n### 2. Connect Your Tesla\n\nThe [tescmd](https://github.com/oceanswave/tescmd) node bridges your vehicle to the Gateway:\n\n```bash\npip install tescmd\ntescmd setup                    # One-time auth\ntescmd serve \u003cVIN\u003e --openclaw \u003cgateway_url\u003e --openclaw-token \u003ctoken\u003e\n```\n\n### 3. Compose Away\n\nYour agent now has 40 Tesla tools that work alongside everything else — calendars, places, weather, messages, web search, and more.\n\n---\n\n## Example Workflows\n\nThese aren't scripted — they're natural language requests your agent can fulfill by chaining tools:\n\n| Request | Tools Involved |\n|---------|---------------|\n| \"Navigate to my 2pm meeting\" | Calendar → Places → `tescmd_nav_send` |\n| \"Road trip to Asheville, find Superchargers\" | goplaces → `tescmd_superchargers_route` → agent picks stops |\n| \"Is there a Supercharger near the restaurant?\" | `tescmd_superchargers_near` (with restaurant coords) |\n| \"Let me know when I'm charged enough to get home\" | `tescmd_get_location` → distance calc → `tescmd_battery_trigger` |\n| \"Prep the car, I'm heading out\" | `tescmd_climate_on` → `tescmd_unlock_doors` |\n| \"Find Superchargers in Richmond\" | `tescmd_superchargers_search` |\n| \"Open the garage when I get home\" | `tescmd_location_trigger` → `tescmd_homelink` |\n\n---\n\n## What the Plugin Provides\n\n### 40 Agent Tools\n\n**Status:** `tescmd_get_battery` · `tescmd_get_location` · `tescmd_get_speed` · `tescmd_get_temperature` · `tescmd_get_charge_state` · `tescmd_get_security`\n\n**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`\n\n**Navigation:** `tescmd_nav_send` · `tescmd_nav_gps` · `tescmd_nav_supercharger` · `tescmd_nav_waypoints` · `tescmd_homelink`\n\n**Superchargers:** `tescmd_superchargers_near` · `tescmd_superchargers_route` · `tescmd_superchargers_search`\n\n**Triggers:** `tescmd_battery_trigger` · `tescmd_cabin_temp_trigger` · `tescmd_outside_temp_trigger` · `tescmd_location_trigger` · `tescmd_list_triggers` · `tescmd_delete_trigger` · `tescmd_get_telemetry`\n\n**Meta:** `tescmd_node_status` · `tescmd_help` · `tescmd_run_command`\n\n### Supercharger Discovery\n\nBuilt-in integration with [supercharge.info](https://supercharge.info) — a community-maintained database of Tesla Superchargers worldwide:\n\n| Tool | Use Case |\n|------|----------|\n| `tescmd_superchargers_near` | Find Superchargers near any coordinates |\n| `tescmd_superchargers_route` | Find Superchargers along a route between two points |\n| `tescmd_superchargers_search` | Search by city, state, or name |\n\nReturns stall count, power level (kW), status, and distance — everything you need to plan charging stops.\n\n### 15 Slash Commands\n\nQuick actions when you don't need the full agent:\n\n| Command | Action |\n|---------|--------|\n| `/battery` | Battery + range |\n| `/charge [start\\|stop\\|80]` | Charging control |\n| `/climate [on\\|off\\|72]` | HVAC control |\n| `/lock` `/unlock` | Door locks |\n| `/sentry [on\\|off]` | Sentry Mode |\n| `/location` | GPS + map link |\n| `/vehicle` | Full status |\n| `/nav \u003caddress\u003e` | Send destination |\n| `/flash` `/honk` | Find your car |\n| `/trunk` `/frunk` | Trunk control |\n| `/homelink` | Garage door |\n| `/supercharger [city]` | Find Superchargers |\n\n### Real-Time Telemetry\n\nThe tescmd node streams live data — battery, location, temperature, charge state, security changes — so your agent always has current information without polling.\n\n---\n\n## Triggers: Event-Driven Automation\n\nTriggers are **push-based** — when conditions are met, the agent receives a notification automatically. No polling required.\n\n```\n\"Alert me if battery drops below 20%\"\n→ tescmd_battery_trigger(operator='lt', value=20)\n\n\"Notify me when the car leaves home\"  \n→ tescmd_location_trigger(operator='leave', lat=..., lon=..., radius=500)\n\n\"Tell me if cabin gets above 100°F\"\n→ tescmd_cabin_temp_trigger(operator='gt', value=100)\n```\n\nCombine with other tools for powerful automation:\n- Trigger fires → Agent checks weather → Sends you a contextual message\n- Geofence exit → Agent locks doors → Enables sentry → Confirms via message\n\n---\n\n## Requirements\n\n| Requirement | Purpose |\n|-------------|---------|\n| Python 3.11+ | tescmd node |\n| Tesla account | Fleet API access |\n| Git + GitHub CLI | Key hosting (one-time setup) |\n\n---\n\n## Configuration\n\nMinimal — the tescmd node handles vehicle config:\n\n```json\n{\n  \"plugins\": {\n    \"entries\": {\n      \"openclaw-tescmd\": {\n        \"enabled\": true\n      }\n    }\n  }\n}\n```\n\n---\n\n## CLI Reference\n\n```bash\nopenclaw tescmd status     # Connection status\nopenclaw tescmd commands   # Available commands\nopenclaw tescmd events     # Telemetry event types\n```\n\n---\n\n## Development\n\n```bash\ngit clone https://github.com/oceanswave/openclaw-tescmd.git\ncd openclaw-tescmd \u0026\u0026 bun install\nbun run check-types \u0026\u0026 bun run lint\nopenclaw plugins install -l ./openclaw-tescmd\n```\n\n---\n\n## Related\n\n- **[tescmd](https://github.com/oceanswave/tescmd)** — Python CLI bridging Tesla Fleet API to OpenClaw\n- **[OpenClaw](https://github.com/openclaw/openclaw)** — The agent Gateway this plugin extends\n- **[supercharge.info](https://supercharge.info)** — Community Supercharger database (powers the discovery tools)\n\n---\n\n## License\n\nMIT\n\n## Acknowledgments\n\n- **[supercharge.info](https://supercharge.info)** — Supercharger discovery tools are powered by their community-maintained database of 10,000+ Tesla Superchargers worldwide. Consider [supporting them on Patreon](https://www.patreon.com/supercharge_info).\n\n---\n\n*Your Tesla is now part of the workflow.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FOceanswave%2Fopenclaw-tescmd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FOceanswave%2Fopenclaw-tescmd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FOceanswave%2Fopenclaw-tescmd/lists"}