Tesla Token

特斯拉 API 授权令牌

Tesla Token 是特斯拉基于 OAuth2.0 开放车主 API 生成的授权密钥，相当于车辆的数字临时钥匙。第三方工具（TeslaMate、HomeAssistant、Teslog 等）不直接输入特斯拉账号密码，而是携带 Token 向特斯拉服务器拉取车辆数据、下发远程控制指令。

• Tesla Auth (macOS, Linux, Windows)

• Auth app for Tesla (iOS, macOS)

两种核心 Token：Access Token + Refresh Token

特斯拉登录授权后会同时生成一对令牌，分工不同、有效期差异巨大，也是 TeslaMate 持续采集数据的核心基础。

1. Access Token（访问令牌）

• 作用：所有车辆数据查询、远程控车（开空调、解锁、充电）必须携带此令牌；每次 API 请求头部带上 Authorization: Bearer {access_token} 鉴权。
  

• 有效期：中国区约 8 小时（全球通用 86400 秒 / 24 小时区间），到期立即失效，无法单独续用。
  

• 特点：短期有效、泄露风险低，即使被盗，几小时后自动作废。

2. Refresh Token（刷新令牌，TeslaMate 核心依赖）

• 作用：Access Token 过期后，用 Refresh Token 向特斯拉服务器换取全新 Access Token，无需重复登录特斯拉账号，实现 7×24 小时不间断采集数据。
  

• 有效期：官方标准 90 天，国内实际使用约 45~90 天；单次刷新后旧 Refresh Token 直接作废，系统会下发新 Refresh Token，工具需同步更新本地存储Tesla。
  

• 特点：长期有效，一旦泄露他人可长期操控车辆，属于高敏感密钥，必须严格保管。

Tesla Token 能实现哪些功能（TeslaMate 场景）

拥有有效 Token 后，第三方私有化工具可完整调取车辆全部数据，也是 TeslaMate 运行的唯一前置条件：

• 实时状态监控
  电量、真实续航、胎压、车内 / 车外温度、门锁状态、哨兵模式、充电功率、车辆休眠 / 行驶状态、定位坐标、软件版本。
  

• 行程全量记录
  每次行驶轨迹、里程、平均 / 最高时速、能耗、动能回收、海拔变化，长期生成月度 / 年度能耗报表。
  

• 充电数据统计
  交流 / 直流充电曲线、电池温度、静置待机损耗，自定义峰谷电价自动核算充电成本。
  

• 电池健康追踪
  长期记录满电可用容量、充放电循环次数，生成电池衰减趋势图（官方 App 无此功能）。
  

• 远程车辆控制
  远程开启空调、解锁车辆、开启哨兵、预约充电、控制充电电流等。
  

• 智能家居联动（MQTT 对接 HA）
  车辆状态联动全屋自动化：到家自动开空调、充满电推送通知、车辆停靠家 / 公司触发场景。

Token 工作流程（TeslaMate 自动运行逻辑）

• 用户完成 OAuth 授权，获取 Access Token + Refresh Token；
  

• TeslaMate 使用本地加密密钥加密存储两组令牌，明文不落地数据库；
  

• 日常轮询车辆数据，携带 Access Token 请求特斯拉 API；
  

• 距离 Access Token 过期剩余 25% 时长（约 6 小时），自动调用刷新接口；
  

• 使用 Refresh Token 换取全新 Access Token + 新 Refresh Token，覆盖本地旧密钥；
  

• Refresh Token 完全过期后，数据采集中断，需重新登录获取全新令牌。

Token 获取渠道

常见失效场景（TeslaMate 无法采集数据）

• Refresh Token 过期（90 天有效期到）：需重新登录生成新令牌；
  

• 修改特斯拉账号密码：所有历史 Token 全部作废；
  

• 更换绑定手机号、开启 / 重置二次验证；
  

• 特斯拉服务器区域切换（国内 / 海外 API 域名不匹配）；
  

• 服务器时间偏差过大，令牌鉴权校验失败；
  

• 本地加密密钥（ENCRYPTION_KEY）被修改，无法解密数据库内 Token。

TeslaMate 专用使用说明

• 部署时填入 Refresh Token，程序自动完成 Access Token 刷新，无需人工干预；
  

• ENCRYPTION_KEY 一旦设定不可修改，修改后原有 Token 永久失效；
  

• 导出备份 Refresh Token，过期前提前重新授权，避免数据断档；
  

• 若使用 H618 等低功耗盒子 7×24 小时运行，无需频繁操作 Token，平均 2~3 个月重新授权一次即可。

总结

Tesla Token 是特斯拉开放 API 的身份凭证，分为短期访问令牌与长期刷新令牌，是 TeslaMate、智能家居等第三方工具调取车辆数据的唯一凭证。

Refresh Token 具备高控制权，存在隐私与车辆操控安全风险，必须本地加密存储、禁止公网传播；当刷新令牌过期、修改账号密码时，需重新完成授权获取新 Token，保障行程、充电、电池数据持续记录。