名称： tesla
描述： 控制您的特斯拉车辆——锁定/解锁、空调、位置、充电状态等。支持多台车辆。
主页： https://tesla-api.timdorr.com
user-invocable: true
disable-model-invocation: true
元数据：
clawdbot:
emoji: "🚗"
primaryEnv: TESLA_EMAIL
requires:
bins: [python3]
env: [TESLA_EMAIL]

Tesla

通过 Clawdbot 控制您的特斯拉车辆。支持同一账户下的多台车辆。

设置

首次认证：

TESLA_EMAIL="you@email.com" python3 {baseDir}/scripts/tesla.py auth

此操作将：
1. 显示一个特斯拉登录 URL
2. 您在浏览器中登录并授权
3. 将回调 URL 粘贴回终端
4. 令牌将被缓存以供后续使用（约 30 天，自动刷新）

环境变量：

• TESLA_EMAIL — 您的特斯拉账户邮箱
• 令牌缓存于 ~/.tesla_cache.json

多车辆支持

使用 --car 或 -c 参数指定目标车辆：

# 列出所有车辆
python3 {baseDir}/scripts/tesla.py list

# 对特定车辆执行命令
python3 {baseDir}/scripts/tesla.py --car "Snowflake" status
python3 {baseDir}/scripts/tesla.py -c "Stella" lock

若不指定 --car，命令将默认作用于您的第一台车辆。

命令列表

# 列出所有车辆
python3 {baseDir}/scripts/tesla.py list

# 获取车辆状态
python3 {baseDir}/scripts/tesla.py status
python3 {baseDir}/scripts/tesla.py --car "Stella" status

# 锁定/解锁
python3 {baseDir}/scripts/tesla.py lock
python3 {baseDir}/scripts/tesla.py unlock

# 空调控制
python3 {baseDir}/scripts/tesla.py climate on
python3 {baseDir}/scripts/tesla.py climate off
python3 {baseDir}/scripts/tesla.py climate temp 72

# 充电控制
python3 {baseDir}/scripts/tesla.py charge status
python3 {baseDir}/scripts/tesla.py charge start
python3 {baseDir}/scripts/tesla.py charge stop

# 位置查询
python3 {baseDir}/scripts/tesla.py location

# 鸣笛与闪灯
python3 {baseDir}/scripts/tesla.py honk
python3 {baseDir}/scripts/tesla.py flash

# 唤醒车辆（若处于休眠状态）
python3 {baseDir}/scripts/tesla.py wake

聊天示例

• “我的特斯拉锁好了吗？”
• “锁定 Stella”
• “Snowflake 的电池电量是多少？”
• “我的 Model X 在哪里？”
• “打开 Stella 的空调”
• “让 Snowflake 鸣笛”

API 参考

基于非官方的特斯拉车主 API，文档地址：
https://tesla-api.timdorr.com

故障排除

认证失败？
- 尝试在手机浏览器中打开认证 URL，而非桌面端
- 确保您已登录正确的特斯拉账户
- 清除浏览器 Cookie 后重试

安全与权限

此技能控制实体车辆，请谨慎使用。

本技能的功能：
- 通过 teslapy 库使用特斯拉官方 OAuth 流程进行认证
- 向特斯拉官方 API 发送车辆控制命令（锁定、解锁、空调、充电等）
- 在本地 ~/.tesla_cache.json 中缓存 OAuth 刷新令牌
- 所有通信仅发生在您的设备与特斯拉服务器之间

本技能不会：
- 存储您的特斯拉密码——采用 OAuth 令牌流程
- 将凭据或车辆数据发送给任何第三方
- 访问除特斯拉 API 外的任何系统资源
- 无法由代理自主调用（disable-model-invocation: true）
- 每次命令均需由您显式触发代理执行

关键安全说明：
- 刷新令牌以受限权限缓存于 ~/.tesla_cache.json
- 令牌约 30 天自动刷新
- 仅在受信任的个人设备上使用
- 首次使用前请审阅 scripts/tesla.py——该脚本仅与特斯拉官方 API 通信