Tesla Custom Integration 接入 Home Assistant 完整指南：分享你的特斯拉自动化蓝图
【免费下载链接】teslaTesla custom integration for Home Assistant. This requires a refresh token be generated by third-party apps to login.项目地址: https://gitcode.com/GitHub_Trending/tesla/tesla
Tesla Custom Integration（特斯拉自定义集成）是一款 Home Assistant 的第三方集成，让你用智能家居系统远程控制特斯拉：查看电量、解锁车门、开空调、查位置，还能用 Home Assistant 蓝图（Blueprints）一键分享你的特斯拉自动化。它是原官方 Tesla 集成的社区延续版，解决了特斯拉登录方式变更后的兼容问题。
🚗 什么是 Tesla Custom Integration？
由于特斯拉调整了账号登录机制，Home Assistant 原内置的 Tesla 集成已不可用。本集成作为其"继任者"，通过refresh token（刷新令牌）方式登录特斯拉云端，功能与原版一致且持续更新，当前版本为 3.27.0。
它能提供哪些实体？
- 📡传感器：电量、充电速率、预估续航、内外温度、胎压等
- 🔒锁：车门锁、充电口锁
- 🌡️空调：开关空调、设定温度、狗模式/露营模式/除霜
- 🚪覆盖物：充电门、前备箱、后备箱、车窗
- 📍设备追踪器：车辆位置、当前导航目的地
- 🔔二进制传感器：是否在充电、车门状态、车辆休眠状态
- 🔘按钮：鸣笛、闪灯、远程启动、HomeLink 车库门
- ⚡开关：哨兵模式、代客模式、加热方向盘、充电控制
有 Powerwall 太阳能储能的用户，还能看到太阳能功率、电网功率、电池余量等数据。
📦 安装：两种快速方法
方法一：HACS 一键安装（推荐）
- 打开 HACS →「集成」→「探索并添加仓库」
- 添加本仓库地址：
https://gitcode.com/GitHub_Trending/tesla/tesla - 搜索 "Tesla"，点击安装
- 重启 Home Assistant
方法二：手动安装
- 找到 Home Assistant 配置目录（即存放
configuration.yaml的文件夹） - 若无
custom_components文件夹则新建 - 在其中创建
tesla_custom文件夹 - 将本仓库 custom_components/tesla_custom/ 目录下的全部文件下载放入
- 重启 Home Assistant
核心模块位于 custom_components/tesla_custom/，各平台逻辑分别在sensor.py、climate.py、lock.py、cover.py等文件中，命名清晰，便于了解它如何驱动每类实体。
🔑 首次配置：生成 Refresh Token
这是唯一的前置条件——你需要一个刷新令牌：
| 平台 | 工具 |
|---|---|
| Android | Tesla Tokens 应用 |
| iOS | Auth App for Tesla |
| 桌面浏览器 | Chromium/Edge 特斯拉令牌生成器 |
然后进入 Home Assistant「设置」→「设备与服务」→「+」，搜索Tesla Custom Integration，填入邮箱和 refresh token 即可完成配置。
⚠️ 提示：安装过程中集成会唤醒你的车辆以获取初始数据，属正常现象。
⚡ 分享你的特斯拉自动化蓝图
装好集成后，就可以把日常场景变成自动化，并通过 Home Assistant 的Blueprints（蓝图）功能分享给其他用户，例如：
- 🌅早安唤醒：每天早上发送一次无害的锁车指令唤醒车辆，刷新电量与位置
- 🧊远程预冷：出发前 10 分钟自动打开空调，上车即凉爽
- 🏠到家自动充电：车辆在家且电量低于 80% 时开始充电
- 🔋低电提醒：续航里程低于阈值时推送通知
蓝图让其他用户只需在 Home Assistant 中选择"添加蓝图"，填入车辆实体即可复用你的自动化，无需复制粘贴长段配置。
🔧 轮询策略：保护好你的车电池
特斯拉长时间在线会消耗电池电量，集成默认每 660 秒轮询一次（见 custom_components/tesla_custom/const.py 中的默认值）。
在「集成」→「Tesla」→「选项」中可调整：
- 轮询间隔：过频轮询会让车辆保持唤醒并耗电
- 启动时唤醒车辆：Home Assistant 重启时是否唤醒休眠车辆
- 轮询策略：normal（默认）/ connected / always 三档
- TeslaMate 同步：通过 MQTT 实时同步数据，替代轮询
💡 经验：不同固件休眠需 11~15 分钟，建议从默认值起步，逐步微调找到最佳平衡点。你也可以用自动化开关"轮询开关"来完全关闭某段时间的轮询。
❓ 常见问题
Q：日志出现teslajsonpy.exceptions.TeslaException错误？多数是特斯拉已弃用旧版 Owner API，需安装 Tesla HTTP Proxy 附加组件并配置代理，集成选项中已有对应的代理配置字段。
Q：传感器有数据但控制命令无效？同样是 API 代理问题，数据读取通常不受影响，指令下发需要代理。
Q：HomeLink 按钮在哪里？默认禁用（部分车型没有此功能），可在实体设置中手动启用。
📌 小结
Tesla Custom Integration 把特斯拉变成了智能家居生态的一部分：从查看电量到远程开锁，从哨兵模式到自动化场景，全部在 Home Assistant 内完成。装上它、配置好轮询策略，再用蓝图把你的自动化分享出去——你的特斯拉从此"听话"又省电。
更多细节可参考项目文档：README.md、info.md 与更新日志 CHANGELOG.md。
【免费下载链接】teslaTesla custom integration for Home Assistant. This requires a refresh token be generated by third-party apps to login.项目地址: https://gitcode.com/GitHub_Trending/tesla/tesla
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
