Tesla 接入 Home Assistant 终极指南:用 Tesla Custom Integration 打造你的专属车辆仪表盘
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 安装(推荐)
- 打开 HACS → Integrations → Explore & Add Repositories,搜索 "Tesla" 并添加该仓库;
- 在 HACS 中找到 Tesla 集成,点击 Install;
- 重启 Home Assistant,并强制刷新浏览器缓存。
方式二:手动安装
如果未安装 HACS,也可以手动把集成放入配置目录:
- 打开 Home Assistant 配置目录(即
configuration.yaml所在文件夹); - 若没有
custom_components目录,先创建它; - 在其中新建
tesla_custom文件夹; - 将本仓库
custom_components/tesla_custom/下的全部文件放入该文件夹; - 重启 Home Assistant。
添加集成:图形化配置流程
重启后,在 HA 界面进入 Settings → Devices & Services,点击 + 搜索 "Tesla Custom Integration",然后按向导填写:
| 配置项 | 说明 |
|---|---|
| Use Fleet API Proxy | 较新车型可能勾选,需先安装 Tesla HTTP Proxy 插件 |
| 特斯拉账号邮箱 | |
| 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 变成你的"第二车钥匙" 🚗