← Back to Skills Marketplace
1789
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install sphero-mini
Description
Control Sphero Mini robot ball via Bluetooth Low Energy. Roll, change colors, read sensors, draw shapes, and play with cats. Uses bleak for cross-platform BLE support (macOS/Windows/Linux).
Usage Guidance
This package largely does what it claims (BLE control for a Sphero Mini) and installs only the standard bleak library, but there are several mismatches and missing files that make it risky to run without inspection. Before installing/running: 1) Review scripts/sphero_mini_bleak.py (you already have it) and confirm the API names used (e.g., getVoltage vs getBatteryVoltage) and the AntiDOS write are acceptable; 2) Note missing or inconsistent files referenced in docs (sphero_control.py imports sphero_mini which isn't included; SKILL.md/README mention set_color.py and getBatteryVoltage which are absent or differently named). Either fix imports or run the scripts that explicitly import sphero_mini_bleak.py. 3) Do not run curl commands from docs without verifying the target URLs; those example commands would download third-party code. 4) Run BLE scripts from an unprivileged account and be prepared to grant Bluetooth permissions (on Linux you may need capabilities or sudo). If you want to proceed, test on a system where unexpected behavior (e.g., uncontrolled robot movement) is safe and review any external code referenced in the documentation first.
Capability Analysis
Type: OpenClaw Skill
Name: sphero-mini
Version: 1.0.0
The skill is designed to control a Sphero Mini robot via Bluetooth Low Energy. All code and instructions are directly related to this stated purpose, involving BLE communication, robot movement, and LED control. There is no evidence of data exfiltration, malicious execution, persistence, or prompt injection against the agent in `SKILL.md`. While `references/examples.md` contains `curl` commands to download files and `references/troubleshooting.md` contains `sudo` commands, these are presented as manual instructions for the user in documentation, not as part of the automated skill execution or installation by the AI agent.
Capability Assessment
Purpose & Capability
Name/description match the included code and the only declared dependency is bleak (a BLE library). Requiring python3 and bleak is proportional for a Bluetooth robot control skill.
Instruction Scope
SKILL.md and README contain usage examples that reference some files/functions that are not present or have different names in the bundle (e.g., calls to getBatteryVoltage vs. getVoltage, references to scripts/set_color.py which is not in the manifest). scripts/sphero_control.py imports 'sphero_mini' which is not included (the main library present is sphero_mini_bleak.py). These mismatches could cause confusion or cause users to run the wrong commands; instructions also suggest optional curl downloads from GitHub raw URLs in docs (not executed by install but could prompt users to fetch extra code).
Install Mechanism
Install spec only uses pip to install the well-known 'bleak' package. No arbitrary URL downloads, no archive extraction, and no nonstandard install locations were declared.
Credentials
The skill requests no environment variables, no credentials, and no config paths. There are no surprising secret or credential requests relative to the stated purpose.
Persistence & Privilege
always is false and the skill does not request elevated platform privileges or modify other skills/config. It runs as normal user-space scripts and does not request permanent presence.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install sphero-mini - After installation, invoke the skill by name or use
/sphero-mini - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: cross-platform Sphero Mini control via Bluetooth LE
- Control Sphero Mini robot ball using Python and bleak on macOS, Windows, and Linux.
- Supports rolling, LED color/backlight control, battery status, heading reset, and power management.
- Includes pre-built scripts: random cat play mode, draw shapes (square, star), and color setting.
- Troubleshooting tips, installation, and quick start examples provided.
- For Sphero Mini only; not compatible with other Sphero models.
Metadata
Frequently Asked Questions
What is Sphero Mini Control?
Control Sphero Mini robot ball via Bluetooth Low Energy. Roll, change colors, read sensors, draw shapes, and play with cats. Uses bleak for cross-platform BLE support (macOS/Windows/Linux). It is an AI Agent Skill for Claude Code / OpenClaw, with 1789 downloads so far.
How do I install Sphero Mini Control?
Run "/install sphero-mini" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Sphero Mini Control free?
Yes, Sphero Mini Control is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Sphero Mini Control support?
Sphero Mini Control is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Sphero Mini Control?
It is built and maintained by JonesChi (@joneschi); the current version is v1.0.0.
More Skills