Tesla Fleet API

🚗 官方 Fleet API 车辆远程控制

通过特斯拉官方 Fleet API 远程控制车辆,支持实时数据读取、空调/充电管理、定时预热等完整功能,需配置 OAuth 和签名代理。

收藏
12.5k
安装
4.1k
版本
1.5.2
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能

Tesla Fleet API Skill 是面向 Tesla 车主的官方 API 集成方案,支持通过 Tesla Fleet API 对车辆进行全面的远程控制与数据监控。相比第三方非官方方案,该 Skill 基于 Tesla 2024 年后强推的 Fleet API 架构,具备更高的合规性与稳定性。

主要能力覆盖

1. 车辆状态实时监控

  • 电池电量、充电状态、剩余里程
  • 车内外温度、HVAC 运行状态
  • 实时位置、车速、挡位信息
  • 门锁/车窗/里程表等车辆状态

2. 远程指令执行

  • 空调系统:启动/停止、温度设定、Climate Keeper 模式(宠物/露营模式)
  • 座椅加热/通风:全座位独立控制,3 级调节
  • 方向盘加热、定时预热计划(支持按天重复)
  • 充电控制:启停充电、设置充电上限(50-100%)
  • 车门锁控制、鸣笛、闪灯、远程唤醒

3. 认证与基础设施

  • 完整的 OAuth 2.0 流程(授权码模式 + Token 自动刷新)
  • 支持多区域部署(北美/欧洲/中国独立 endpoint)
  • 域名注册与虚拟密钥托管(signed commands 必需)
  • 本地签名代理(tesla-http-proxy)用于高安全指令

技术架构特点

该 Skill 采用分层设计:Python 脚本层处理 CLI 交互与数据格式化,底层通过官方 HTTP API 通信。对于需要加密签名的敏感指令(如解锁、启动),自动路由至本地 TLS 代理完成端到端签名。

配置管理采用文件化方案config.json + auth.json),不支持 .env 加载,符合安全审计要求。状态目录隔离设计便于多租户场景。

显著优点

  • 官方合规:基于 Tesla 2024 年 Fleet API 规范,避免车主账号封禁风险
  • 功能完整:覆盖车辆控制全场景,非早期 Owner API 的阉割方案
  • 安全设计:敏感指令强制本地签名,Token 自动轮转,无长期明文凭证
  • 多车辆支持:自动单车辆选择 + 显式 VIN/名称指定
  • 人性化输出:默认 CLI 表格/进度条展示,支持 --json 原始输出

潜在局限与风险

准入门槛高:需完成开发者账号注册、域名验证、SSL 证书托管、Tesla 官方审核,个人用户部署周期可能达数天。

基础设施依赖:signed commands 必需持续运行的本地代理(Docker/进程),移动端场景受限。

Token 管理复杂性:refresh token 轮转机制要求持久化存储,分布式部署需额外同步方案。

区域限制:中国地区 endpoint 独立,部分功能可用性与国际区存在差异。

成本因素:Tesla Fleet API 对商业应用按调用量计费,高频自动化可能产生费用。

适合人群

  • 技术型车主:具备 Linux/网络基础,愿意自建 infra 替代官方 App 受限功能
  • 智能家居集成者:需将 Tesla 接入 Home Assistant、Node-RED 等自动化平台
  • 车队/企业用户:多车辆集中管理、充电策略自动化、数据报表需求
  • 开发者:构建 Tesla 第三方服务的合规后端参考实现

常规风险提示

  • 域名/DNS 配置错误将导致虚拟密钥注册失败
  • 代理证书过期会造成指令签名失败,车辆拒绝执行
  • Token 泄露风险:文件权限需严格限制(建议 600)
  • API 变更风险:Tesla 频繁调整 Fleet API 规范,需跟踪版本更新
  • 车辆唤醒耗电:频繁数据轮询可能增加静置耗电

Tesla Fleet API 内容

scripts文件夹
手动下载zip · 36.0 kB
auth.pytext/plain
请选择文件