tescmd

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

OpenClaw Gateway与特斯拉车辆的双向控制与遥测集成方案,通过tescmd节点实现39个智能体可调工具与实时数据流

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

使用说明

核心用法

openclaw-tescmd 是连接OpenClaw Gateway与特斯拉车辆的官方插件,作为tescmd Python CLI节点的网关端配套组件运行。该技能采用分层架构设计:Agent通过tool calls调用OpenClaw Gateway,网关通过WebSocket与tescmd插件通信,插件再将指令分派给tescmd节点,最终由节点通过Tesla Fleet API(REST)、Vehicle Command Protocol(VCSEC签名指令)和Fleet Telemetry Stream(WebSocket)与车辆交互。

完整设置流程包括七个步骤:验证前置依赖(git、GitHub CLI、Python 3.11+、Tailscale)→ 安装OpenClaw插件 → 安装tescmd CLI → 运行交互式设置向导(需用户完成Tesla开发者应用创建、EC密钥对生成、OAuth2登录、车辆物理配对)→ 识别车辆VIN → 启动节点并执行一次性网关配对 → 验证连接。节点运行后提供39个智能体可调工具、14个斜杠命令、实时遥测流、超充站发现(10,000+位置)及CLI回退功能。

运行模式灵活:支持完整模式(MCP服务器+遥测+OpenClaw桥接)、纯桥接模式、Tailscale Funnel暴露、以及干运行模式。配对后的节点会自动使用存储的令牌重新连接,无需手动干预。

显著优点

1. 官方级集成深度:直接对接Tesla Fleet API和VCSEC协议,支持签名指令,非逆向工程方案
2. 实时遥测能力:WebSocket流式传输驾驶、充电等车辆数据,延迟低

3. 基础设施极简:Tailscale集成提供零配置的HTTPS端点,无需自托管服务器

4. 安全架构合理:EC密钥对本地生成,OAuth2标准流程,网关令牌自动管理

5. 功能完备度高:39个工具覆盖车辆控制全场景,14个斜杠命令提供CLI效率

潜在缺点与局限性

1. 设置复杂度极高:需用户交互完成6+个独立步骤,涉及多终端操作、浏览器认证、物理车辆 presence
2. 依赖链条冗长:Python 3.11、GitHub CLI、Tailscale、OpenClaw Gateway、tescmd节点五层依赖缺一不可

3. 配对时效限制:初次配对请求5分钟过期,失败需重启流程

4. 地理区域锁定:Tesla Fleet API分na/eu/cn区域,配置错误导致连接失败

5. 非开箱即用:对比直接API调用,架构抽象增加了故障排查维度

适合人群

  • 技术型特斯拉车主:具备CLI操作能力,愿意投入30-60分钟完成复杂设置
  • OpenClaw生态用户:已在运行OpenClaw Gateway,需要扩展车辆控制能力
  • 自动化需求场景:需要程序化控制车辆(如定时充电、预 conditioning、行程规划)
  • 开发者与集成商:构建围绕特斯拉车辆的数据采集或控制应用

不适合:追求即插即用的普通用户、无Linux/macOS命令行经验者、仅需偶尔查看车辆状态的轻量需求。

常规风险

1. 车辆控制风险:39个工具包含门锁、空调、充电控制等物理操作,误调用可能导致车辆状态变更或能源浪费
2. 凭证泄露风险:Tesla OAuth令牌、EC私钥、网关令牌存储于本地~/.config/tescmd/,权限配置不当可导致未授权访问

3. 遥测隐私暴露:实时位置、行驶数据通过Tailscale或自托管端点传输,配置错误可能公开暴露

4. API配额与封禁:Tesla Fleet API有未公开速率限制,高频调用可能导致账户受限

5. 节点中断风险:tescmd节点崩溃或网络闪断期间,智能体工具调用将失败,需设计降级策略

tescmd 内容

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