tescmd

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

通过 tescmd 节点将特斯拉车辆接入 OpenClaw 网关,实现远程控制、遥测数据流与命令协议签名,支持 Fleet API 与 Telemetry 实时数据。

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

使用说明

核心用法

OpenClaw Tesla (tescmd) 是一套将特斯拉车辆深度集成至 OpenClaw 生态的桥接方案,由两部分构成:Gateway 端的 openclaw-tescmd 插件与 Python CLI 工具 tescmd 节点。用户需依次完成:环境依赖检查(Git、GitHub CLI、Python 3.11+、可选 Tailscale)、插件安装、CLI 安装、tescmd setup 交互式配置(创建 Tesla Developer 应用、生成 EC 密钥对、OAuth2 授权、车辆配对)、节点启动与 Gateway 配对,最终通过 WebSocket 建立双向通道。

运行时,tescmd serve <VIN> 启动节点,支持多种模式:完整模式(MCP server + Telemetry + OpenClaw)、纯桥接模式(--no-mcp)、Tailscale 暴露(--tailscale)及干跑模式(--dry-run)。节点自动处理 Tesla Fleet API REST 调用、Vehicle Command Protocol (VCSEC) 签名命令及 Fleet Telemetry WebSocket 流,插件端则注册 34 条白名单命令与 14 类遥测事件,供 Agent 通过 openclaw tescmd 系列命令或 tescmd_help 工具调用。

显著优点

  • 协议完整性:同时覆盖 REST 控制、签名命令(VCSEC)与实时 Telemetry 流,功能边界清晰。
  • 交互式引导tescmd setup 将复杂的特斯拉开发者注册、密钥托管(GitHub Pages/Tailscale Funnel)、OAuth 与车辆蓝牙配对流程封装为可逐步执行的向导,降低入门门槛。
  • 灵活的拓扑:支持本地 MCP、Tailscale 公网暴露、纯桥接等多种部署形态,适应不同网络环境。
  • 零手动令牌:首次配对后,Gateway 颁发的认证令牌自动持久化至 ~/.config/tescmd/bridge.json,后续启动无需人工干预。
  • 遥测可配置:通过 --fields--interval 参数可精确控制订阅数据类型与频率,避免过度采集。

潜在缺点与局限性

  • 物理访问依赖:车辆密钥配对阶段必须亲临车旁,无法纯远程完成。
  • 时效敏感:配对请求仅 5 分钟有效,需用户及时在另一终端执行批准命令。
  • 基础设施前置:若未使用 Tailscale,用户需自行解决公网 HTTPS 端点以满足 Tesla Fleet Telemetry 的 SSL 要求。
  • 版本锁定:Python 强制 3.11+,旧系统可能需额外升级步骤。
  • 调试信息有限:插件层级配置仅暴露 debug 开关,深层故障需下沉至 tescmd CLI 日志排查。

适合人群

  • 需要将特斯拉车辆纳入自动化工作流的开发者与高级用户。
  • 已部署 OpenClaw Gateway、寻求官方 Fleet API 替代方案的特斯拉车主。
  • 具备基础终端操作能力,能接受交互式命令行配置流程的技术爱好者。
  • 对车辆遥测数据有实时分析需求的数据工程师。

常规风险

  • 令牌泄露~/.config/tescmd/bridge.json 存储 Gateway 认证令牌,若设备共享或备份不当可能导致未授权访问。
  • OAuth 凭证管理TESLA_CLIENT_IDTESLA_CLIENT_SECRET 以环境变量或明文 .env 文件存放,存在被进程窥探或意外提交至版本控制的风险。
  • 车辆远程控制滥用:34 条命令涵盖门锁、空调、充电等关键功能,Agent 或工作流配置错误可能导致非预期操作。
  • Telemetry 隐私:实时位置、驾驶行为等敏感数据流经 Gateway,需确保传输层加密(WSS)与存储合规。
  • 依赖供应链:GitHub CLI、Tailscale、Tesla Fleet API 任一服务端变更均可能影响可用性。

tescmd 内容

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