Tesla

🚗 命令行远程控车,安全多车管理

通过官方 Tesla API 远程控制车辆,支持多车管理、气候控制、充电管理及定位追踪,需主动授权且禁止自动调用。

收藏
13.6k
安装
2.8k
版本
1.0.4
CLS 安全性认证2026-07-14
点击查看完整报告 >

使用说明

核心功能

Tesla Skill 允许用户通过命令行与 Tesla 车辆直接交互,实现远程车门锁控、空调气候调节、充电状态监控与启停、实时定位查询以及鸣笛闪灯等物理控制操作。该技能基于社区维护的 teslapy 库,调用 Tim Dorr 文档化的非官方 Tesla Owner API,采用标准 OAuth 2.0 授权流程完成首次认证,后续通过刷新令牌自动续期(约30天有效期)。

显著优势

官方级安全架构:完整复刻 Tesla 官方 OAuth 流程,不存储用户密码,令牌本地加密缓存于 ~/.tesla_cache.json,通信仅限用户设备与 Tesla 服务器之间,无第三方数据中转。 多车账户原生支持:针对拥有多辆 Tesla 的用户,可通过 --car 参数精确指定操作对象,避免误操作风险。 物理安全隔离设计disable-model-invocation: true 强制禁止 AI 代理自动调用,每次指令需用户主动触发,杜绝未授权远程操控。

潜在局限与风险

非官方 API 依赖:尽管基于公开文档,API 端点可能随 Tesla 服务端更新而变更,存在突发兼容性问题;社区库维护响应速度不及官方 SDK。 令牌泄露风险:刷新令牌若被恶意获取,可在有效期内(约30天)持续控制车辆,建议严格限制文件权限并定期轮换。 车辆唤醒延迟:Tesla 车辆深度休眠时需 wake 命令激活,指令响应可能延迟 10-30 秒。 地域与网络限制:部分功能(如充电价格查询)受 Tesla 服务器区域策略影响。

适合人群

  • 拥有 Tesla 车辆且偏好命令行/自动化工作流的技术型车主
  • 多车家庭需要快速切换管理不同车辆的场景
  • 对车辆数据隐私敏感、希望避免第三方 App 托管凭证的用户

常规风险提醒

⚠️ 物理操控不可逆:远程解锁、移动指令直接作用于实体车辆,请确认安全环境后再执行。 ⚠️ 气候控制能耗:远程空调长时间运行将消耗电池电量,极端情况下可能影响续航里程。 ⚠️ OAuth 令牌保管:避免在共享设备或未加密存储中使用,建议配合系统级密钥管理工具。

安全解读

核心用法

Tesla Skill 允许通过命令行或自然语言对话远程控制 Tesla 车辆。首次使用需通过 TESLA_EMAIL 环境变量配置账户邮箱,运行 auth 命令完成 OAuth 授权流程,令牌自动缓存约 30 天。

主要功能

  • 车辆状态:查看电量、位置、锁定状态
  • 远程控制:锁车/解锁、鸣笛、闪灯
  • 气候控制:开启/关闭空调、设定温度
  • 充电管理:查看充电状态、启动/停止充电
  • 多车支持:通过 --car 参数切换不同车辆

显著优点

1. 安全设计出色:采用官方 OAuth 2.0 流程,不存储密码;令牌本地加密缓存;HTTPS 全程加密
2. 物理安全隔离:明确设置 disable-model-invocation: true,禁止 AI Agent 自主调用,必须用户显式触发每个命令

3. 多车管理便捷:支持一个账户下的多辆车,通过车名快速切换

4. 代码质量高:静态分析 95 分,无危险函数调用,无敏感信息硬编码

5. 隐私合规良好:仅收集必要邮箱,符合 GDPR/CCPA 最小权限原则

潜在缺点与局限性

1. 依赖社区库:核心依赖 teslapy 为非官方社区维护库(T3 来源),非 Tesla 官方 SDK,存在供应链攻击风险
2. 令牌管理风险:OAuth 令牌缓存在本地 ~/.tesla_cache.json,多用户系统可能存在泄露风险

3. 物理控制风险:可控制真实车辆(解锁、鸣笛等),误操作或权限泄露后果严重

4. 非官方 API:依赖逆向工程的非官方 API,Tesla 可能随时变更接口导致功能失效

5. 无企业背书:MIT 许可证,无顶级开源基金会或公司维护

适合人群

  • Tesla 车主:需要远程管理多辆车的个人用户
  • 技术爱好者:熟悉命令行、理解 OAuth 流程和 API 风险的开发者
  • 隐私敏感用户:希望数据仅与 Tesla 官方服务器交互,不经过第三方平台

常规风险

| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 供应链攻击 | 中 | teslapy 库作者账户被盗可能导致恶意代码注入 |
| 令牌泄露 | 中 | 共享设备上缓存文件权限不当可能导致账户被盗 |
| 物理安全 | 低-中 | 车辆被远程解锁、启动等意外操作 |
| API 失效 | 低 | Tesla 官方 API 变更可能导致功能中断 |

Tesla 内容

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