tescmd

🚗 特斯拉车辆 AI 控制与遥测网关

OpenClaw Tesla 网关插件,通过 tescmd 节点连接特斯拉 Fleet API,提供 39 项车辆控制工具、实时遥测流与充电站发现功能。

收藏
11.5k
安装
2.9k
版本
0.3.5
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

OpenClaw Tesla (tescmd) 是一个 OpenClaw 网关插件,用于将特斯拉车辆接入 AI Agent 控制体系。其架构采用三层设计:Agent 通过 OpenClaw Gateway 调用插件工具,插件通过 WebSocket 将指令路由至 tescmd 节点(Python CLI),节点再与特斯拉 Fleet API、车辆指令协议(VCSEC)及遥测流建立连接。

部署流程分为 7 个步骤:检查前置依赖(git、GitHub CLI、Python 3.11+、Tailscale)→ 安装 OpenClaw 插件 → 安装 tescmd CLI → 运行交互式设置向导(创建 Tesla 开发者应用、生成 EC 密钥对、OAuth2 登录、车辆配对)→ 识别车辆 VIN → 启动节点并完成与网关的一次性配对 → 验证连接状态。

插件安装后自动注册 39 个可调用的 Agent 工具、14 个斜杠命令,支持实时遥测流、超级充电站发现(10,000+ 站点),并可在节点离线时提供 CLI 回退。

显著优点

1. 完整功能覆盖:39 项工具涵盖车辆状态查询、远程控制、充电管理、空调控制、媒体控制等全场景
2. 实时遥测:通过 WebSocket 流式传输驾驶、充电数据,支持字段预设(driving/charging/all)

3. 多重部署模式:支持 Full(默认)、Bridge-only、Tailscale Funnel 暴露、Dry-run 等运行模式

4. 安全架构:采用 Tesla 官方 Fleet API,VCSEC 签名指令协议,OAuth2 认证,密钥本地存储

5. 零基础设施选项:推荐 Tailscale 提供 HTTPS 端点,无需自建公网服务

6. 生态集成:与 OpenClaw Gateway 深度集成,节点配对后自动管理令牌,无需手动处理

潜在局限

1. 部署复杂度高:需同时满足 Python 3.11+、GitHub CLI、Tailscale 等多重前置条件,设置向导涉及浏览器交互和物理车辆在场,Agent 无法独立完成
2. 令牌生命周期:Tesla OAuth 令牌存在过期风险,需定期重新认证(tescmd auth login

3. 网络依赖严苛:遥测流和实时控制依赖稳定的 WebSocket 连接,节点断线时功能降级为 CLI 回退

4. 地域限制:Tesla Fleet API 按区域(na/eu/cn)划分,需正确配置 TESLA_REGION

5. 单节点设计:当前架构为单车单节点,多车管理需部署多个实例

6. 物理配对要求:车辆密钥配对需车主携带已授权钥匙现场操作

适合人群

  • 技术型特斯拉车主:具备 CLI 操作能力,熟悉 OAuth 流程和密钥管理
  • 智能家居集成者:希望将特斯拉接入 OpenClaw 生态,实现语音控制、自动化工作流
  • 开发者与极客:需要实时车辆遥测数据进行二次开发或数据分析
  • 企业车队管理:具备技术运维能力,需批量管理车辆的小型车队

常规风险

| 风险类别 | 描述 | 缓解措施 |
|---------|------|---------|
| 授权令牌泄露 | `~/.config/tescmd/` 中的令牌和密钥文件若权限不当,可能被本地进程读取 | 确保配置目录权限 700,定期检查 `tescmd auth status` |
| 中间人攻击 | WebSocket 连接若使用非 TLS 传输,存在截获风险 | 始终使用 `wss://` 或 Tailscale 加密隧道 |
| 误操作指令 | Agent 可能误发车辆控制指令(如远程启动、解锁) | 生产环境建议启用 `--dry-run` 模式验证,或限制工具调用权限 |
| 车辆钥匙失效 | 密钥配对失败或 Tesla 账户变更导致授权失效 | 保留物理钥匙备份,定期验证 `tescmd vehicle info` 连通性 |
| API 速率限制 | Tesla Fleet API 存在调用配额,高频遥测可能触发限流 | 调整 `--interval` 轮询间隔,避免 `--fields all` 常驻运行 |
| 节点单点故障 | tescmd 节点进程崩溃导致网关工具不可用 | 配置进程守护(systemd/supervisor),监控 `openclaw nodes status` |

该技能适合具备一定技术基础的用户,在正确配置后可提供生产级的车辆智能化管理能力。

tescmd 内容

手动下载zip · 4.3 kB
SKILL.mdtext/markdown
请选择文件