← Back to Skills Marketplace
BYD Remote Control
by
hiimivantang
· GitHub ↗
· v1.0.0
· MIT-0
99
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install byd-remote-control
Description
Control and check a BYD vehicle using portable Python helper scripts built on pyBYD. Use when the user wants to check battery state, lock the car, flash ligh...
README (SKILL.md)
BYD Remote Control
Use the bundled Python scripts in scripts/ for repeatable BYD actions instead of rewriting the same pyBYD code each time.
Available scripts
scripts/battery_check.py, fetch battery %, range, charging state, and timestamps as JSONscripts/battery_monitor.py, fetch battery state and emit an alert payload when battery is belowBATTERY_THRESHOLDscripts/lock_car.py, lock the vehiclescripts/flash_lights.py, flash lights / hornscripts/start_ac.py, start climate controlscripts/stop_ac.py, stop climate controlscripts/byd_common.py, shared helper module used by the scripts
How to use
- Read
references/setup.mdif credentials or dependencies are not already configured. - Run the relevant script from the skill directory so
.envis discovered correctly. - Prefer the existing script over ad hoc inline Python when the task matches one of the bundled actions.
Notes
- The scripts load
.envfrom the same directory as the scripts. BYD_PINis automatically bridged toBYD_CONTROL_PIN.- Vehicle selection can be controlled with
BYD_VINorBYD_VEHICLE_ALIAS. If neither is set, the scripts use the first vehicle returned by the account. battery_monitor.pyprints alert JSON when below threshold. Delivery should be handled by the caller or automation layer.
Usage Guidance
This package appears to do what it says (control BYD vehicles via pyBYD), but the registry metadata is incomplete: the scripts require BYD_USERNAME, BYD_PASSWORD and a control PIN (BYD_PIN or BYD_CONTROL_PIN) stored in a .env in the skill's scripts directory. Before installing or running: 1) Verify the source/trustworthiness of the skill and the pyBYD package (install pyBYD only from its official repository or PyPI after checking it). 2) Do not place your primary BYD credentials in world-readable locations; prefer running the scripts in an isolated environment or container and store .env with strict file permissions. 3) Consider creating a limited or test BYD account if possible, and set BYD_VIN or BYD_VEHICLE_ALIAS to ensure commands target the intended vehicle (the scripts default to the first vehicle returned if unset). 4) If you expect the registry to declare required secrets, ask the publisher to update metadata to list required env vars/primary credential. The mismatch between metadata and code is the primary reason for caution.
Capability Analysis
Type: OpenClaw Skill
Name: byd-remote-control
Version: 1.0.0
The skill provides a collection of Python scripts to monitor and control BYD vehicles using the legitimate 'pybyd' library. The scripts handle vehicle authentication and commands (locking, climate control, battery status) using environment variables or a local .env file as described in the documentation. No indicators of data exfiltration, malicious execution, or prompt injection were found.
Capability Tags
Capability Assessment
Purpose & Capability
The scripts and SKILL.md behavior (battery checks, lock, flash lights, start/stop A/C) match the advertised purpose and rely on the pyBYD library as expected. However, the registry metadata lists no required environment variables or primary credential while the included setup.md and code require BYD_USERNAME, BYD_PASSWORD and BYD_PIN/ BYD_CONTROL_PIN — a clear mismatch between declared requirements and actual needs.
Instruction Scope
The runtime instructions are narrow and consistent with the stated purpose: they instruct the user to run bundled Python scripts which load a .env file from the scripts directory and call the pyBYD client API. The scripts only read their local .env and environment variables, select a vehicle (or default to the first), and invoke vehicle commands; they do not attempt to read unrelated system files or exfiltrate data to unexpected endpoints in the provided code.
Install Mechanism
There is no automated install spec; the README instructs the user to install the pybyd Python dependency manually. No remote downloads, extract operations, or obscure URLs are present in the package. The lack of an install script reduces automated risk but shifts responsibility to the user to install pybyd from a trusted source.
Credentials
The code requires sensitive credentials (BYD_USERNAME, BYD_PASSWORD) and a control PIN (BYD_PIN or BYD_CONTROL_PIN) loaded from a local .env, but the skill metadata declares no required environment variables or primary credential. That omission is an incoherence: the skill will not function without secrets, and the registry entry does not warn users that secrets are required or will be read from disk. This increases the risk of accidental exposure if a user installs or runs the skill without understanding where to store credentials.
Persistence & Privilege
The skill does not request persistent platform privileges (always: false) and does not modify other skills or system-wide settings. It only reads a .env file from its own directory and environment variables; it does not create long-lived background services or write to unrelated system paths.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install byd-remote-control - After installation, invoke the skill by name or use
/byd-remote-control - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is BYD Remote Control?
Control and check a BYD vehicle using portable Python helper scripts built on pyBYD. Use when the user wants to check battery state, lock the car, flash ligh... It is an AI Agent Skill for Claude Code / OpenClaw, with 99 downloads so far.
How do I install BYD Remote Control?
Run "/install byd-remote-control" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is BYD Remote Control free?
Yes, BYD Remote Control is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does BYD Remote Control support?
BYD Remote Control is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created BYD Remote Control?
It is built and maintained by hiimivantang (@hiimivantang); the current version is v1.0.0.
More Skills