06HomeAssistant 中如何添加特斯拉汽车，Tesla汽车如何添加

admin · 发表于 2025-12-15 09:29:43

在 Home Assistant (HA) 中集成 Tesla 是一项非常热门的功能，但由于 Tesla 官方 API 经常变动（特别是 2024 年引入了 Fleet API 和更严格的认证机制），官方自带的 Tesla 集成往往无法正常工作。

目前最稳定、功能最全的方案是使用 HACS (Home Assistant Community Store) 安装第三方的 Tesla Custom Integration。

以下是截至 2024/2025 年最新的详细教程。

准备工作

Home Assistant 已安装并运行正常。
HACS (集成商店) 已安装。
- 如果你还没装 HACS，请先去搜一下“Home Assistant 安装 HACS”教程，这是玩 HA 的必备工具。
Tesla 账户（邮箱和密码）。
获取 Token 的工具（下文会讲，不能直接用密码登录）。

第一步：安装 Tesla Custom Integration (通过 HACS)

不要使用 HA 自带的“Tesla”集成，那个大概率是用不了的。我们要用大神 alandtse 维护的版本。

第二步：获取 Refresh Token (刷新令牌)

由于 Tesla 开启了复杂的验证（MFA/验证码），直接在 HA 里输入账号密码通常会失败。我们需要先在外部生成一个 Refresh Token。

推荐使用以下第三方 App 来安全获取 Token（这些 App 专门用于生成 Tesla API 令牌）：

操作步骤：

第三步：在 Home Assistant 中配置集成

确保 HA 已经重启完毕。
点击左侧菜单 配置 (Settings) -> 设备与服务 (Devices & Services)。
点击右下角 添加集成 (Add Integration)。
搜索 Tesla Custom Integration (注意：可能会显示为 "Tesla"，图标通常是红色的 T。一定要确认是你刚才通过 HACS 装的那个，如果列表中有两个 Tesla，通常选那个带“Custom”标记的或者排在前面的，如果只有一个，直接点)。
在弹出的配置窗口中：
- Email: 输入你的 Tesla 账户邮箱。
- Refresh Token: 粘贴第二步获取的那一长串字符。
- Access Token (可选): 通常不需要填，留空即可。
- URL Proxy (可选): 如果你没有自建 Fleet API 代理，留空。
点击 提交 (Submit)。

如果一切顺利，HA 会连接 Tesla 服务器，并提示你选择要把车辆放在哪个“区域”。完成后，你会看到一个新的设备（你的车名）。

第四步：功能验证与实体介绍

配置成功后，去“设备与服务”里找到 Tesla，点进去“设备”，你会看到几十个实体。

常用实体包括：

Binary Sensor (二元传感器):
- binary_sensor.tesla_online: 车是否在线（唤醒状态）。
- binary_sensor.tesla_charging: 是否正在充电。
- binary_sensor.tesla_parking_brake: 驻车制动状态。
Sensor (传感器):
- sensor.tesla_battery_level: 电池百分比。
- sensor.tesla_range: 剩余续航里程。
- sensor.tesla_charging_rate: 充电速率。
- sensor.tesla_location: 车辆位置（用于地图追踪）。
- sensor.tesla_inside_temperature: 车内温度。
Switch (开关 - 可控制):
- switch.tesla_charger: 开启/停止充电。
- switch.tesla_sentry_mode: 哨兵模式开关。
- switch.tesla_heated_steering_wheel: 方向盘加热。
Lock (锁):
- lock.tesla_door_lock: 门锁控制。
Climate (空调):
- climate.tesla_hvac_climate_system: 开启/关闭空调，设定温度。

第五步：关键设置 - 防止车辆“失眠” (耗电问题)

这是最重要的一步！如果配置不当，HA 会一直询问车辆状态，导致车辆无法休眠，造成严重的吸血鬼掉电 (Vampire Drain)。

在 Tesla 集成页面，点击你的设备，找到 配置 (Configure) 按钮（或者在集成列表页点击“选项”）。
Enable Polling (启用轮询):
- 默认情况下，这个集成会尝试智能轮询。
- 建议勾选 Active polling (主动轮询) 选项中的设置，但要谨慎。
强烈建议的设置：
- Polling Policy (轮询策略): 确保车辆在休眠时，HA 不要强制唤醒它。
- 通常集成会自动处理：当 binary_sensor.tesla_online 变为 Off 时，HA 会停止发送指令，直到你手动触发某个开关（如开空调）或车辆自己醒来（如你打开车门）。
- 你可以在集成选项中设置 Wake Up 策略。如果你不需要 HA 随时都能控制车，建议关闭“自动唤醒”。

最佳实践：

不要设置每分钟都检查电量的自动化。
利用 HA 的 button.tesla_wake_up 实体。如果你需要操作车辆（例如自动化：早上8点开空调），在调用“开启空调”服务前，先调用“唤醒车辆”服务，等待几秒后再发指令。

进阶：如何创建自动化 (示例)

场景：利用太阳能板发电过剩时自动充电，或低谷电价充电。

触发条件: 时间是晚上 10:00 (低谷电开始)。
环境条件: 车辆在家 (device_tracker.tesla_location 在 Home 区域) 且插着枪 (binary_sensor.tesla_charger_sensor 为 Connected)。
动作:
- 调用服务: switch.turn_on -> 目标: switch.tesla_charger。

场景：夏天出门前自动降温。

触发条件: 手机闹钟停止 (如果是安卓) 或时间到达 8:00 AM。
动作:
- 调用服务: climate.set_temperature -> 目标: Tesla 空调 -> 温度: 22度。
- 调用服务: climate.set_hvac_mode -> 模式: Heat/Cool。

常见问题与故障排除

401 / 403 错误 (Authentication Failed):
- Refresh Token 过期了。需要重新用 App 生成一个新的 Token，然后在 HA 集成页面点击“重新配置”填入新 Token。
车辆一直不休眠:
- 检查是否有其他第三方 App (如 TeslaFi, Tessie) 也在频繁访问。
- 在 HA 集成选项中，关闭 "Wake up on start" (启动时唤醒)。
控制延迟:
- 这是正常的。车辆如果处于休眠状态，发送指令需要先唤醒车辆（大约需要 15-30 秒），然后才能执行操作。
API 限制 (Fleet API):
- Tesla 现在对 API 调用次数有限制。如果你发现完全无法控制，可能是当天的调用次数超限了，暂停使用一天通常会自动恢复。

希望这个教程能帮你成功将 Tesla 接入 Home Assistant！

发帖者介绍-莱特智能成立于2010年，专注智能家居整体解决方案，Now ALL IN HA，欢迎淘宝搜索！

		自动登录	找回密码
密码			立即注册