OpenClaw Tesla (tescmd) — 安装指南

该插件通过tescmd节点将特斯拉车辆连接到 OpenClaw 网关。一旦安装并配对，该插件会自动注册所有工具、命令、斜杠命令和遥测事件类型。

本文档仅涵盖安装和设置。运行时工具使用、工作流和错误处理由tescmd技能提供（调用tescmd_help获取完整参考）。

你将获得：

• 39 个可供智能体调用的工具
• 14 个斜杠命令
• 实时遥测数据流
• 超级充电站查找（通过 supercharge.info 提供 10,000+ 个地点）
• 节点断开连接时的 CLI 备用方案

代码仓库：

• 插件：https://github.com/oceanswave/openclaw-tescmd
• tescmd 节点 (Python CLI)：https://github.com/oceanswave/tescmd

架构

Agent (you)
  ↓  tool calls
OpenClaw Gateway
  ↓  node.invoke.request
openclaw-tescmd Plugin
  ↓  WebSocket dispatch
tescmd Node (Python)
  ├─ Tesla Fleet API (REST)
  ├─ Vehicle Command Protocol (VCSEC — signed commands)
  └─ Fleet Telemetry Stream (WebSocket)
  ↓
Tesla Vehicle

该插件是网关端的对应部分，与 tescmd 节点配对。它定义了工具模式并路由调用。tescmd 节点处理所有与特斯拉的直接通信。

设置

步骤 1：检查先决条件

开始之前，请验证所需的工具是否已安装并完成身份验证。

必需：git

git --version

如果缺失，请安装：

• macOS：xcode-select --install
• Linux：sudo apt install git或sudo dnf install git

必需：GitHub CLI (gh)

gh --version
gh auth status

如果gh未安装：

• macOS：brew install gh
• Linux：请参阅https://github.com/cli/cli/blob/trunk/docs/install_linux.md

如果未登录：

gh auth login

告知用户：“请在您的终端中完成 GitHub CLI 登录。根据提示选择您的偏好设置，并完成基于浏览器的身份验证流程。”

等待用户确认已完成登录后再继续。

必需：Python 3.11+

python3 --version

必须是 3.11 或更高版本。如果不是：

• macOS：brew install python@3.12
• Linux：sudo apt install python3.12或使用 pyenv

推荐：Tailscale

Tailscale 为零基础设施设置提供特斯拉车队遥测流传输的公共 HTTPS 端点。

tailscale version
tailscale status

如果未安装：

• macOS：brew install tailscale或从以下网址下载https://tailscale.com/download
• Linux：curl -fsSL https://tailscale.com/install.sh | sh

如果未登录：

sudo tailscale up

告知用户："如果提示，请在浏览器中完成Tailscale登录。"

等待用户确认后再继续。

步骤2：安装tescmd OpenClaw插件

标准安装：

openclaw plugins install @oceanswave/openclaw-tescmd

验证安装：

openclaw plugins list

您应能看到列出的插件版本为0.9.0（或更高）。

插件管理命令：

步骤三：安装tescmd命令行工具

pip install tescmd

验证：

tescmd --version

步骤四：运行tescmd设置向导

tescmd设置向导是交互式的需要用户在终端和浏览器中做出选择并完成步骤。您无法自主完成此步骤。

tescmd setup

告知用户："我已启动tescmd设置向导。这是一个交互式流程，将引导您完成以下步骤："

1. 创建特斯拉开发者应用程序
2. 生成您的EC密钥对
3. 托管您的公钥（通过GitHub Pages或Tailscale Funnel）
4. 在特斯拉车队API中注册
5. 在浏览器中完成OAuth2登录
6. 将密钥与您的车辆配对（需要本人在车辆旁操作）

"请按照终端提示操作，并在设置完成后告知我。"

等待用户确认设置完成后再继续。

验证设置

用户确认后，检查认证状态：

tescmd auth status

这应显示有效的令牌。如果显示过期或缺失，用户需要重新运行：

tescmd auth login

步骤5：识别车辆

列出账户中的车辆以获取VIN：

tescmd vehicle list

记下VIN——后续服务命令需要用到它。

步骤6：启动tescmd节点并与网关配对

tescmd节点将特斯拉车队API桥接至OpenClaw网关。首次连接需要一次性配对批准。

首次配对：

仅使用网关URL启动节点（无需令牌）：

tescmd serve <VIN> --openclaw <gateway_ws_url>

节点会向网关发送node.pair.request并等待批准。待处理的请求将在5分钟后过期，请及时批准。

在另一个终端中，批准配对：

openclaw nodes pending                # View waiting pair requests
openclaw nodes approve <requestId>    # Approve the node

批准后，网关会签发一个认证令牌。节点收到令牌后，将其保存至~/.config/tescmd/bridge.json，并建立认证连接。无需手动处理令牌。

请告知用户："请使用tescmd serve <VIN> --openclaw <gateway_url>命令启动tescmd节点，然后在另一个终端中运行openclaw nodes pending和openclaw nodes approve <requestId>以完成配对。"

请等待用户确认配对完成后再继续。

后续连接（已配对）：

配对完成后，节点将使用存储的令牌自动重新连接：

tescmd serve <VIN> --openclaw <gateway_ws_url>

如有需要，您也可以显式传递令牌：

tescmd serve <VIN> --openclaw <gateway_ws_url> --openclaw-token <gateway_token>

节点管理命令：

操作模式：

关键参数说明：

环境变量（作为命令行标志的替代方案）：

可以在~/.config/tescmd/.env文件中设置：

TESLA_CLIENT_ID=your-client-id
TESLA_CLIENT_SECRET=your-client-secret
TESLA_VIN=5YJ3E1EA1NF000000
TESLA_REGION=na                    # na, eu, or cn
OPENCLAW_GATEWAY_URL=ws://gateway.example.com:18789
OPENCLAW_GATEWAY_TOKEN=your-token
TESLA_COMMAND_PROTOCOL=auto        # auto, signed, or unsigned

步骤 7：验证连接

节点运行并配对后，确认其已连接到网关：

openclaw nodes status

或使用代理工具：

• 调用tescmd_node_status来检查连接状态

如果已连接，插件的工具即可使用。调用tescmd_help获取完整的运行时参考，包括工具用法、工作流程和错误处理。

故障排除设置

配置

最小化 — tescmd 节点处理所有车辆特定的配置。

{
  "plugins": {
    "entries": {
      "openclaw-tescmd": {
        "enabled": true,
        "config": {
          "debug": false
        }
      }
    }
  }
}

命令行界面快速参考

tescmd 命令行界面命令

tescmd serve <VIN> --openclaw <url>                              # Start node (uses stored token)
tescmd serve <VIN> --openclaw <url> --openclaw-token <token>     # Start node (explicit token)
tescmd setup                        # Interactive setup wizard
tescmd auth status                  # Check auth token status
tescmd auth login                   # Re-authenticate with Tesla
tescmd vehicle list                 # List vehicles on account
tescmd vehicle info                 # Full vehicle data snapshot
tescmd cache status                 # Check cache stats