tescmd

🚗 特斯拉车辆 AI 控制与遥测网关

OpenClaw Tesla 网关插件,通过 tescmd 节点连接特斯拉 Fleet API,提供 39 项车辆控制工具、实时遥测流与充电站发现功能。

收藏
11.5k
安装
2.9k
版本
0.3.5
CLS 安全性认证2026-08-05
点击查看完整报告 >

使用说明

核心用法

OpenClaw Tesla (tescmd) 是一个 OpenClaw 网关插件,用于将特斯拉车辆接入 AI Agent 控制体系。其架构采用三层设计:Agent 通过 OpenClaw Gateway 调用插件工具,插件通过 WebSocket 将指令路由至 tescmd 节点(Python CLI),节点再与特斯拉 Fleet API、车辆指令协议(VCSEC)及遥测流建立连接。

部署流程分为 7 个步骤:检查前置依赖(git、GitHub CLI、Python 3.11+、Tailscale)→ 安装 OpenClaw 插件 → 安装 tescmd CLI → 运行交互式设置向导(创建 Tesla 开发者应用、生成 EC 密钥对、OAuth2 登录、车辆配对)→ 识别车辆 VIN → 启动节点并完成与网关的一次性配对 → 验证连接状态。

插件安装后自动注册 39 个可调用的 Agent 工具、14 个斜杠命令,支持实时遥测流、超级充电站发现(10,000+ 站点),并可在节点离线时提供 CLI 回退。

显著优点

1. 完整功能覆盖:39 项工具涵盖车辆状态查询、远程控制、充电管理、空调控制、媒体控制等全场景
2. 实时遥测:通过 WebSocket 流式传输驾驶、充电数据,支持字段预设(driving/charging/all)

3. 多重部署模式:支持 Full(默认)、Bridge-only、Tailscale Funnel 暴露、Dry-run 等运行模式

4. 安全架构:采用 Tesla 官方 Fleet API,VCSEC 签名指令协议,OAuth2 认证,密钥本地存储

5. 零基础设施选项:推荐 Tailscale 提供 HTTPS 端点,无需自建公网服务

6. 生态集成:与 OpenClaw Gateway 深度集成,节点配对后自动管理令牌,无需手动处理

潜在局限

1. 部署复杂度高:需同时满足 Python 3.11+、GitHub CLI、Tailscale 等多重前置条件,设置向导涉及浏览器交互和物理车辆在场,Agent 无法独立完成
2. 令牌生命周期:Tesla OAuth 令牌存在过期风险,需定期重新认证(tescmd auth login

3. 网络依赖严苛:遥测流和实时控制依赖稳定的 WebSocket 连接,节点断线时功能降级为 CLI 回退

4. 地域限制:Tesla Fleet API 按区域(na/eu/cn)划分,需正确配置 TESLA_REGION

5. 单节点设计:当前架构为单车单节点,多车管理需部署多个实例

6. 物理配对要求:车辆密钥配对需车主携带已授权钥匙现场操作

适合人群

  • 技术型特斯拉车主:具备 CLI 操作能力,熟悉 OAuth 流程和密钥管理
  • 智能家居集成者:希望将特斯拉接入 OpenClaw 生态,实现语音控制、自动化工作流
  • 开发者与极客:需要实时车辆遥测数据进行二次开发或数据分析
  • 企业车队管理:具备技术运维能力,需批量管理车辆的小型车队

常规风险

| 风险类别 | 描述 | 缓解措施 |
|---------|------|---------|
| 授权令牌泄露 | `~/.config/tescmd/` 中的令牌和密钥文件若权限不当,可能被本地进程读取 | 确保配置目录权限 700,定期检查 `tescmd auth status` |
| 中间人攻击 | WebSocket 连接若使用非 TLS 传输,存在截获风险 | 始终使用 `wss://` 或 Tailscale 加密隧道 |
| 误操作指令 | Agent 可能误发车辆控制指令(如远程启动、解锁) | 生产环境建议启用 `--dry-run` 模式验证,或限制工具调用权限 |
| 车辆钥匙失效 | 密钥配对失败或 Tesla 账户变更导致授权失效 | 保留物理钥匙备份,定期验证 `tescmd vehicle info` 连通性 |
| API 速率限制 | Tesla Fleet API 存在调用配额,高频遥测可能触发限流 | 调整 `--interval` 轮询间隔,避免 `--fields all` 常驻运行 |
| 节点单点故障 | tescmd 节点进程崩溃导致网关工具不可用 | 配置进程守护(systemd/supervisor),监控 `openclaw nodes status` |

该技能适合具备一定技术基础的用户,在正确配置后可提供生产级的车辆智能化管理能力。

安全解读

核心用法

OpenClaw Tesla (tescmd) 是一套面向 Tesla 车主的智能化车辆控制插件体系,通过 OpenClaw Gateway 将 Tesla Fleet API 与 AI Agent 无缝连接。用户需完成三步核心部署:首先通过 tescmd setup 交互式向导完成 Tesla 开发者应用注册、EC 密钥生成及 OAuth2 认证;随后以 tescmd serve <VIN> --openclaw <gateway_url> 启动节点并与网关配对;最终获得 39 个可调用工具、14 个斜杠命令及实时遥测流的能力。

该技能支持多种运行模式:Full 模式(默认)提供 MCP 服务、遥测与网关桥接;Bridge-only 模式专注网关通信;Tailscale 模式通过 Funnel 暴露公网 HTTPS 端点;Dry-run 模式仅本地日志记录。遥测数据覆盖驾驶状态、充电信息及全量车辆数据,配合 supercharge.info 的万级超充站数据库,实现完整的出行决策支持。

显著优点

深度协议整合:直接对接 Tesla 官方 Fleet API 与 Vehicle Command Protocol (VCSEC),支持签名命令下发,安全等级远高于第三方逆向方案。零基础设施依赖:推荐搭配 Tailscale 实现内网穿透,无需云服务器即可建立稳定 WebSocket 连接。生态完整性:从认证、配对到日常使用的全流程工具链,CLI 与 Agent 调用双轨并行,断网时仍可本地操作。实时数据丰富:遥测流可订阅 20+ 字段,支持驾驶/充电场景预设,数据可导出 CSV 用于分析。透明可信:全开源架构,密钥本地存储于 ~/.config/tescmd/,无中间商数据截留风险。

潜在缺点与局限性

部署门槛显著:需同时掌握 Python 3.11+、GitHub CLI、Tailscale 及 Tesla 开发者平台操作,非技术用户难以独立完成。物理配对强制:车辆密钥配对需携带已认证设备亲临车内,无法远程完成,且每辆车需独立配置。地域策略差异:Tesla Fleet API 在北美、欧洲、中国采用不同端点与合规策略,跨区域用车需手动切换 --region 参数。Token 生命周期:OAuth2 令牌存在过期机制,需定期执行 tescmd auth login 刷新,自动化场景需额外监控。网络拓扑敏感:遥测流依赖双向 WebSocket,部分企业防火墙或运营商 NAT 环境可能阻断连接,Tailscale 虽缓解但仍需 UDP 支持。

适合的目标群体

技术型 Tesla 车主:具备 CLI 操作能力、愿意投入 30-60 分钟完成初始配置的极客用户。智能家居集成者:希望将车辆状态接入 Home Assistant、Node-RED 或自研系统的自动化爱好者。车队管理需求方:中小企业需批量监控多辆车状态、生成用车报表的轻量级管理场景。开发者与研究者:对 Tesla 车辆数据科学、能耗建模或自动驾驶辅助系统有研究需求的技术人员。隐私优先用户:拒绝第三方 App 数据收集、坚持本地化处理车辆信息的敏感人群。

常规使用风险

依赖项维护负担:tescmd 节点与 OpenClaw Gateway 版本需保持兼容,升级时需同步验证;Python 依赖库(如 cryptographywebsockets)的安全更新需及时跟进。证书与密钥管理:EC 私钥泄露将导致车辆被非法控制,建议配置文件系统权限 600 并定期轮换;GitHub Pages 托管公钥方案存在仓库可见性误配置风险。API 配额与限流:Tesla Fleet API 存在未公开的调用频率上限,高频遥测可能触发封禁,建议通过 --interval 参数合理设置轮询间隔。车辆固件兼容性:Tesla 频繁推送 OTA 更新,部分命令在新版本中行为变更,需关注 tescmd 仓库 Issue 区获取兼容性公告。网关单点故障:OpenClaw Gateway 作为中心节点宕机时将阻断所有 Agent 控制,建议配置健康检查与自动重启策略。

tescmd 内容

手动下载zip · 4.3 kB
SKILL.mdtext/markdown
请选择文件