通过 Tessie 控制 Tesla 车辆

使用 Tessie API，通过 Python 脚本控制 Tesla 车辆。

前置条件

安装 Python 3 并配置 requests 库：

pip install requests

设置环境变量 TESSIE_API_KEY，其值为从 https://my.tessie.com/settings/api 获取的 Tessie API 密钥。

# Linux/macOS
export TESSIE_API_KEY="your-api-key-here"

# Windows（PowerShell）
$env:TESSIE_API_KEY = "your-api-key-here"

# Windows（cmd）
set TESSIE_API_KEY=your-api-key-hhere

如需持久化存储，请将上述命令添加至您的 Shell 配置文件（如 .bashrc、.zshrc、PowerShell 配置文件等）。

常用命令

所有命令均通过 scripts/tessie.py 脚本执行。大多数命令需要指定 VIN（车辆识别号码）。

获取车辆列表

python scripts/tessie.py vehicles

返回与您的 Tessie 账户关联的所有车辆及其 VIN。

检查车辆状态

python scripts/tessie.py status --vin 

返回完整的车辆状态信息，包括电池、位置、空调、充电状态等。

电池信息

python scripts/tessie.py battery --vin 

返回当前电量、续航里程及充电相关信息。

车辆位置

python scripts/tessie.py location --vin 

返回车辆当前位置（纬度、经度、航向）。

锁车与解锁

python scripts/tessie.py lock --vin 
python scripts/tessie.py unlock --vin 

空调控制

# 启动空调
python scripts/tessie.py start_climate --vin 

# 关闭空调
python scripts/tessie.py stop_climate --vin 

# 设置温度（摄氏度）
python scripts/tessie.py set_temperature --vin  --value 22

充电控制

# 开始充电
python scripts/tessie.py start_charging --vin 

# 停止充电
python scripts/tessie.py stop_charging --vin 

# 设置充电上限（0–100）
python scripts/tessie.py set_charge_limit --vin  --value 80

# 打开/关闭充电口
python scripts/tessie.py open_charge_port --vin 
python scripts/tessie.py close_charge_port --vin 

鸣笛、闪灯与放屁（Fart）

python scripts/tessie.py honk --vin 
python scripts/tessie.py flash --vin 
python scripts/tessie.py fart --vin 

注意：Fart 功能需车辆固件版本为 2022.40.25 或更高版本。

前备箱与后备箱

python scripts/tessie.py open_frunk --vin 
python scripts/tessie.py open_trunk --vin 

软件更新

# 立即调度更新
python scripts/tessie.py schedule_update --vin 

# 在 2 小时后（7200 秒）调度更新
python scripts/tessie.py schedule_update --vin  --value 7200

# 取消已调度的更新
python scripts/tessie.py cancel_update --vin 

# 检查可用更新
python scripts/check-updates.py --vin 

check-updates.py 脚本返回以下结果之一：

• UPDATE_AVAILABLE: Software update X.X.X is ready to install!
• UPDATE_DOWNLOADING: Downloading update X.X.X (XX%)
• UPDATE_INSTALLING: Installing update X.X.X (XX%)
• UPDATE_SCHEDULED: Update X.X.X is scheduled
• NO_UPDATE

唤醒车辆

若车辆处于休眠状态，请先执行唤醒操作：

python scripts/tessie.py wake --vin 

自动更新通知

如需在有可用软件更新时收到通知，请配置定时任务（cron job）：

# 每 6 小时检查一次更新，并在发现可用更新时发送通知
cron add 
  --schedule "0 */6 * * *" 
  --text "Check my Tesla for software updates and notify me if one is available" 
  --description "Tesla software update check"

当检测到可用更新时，您将收到包含版本号的通知。

工作流程

1. 首次使用：通过 vehicles 命令获取 VIN
2. 大部分命令：使用 VIN 指定目标车辆
3. 若车辆处于休眠状态：请先执行 wake，再重试原命令
4. 按需使用 status、battery 或 location 检查车辆状态

参考文档

完整 API 文档详见 references/api.md。