Tesla-CLI：命令行控制特斯拉，实现自动化车辆管理
1. 项目概述：一个为特斯拉车主打造的终端利器
如果你是一位特斯拉车主，同时又恰好是那种喜欢在命令行（CLI）里敲敲打打、追求极致效率的开发者或极客，那么你很可能已经厌倦了在手机App和网页之间来回切换，只为查看一下车辆状态或执行一个简单的操作。lu-zhengda/tesla-cli这个项目，就是为这个痛点而生的。它是一个纯粹的命令行工具，让你能够通过终端直接与你的特斯拉车辆进行交互。
简单来说，它把特斯拉官方API的能力封装成了一组简洁、可脚本化的命令。想象一下，你正在写代码，突然想预热一下停在楼下的车，你不需要解锁手机、找到App、等待加载，只需要在终端里敲入一行命令，比如tesla climate on，一切就搞定了。或者，你可以写一个简单的脚本，在每天早晨8点自动打开空调、在电池低于20%时给你发个提醒、甚至是将车辆数据集成到你自己的智能家居系统中。这就是tesla-cli带来的可能性：将车辆控制无缝融入你的数字工作流。
这个工具的核心价值在于其“无头”（headless）和“可编程”特性。它不提供图形界面，所有交互都通过命令和参数完成，这使得它极其轻量、快速，并且易于与其他工具（如cron定时任务、Shell脚本、Python脚本等）集成。对于开发者而言，它更像是一个功能强大的SDK，只不过是以CLI的形式呈现。接下来，我将带你深入拆解这个项目，从安装配置到核心命令，再到高级玩法和避坑指南，让你彻底掌握这个提升用车效率的神器。
2. 核心原理与架构拆解
要理解tesla-cli如何工作，我们首先得扒开它的“外壳”，看看里面是怎么和千里之外的车辆通信的。整个过程可以概括为：工具 -> 特斯拉官方API -> 车辆。tesla-cli本身并不直接与车辆通讯，它只是一个优雅的“翻译官”和“信使”。
2.1 特斯拉API：一切能力的源头
特斯拉为其车辆提供了一套相对完善的RESTful API。这套API允许经过授权的第三方应用查询车辆状态（如电量、里程、车门锁状态）和执行远程命令（如解锁、开启空调、召唤）。tesla-cli的所有功能都建立在这套API之上。这意味着，只要官方API支持的功能，理论上都可以通过tesla-cli来实现。目前API覆盖了车辆信息、充电状态、气候控制、车辆命令（闪灯、鸣笛、开关锁）、远程启动、数据查询等多个维度。
注意：使用特斯拉API需要车主明确授权。这通常通过OAuth 2.0流程完成，你需要使用你的特斯拉账户登录，并同意某个“应用”（在这里就是
tesla-cli）访问你的车辆数据和控制权限。这是一个关键的安全环节，确保了只有你授权的工具才能操作你的车。
2.2.tesla-cli的架构角色
那么，tesla-cli具体做了什么呢？它主要承担了三个角色：
- 认证管理器：它封装了繁琐的OAuth 2.0认证流程。你第一次运行工具时，它会引导你打开浏览器，登录特斯拉账户并授权。成功后，它会安全地在本机存储获取到的访问令牌（Access Token）和刷新令牌（Refresh Token）。之后的所有请求都会自动携带有效的令牌，无需重复登录。
- API客户端与命令映射器：它将复杂的HTTP API请求封装成一个个简单直观的CLI命令。例如，当你输入
tesla battery时，工具内部会构造一个向https://owner-api.teslamotors.com/api/1/vehicles/{id}/data_request/charge_state发起的GET请求，并帮你解析返回的JSON数据，以人类可读的格式展示出来。 - 数据处理与格式化器：API返回的是原始的JSON数据。
tesla-cli会提取关键信息，并以整洁的表格或易读的文本形式输出到终端，省去了你手动解析JSON的麻烦。
这种架构的优势非常明显：轻量、专注、可组合。工具本身只关心如何高效、正确地调用API和展示结果，而将车辆通信的复杂性交给了特斯拉官方的基础设施。这也意味着它的稳定性与官方API的稳定性直接挂钩。
3. 从零开始：环境准备与安装配置
好了，原理清楚了，手开始痒了。我们来看看如何把这个工具装到你的电脑上，并完成最关键的第一步——认证。
3.1 安装方式选择
tesla-cli通常通过pip（Python的包管理器）安装，因为它本身是一个Python包。这要求你的系统已经安装了Python（建议3.7及以上版本）和pip。
打开你的终端（Linux/macOS的Terminal，Windows的PowerShell或CMD），执行以下命令：
pip install tesla-cli如果安装速度慢，可以考虑使用国内的镜像源，例如清华源：
pip install tesla-cli -i https://pypi.tuna.tsinghua.edu.cn/simple安装完成后，在终端输入tesla --help，如果看到一长串帮助信息，恭喜你，安装成功了。
实操心得：我强烈建议在安装时使用虚拟环境（如
venv或conda）。这可以避免Python包之间的版本冲突。具体操作是：先python -m venv tesla-env创建环境，然后激活它（source tesla-env/bin/activate或.\tesla-env\Scripts\activate），再执行上述pip install命令。这样你的tesla-cli就是在一个独立、干净的环境中运行。
3.2 初始认证：获取通行证
安装只是第一步，让工具获得访问你车辆的权限才是重头戏。运行以下命令开始认证流程：
tesla login这时，命令行会打印出一个网址，并提示你打开浏览器访问它。你照做之后，会看到特斯拉官方的登录和授权页面。
关键步骤与注意事项：
- 使用车主账户登录：务必使用绑定了你特斯拉车辆的主账户邮箱和密码登录。子账户或非车主账户可能无法完成授权。
- 仔细阅读授权范围：页面上会列出
tesla-cli请求的权限，通常包括“查看车辆数据”和“远程控制”。确认无误后，点击“允许”。 - 处理回调：授权成功后，页面通常会显示“授权成功，请返回命令行”之类的提示。此时，你不需要复制任何代码。
tesla-cli的本地服务会自动捕获回调信息。 - 回到终端确认：回到你的终端窗口，如果看到 “Login successful!” 或类似的成功信息，并且显示了你的车辆名称（如 “My Tesla”），那么认证就完成了。
工具会将令牌信息加密后存储在你的用户目录下的一个配置文件里（例如~/.teslaclirc）。
踩坑记录：这里最常见的坑有两个。一是网络问题，因为认证过程需要与特斯拉的服务器通信，有时会因网络波动失败，多试几次或换个网络环境即可。二是浏览器拦截了本地回调，确保你没有禁用本地回环地址（localhost）的访问。如果页面长时间空白或报错，可以尝试在命令中指定使用
--no-callback模式，然后手动将浏览器跳转后地址栏中的完整URL复制到终端里，这种方式更麻烦但有时是备选方案。
4. 核心命令详解与实战应用
认证通过，你的终端就变成了一把车钥匙。我们来详细看看这把“钥匙”都有哪些按钮。
4.1 车辆信息与状态查询
这是最常用的一组命令，用于获取车辆的静态和动态数据。
列出车辆：
tesla list这个命令会列出你账户下所有已授权的特斯拉车辆，并显示它们的ID、显示名称、车辆识别码（VIN）后几位和状态（在线/休眠）。在多车家庭中，你需要先用这个命令确认你要操作的是哪一辆车。- 输出示例：
ID Display Name VIN State -- ------------- --- ----- 1234567890 My Model 3 5YJ3... online 9876543210 Family Model Y 7SAY... asleep
- 输出示例：
获取车辆摘要：
tesla summary或tesla直接运行tesla命令（不带任何子命令）会默认获取并显示当前默认车辆的状态摘要，包括电量、里程、车内温度、是否锁车等核心信息，一目了然。查询电池状态：
tesla battery这是电车车主最关心的信息。该命令会返回详细的电池数据：$ tesla battery 充电状态: 已连接，正在充电 电量: 65% 剩余续航: 340 km 充电功率: 32 kW 充电电流: 48 A 充电电压: 664 V 充电限值: 80% (已设置) 预计充满时间: 上午 10:30你可以清晰地看到当前电量、充电功率、以及根据当前功率计算的充满时间，对于规划行程非常有用。
查询气候状态：
tesla climate显示空调系统状态，包括车内温度、设定温度、座椅加热/方向盘加热状态等。- 实操技巧：结合
watch命令（Linux/macOS），你可以实时监控车内温度变化，比如watch -n 10 tesla climate会每10秒刷新一次气候状态，在远程预热或降温时特别好用。
- 实操技巧：结合
查询驾驶与位置信息：
tesla drive和tesla locationdrive会显示车速、功率、里程表等信息（车辆行驶中且在线时）。location则会返回车辆所在的经纬度，有时还会解析出大致地址。请注意隐私安全，这些数据非常敏感。
4.2 远程控制命令
这才是体现CLI自动化威力的地方。所有命令通常都支持-i <车辆ID>参数来指定操作哪辆车，如果不指定，则操作默认车辆。
唤醒车辆：
tesla wake特斯拉车辆在不被使用时会进入低功耗的“休眠”状态以节省电量。在执行任何其他命令（如获取状态）前，如果车辆在休眠，你需要先唤醒它。这个命令就是向车辆发送一个唤醒信号。通常需要等待10-30秒。控制空调：
tesla climate on/tesla climate off： 开启或关闭空调。tesla climate set 22： 将空调目标温度设置为22摄氏度。tesla seat_heater 1 2： 将驾驶位（座位1）的加热等级设置为2（共3级）。tesla steering_heater on： 开启方向盘加热。
重要提示：开启空调会消耗电池电量。在远程开启前，最好先用
tesla battery确认一下剩余电量是否充足，尤其是在寒冷天气下。控制车门与充电口：
tesla lock/tesla unlock： 远程锁车或解锁。tesla charge_port open/tesla charge_port close： 打开或关闭充电口盖。tesla charge start/tesla charge stop： 开始或停止充电（需要充电枪已连接）。tesla charge_limit set 90： 将充电限值设置为90%。
闪灯与鸣笛：
tesla flash和tesla honk这两个命令在大型停车场找车时是神器。尤其是晚上，flash会让车灯闪烁，比鸣笛更文明一些。
4.3 数据与设置管理
设置默认车辆：
tesla default <车辆ID>如果你有多辆车，可以用这个命令设置其中一辆为默认，这样以后大部分命令就不需要每次都指定-i参数了。查看命令历史：
tesla history这个命令可能不是所有版本都有，但如果支持，它可以列出你通过CLI执行过的历史操作，方便回溯。刷新令牌：
tesla refresh访问令牌有过期时间。正常情况下，tesla-cli会自动使用刷新令牌获取新的访问令牌。如果遇到认证错误，可以手动运行此命令尝试刷新。
5. 高级玩法：脚本化与自动化集成
CLI工具的终极魅力在于可脚本化。下面分享几个我实际在用的场景，你可以把它们复制到你的Shell脚本或cron作业中。
5.1 场景一：工作日早晨自动预热车辆
假设你工作日早上8点出门，希望7点50分时车内已经达到舒适的温度。你可以创建一个脚本preheat.sh：
#!/bin/bash # 唤醒车辆（如果休眠） tesla wake sleep 20 # 等待车辆唤醒，时间可根据网络情况调整 # 开启空调，设定温度22度 tesla climate on tesla climate set 22 # 开启方向盘加热（冬天用） tesla steering_heater on # 开启驾驶位座椅加热（等级2） tesla seat_heater 1 2 echo "$(date): 车辆预热指令已发送。"然后，使用crontab -e添加一个定时任务：
50 7 * * 1-5 /path/to/your/preheat.sh >> /path/to/your/tesla_log.txt 2>&1这样，每周一到周五早上7点50分，你的车就会自动开始预热。
5.2 场景二：低电量预警
你可以写一个脚本定期检查电量，并在低于阈值时发送通知到你的手机（这里以发送邮件为例，你也可以集成钉钉、企业微信、Telegram Bot等）。
#!/bin/bash # 获取电池信息，并用grep提取百分比数字 BATTERY_LEVEL=$(tesla battery | grep -oP '电量: \K\d+') # 设置阈值 WARNING_LEVEL=20 if [ "$BATTERY_LEVEL" -lt "$WARNING_LEVEL" ]; then # 发送邮件警报 echo "警报：您的特斯拉电量仅剩 ${BATTERY_LEVEL}%，请及时充电！" | mail -s "特斯拉低电量警报" your-email@example.com # 或者调用一个发送HTTP请求到通知服务的脚本 # curl -X POST https://your-notification-service/alert -d "message=电量低:${BATTERY_LEVEL}%" fi5.3 场景三：与智能家居联动（示例：Home Assistant）
如果你使用Home Assistant，可以通过Shell Command集成来调用tesla-cli。首先在configuration.yaml中添加：
shell_command: tesla_wake: “/path/to/your/tesla-env/bin/tesla wake” tesla_climate_on: “/path/to/your/tesla-env/bin/tesla climate on” tesla_climate_set: “/path/to/your/tesla-env/bin/tesla climate set ”然后，你就可以在HA的自动化或面板中创建按钮，来执行这些命令了。比如，创建一个“快速预热”脚本，一键执行唤醒、开空调、设温度、开加热等一系列操作。
6. 常见问题、故障排查与安全须知
即使工具设计得再完善，在实际使用中还是会遇到各种问题。这里我整理了一份“排坑手册”。
6.1 认证与连接类问题
| 问题现象 | 可能原因 | 排查与解决步骤 |
|---|---|---|
tesla login失败，浏览器页面报错或空白 | 1. 网络连接问题 2. 特斯拉服务器临时故障 3. 本地端口被占用 | 1. 检查网络，尝试使用手机热点。 2. 等待一段时间再试。 3. 使用 tesla login --no-callback手动复制URL认证。 |
执行任何命令都报401 Unauthorized或Token expired | 访问令牌已过期且刷新失败 | 1. 运行tesla refresh尝试刷新令牌。2. 如果无效，删除本地令牌文件（通常是 ~/.teslaclirc），然后重新运行tesla login。 |
命令执行后长时间无响应，或报Vehicle is offline | 车辆处于深度休眠状态 | 1. 先执行tesla wake唤醒车辆，等待30-60秒。2. 使用手机App唤醒车辆，确认车辆网络正常。 3. 检查车辆所在位置是否有蜂窝网络信号。 |
tesla list不显示车辆或显示错误 | 账户未绑定车辆，或API权限不足 | 1. 确认登录的账户是车主账户。 2. 在特斯拉手机App中确认车辆已正确绑定。 3. 重新登录授权 ( tesla login)。 |
6.2 命令执行类问题
命令执行成功但车辆没反应？首先，确认命令输出是否显示“成功”或没有报错。然后，务必通过手机App或直接查看车辆来确认状态。由于网络延迟，状态同步可能需要几秒到十几秒。如果App显示操作成功但车辆无动作，可能是车辆本身的问题（如充电口机械故障）。
charge start失败？确保充电枪已物理连接好。这个命令只是向车辆发送“开始充电”的指令，如果充电桩未供电或车辆未检测到枪，命令会失败。如何操作非默认车辆？在所有命令后加上
-i <车辆ID>参数。车辆ID可以通过tesla list命令获取。
6.3 安全与隐私警告
这是重中之重，请务必仔细阅读：
- 令牌即钥匙：存储在
~/.teslaclirc里的令牌，其效力等同于你的特斯拉账户密码。切勿将此文件分享给任何人，也不要上传到GitHub等公开仓库。如果怀疑泄露，立即在特斯拉账户设置中撤销相关设备的访问权限，并删除本地文件重新登录。 - 慎用脚本与自动化：将包含令牌访问能力的脚本放在安全的、受控的环境中。避免在共享服务器或不可信的设备上使用。自动化任务（如定时充电）请设置合理的条件判断，避免意外。
- 隐私数据：
location等命令会暴露车辆精确位置。请确保你运行命令的环境是安全的，输出的日志文件也要妥善处理。 - 操作后果自负：远程命令是直接对车辆生效的。误操作（如在行驶中远程解锁）可能导致危险。请在安全的环境下测试命令，并充分理解每个命令的作用。
lu-zhengda/tesla-cli这个项目，从一个极客的小想法，成长为一个非常实用的效率工具。它完美地诠释了“Unix哲学”：做好一件事，并通过清晰的接口与其他工具协作。它可能不适合所有车主，但对于那些生活在终端里的开发者、热衷于家庭自动化的玩家、或者只是单纯想用更酷的方式与自己的车交互的人来说，它无疑打开了一扇新的大门。我的使用体会是，初期需要花点时间熟悉命令和解决一些小问题，但一旦跑通，那种用一行命令掌控全局的流畅感，是图形界面难以替代的。最后一个小建议，多看看项目的GitHub Issues页面，很多你遇到的问题可能已经有现成的解决方案，社区的力量总是超乎想象。