核心用法
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_ID与TESLA_CLIENT_SECRET以环境变量或明文.env文件存放,存在被进程窥探或意外提交至版本控制的风险。 - 车辆远程控制滥用:34 条命令涵盖门锁、空调、充电等关键功能,Agent 或工作流配置错误可能导致非预期操作。
- Telemetry 隐私:实时位置、驾驶行为等敏感数据流经 Gateway,需确保传输层加密(WSS)与存储合规。
- 依赖供应链:GitHub CLI、Tailscale、Tesla Fleet API 任一服务端变更均可能影响可用性。