Tesla 接入 Home Assistant 终极指南:用 Tesla Custom Integration 打造你的专属车辆仪表盘

原创2026-11-10 11:33:501,838 阅读

Tesla 接入 Home Assistant 终极指南:用 Tesla Custom Integration 打造你的专属车辆仪表盘

想在 Home Assistant 里实时查看 Tesla 的电量、续航、充电桩状态,还能远程解锁、开空调?Tesla Custom Integration 就是为此而生的特斯拉自定义集成——它是官方 Tesla 集成(因登录问题被移除)的社区接替者,通过第三方应用生成的 refresh token 登录特斯拉云服务,让你的 HA 仪表盘秒变"车辆中控屏"。本文手把手带你完成安装、配置,并讲解轮询、电池续航等关键设置。

为什么选择 Tesla Custom Integration

  • ✅ 功能全面:覆盖传感器、锁、空调、开关、设备追踪等 12 类实体平台,完整定义见 const.py 中的 PLATFORMS 列表。
  • ✅ 持续维护:由社区活跃维护,集成域名为 tesla_custom(见 manifest.json)。
  • ✅ 配置流支持:全程图形界面操作,无需手写 YAML,配置流程实现在 config_flow.py。
  • ✅ 能源站点支持:如果你有 Powerwall,还可同步太阳能、电网、电池等能源数据。

💡 该集成通过云端轮询(iot_class: cloud_polling)获取数据,默认每 660 秒轮询一次,车辆休眠时不会被唤醒,对电池消耗友好。

安装前准备:生成 Tesla Refresh Token

Home Assistant 无法直接登录特斯拉账号,需要借助第三方应用生成一个 refresh token:

设备 推荐应用
Android Tesla Tokens
iOS Auth App for Tesla
电脑浏览器 Chromium Tesla Token Generator
TeslaFi 用户 Tesla v3 API Tokens

在对应应用中登录特斯拉账号后,按提示生成并复制 refresh token(通常以 https:// 开头的一长串字符),接下来配置集成时直接粘贴即可。

快速安装:HACS 一键完成

方式一:HACS 安装(推荐)

  1. 打开 HACS → Integrations → Explore & Add Repositories,搜索 "Tesla" 并添加该仓库;
  2. 在 HACS 中找到 Tesla 集成,点击 Install;
  3. 重启 Home Assistant,并强制刷新浏览器缓存。

方式二:手动安装

如果未安装 HACS,也可以手动把集成放入配置目录:

  1. 打开 Home Assistant 配置目录(即 configuration.yaml 所在文件夹);
  2. 若没有 custom_components 目录,先创建它;
  3. 在其中新建 tesla_custom 文件夹;
  4. 将本仓库 custom_components/tesla_custom/ 下的全部文件放入该文件夹;
  5. 重启 Home Assistant。

添加集成:图形化配置流程

重启后,在 HA 界面进入 Settings → Devices & Services,点击 + 搜索 "Tesla Custom Integration",然后按向导填写:

配置项 说明
Use Fleet API Proxy 较新车型可能勾选,需先安装 Tesla HTTP Proxy 插件
Email 特斯拉账号邮箱
Refresh Token 粘贴上一步生成的 token
MFA Code 开启两步验证时填写(可选)
Include Vehicles 选择要纳入的车型
Include Energy Sites 选择要纳入的能源站点

⚠️ 配置过程会强制唤醒车辆,属于正常现象。各字段的定义可在 strings.json 中查证。

仪表盘能显示什么:实体清单一览

安装完成后,你的 Tesla 会生成一整套实体,足以撑起一整页仪表盘卡片:

  • 📊 传感器:电量、充电站功率、车内外温度、预计续航、胎压、充电桩预计完成时间等;
  • 🚪 二态传感器:充电连接、充电状态、车辆在线、驻车制动、车门状态等;
  • 🔋 开关:充电、哨兵模式、代客模式、方向盘加热;
  • ❄️ 空调:开关空调、设定目标温度、除霜/露营/狗狗模式;
  • 🔒 锁:车门锁、充电口锁;
  • 🪟 覆盖物:充电门、前备箱、后备箱、车窗的开合控制;
  • 🔔 按钮:喇叭、闪灯、远程启动、唤醒车辆、HomeLink 车库门(默认关闭,可手动启用);
  • 🧭 设备追踪:车辆实时位置与当前导航目的地;
  • 🧴 下拉选择:座椅加热、车内过热保护;
  • 📦 更新:车辆软件版本与 OTA 更新状态。

有 Powerwall 的用户还能获得太阳能功率、电网功率、负载功率、电池剩余电量等能源实体。

关键选项:轮询与唤醒策略

在 Settings → Integrations → Tesla → Options 中可调整核心行为:

选项 建议
Seconds between polling 默认 660 秒;轮询太频繁可能让车辆保持"清醒"并消耗电池
Wake cars on start HA 启动时是否强制唤醒车辆,建议关闭以节省电池
Sync Data from TeslaMate via MQTT 若已部署 TeslaMate,可开启 MQTT 实时同步,相当于获得流式更新能力,相关逻辑见 teslamate.py

💡 小技巧:想让车辆定时"醒来"刷新数据?可以在自动化里向车辆发送一条无害指令(如上锁),车辆醒来后即可拉取最新信息。

常见问题与排查

Q:发送指令时日志出现 teslajsonpy.exceptions.TeslaException?

你的车型很可能受特斯拉新 Fleet API(端到端加密)影响,需要额外安装 Tesla HTTP Proxy 插件并配置代理地址。代理相关配置项 api_proxy_enable、api_proxy_url、api_proxy_cert 定义在 const.py。

Q:想执行集成没有内置的 API 指令?

集成自带 tesla_custom.api 服务,可调用任意 teslajsonpy 端点(如 WAKE_UP、CLIMATE_ON、START_CHARGE),字段说明见 services.yaml。

Q:配置时提示 Invalid authentication?

refresh token 已失效或复制不完整,重新用第三方应用生成一个新 token 即可。

总结

  • 用第三方 App 生成 refresh token 是使用本集成的前提;
  • HACS 安装只需 3 步:添加仓库 → Install → 重启;
  • 配置后自动获得传感器、锁、空调、开关等全套车辆实体;
  • 善用 Options 中的轮询策略,在数据实时性与车辆电池健康之间取得平衡。

按照以上步骤,你就能在 Home Assistant 里拥有一个功能完整的 Tesla 车辆仪表盘——远程解锁、远程开空调、查看续航,一句话让 HA 变成你的"第二车钥匙" 🚗

登录后查看全文
tesla