A Python-based automation skill to control Sphero Mini robot balls through Bluetooth Low Energy across multiple platforms.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install sphero-mini
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install sphero-mini using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Sphero Mini Control?
This skill provides a comprehensive Python interface for interacting with the Sphero Mini robot using the bleak library. It enables developers to programmatically control robot movements, LED configurations, and power states across macOS, Windows, and Linux. By leveraging Openclaw Skills, users can integrate physical robot automation into their local workflows, ranging from simple color changes to complex geometric movement patterns and interactive pet play modes.
The library is designed for the Sphero Mini specifically and focuses on cross-platform compatibility. It abstracts the complexities of Bluetooth Low Energy (BLE) communication, allowing users to send commands for speed, heading, and RGB LED values with simple asynchronous Python functions.
Sphero Mini Control Use Cases
- Automating pet entertainment using the randomized Cat Play Mode.
- Teaching programming and geometry by drawing squares, stars, and circles.
- Visualizing system alerts or notifications through RGB LED color changes.
- Developing custom robotic routines for IoT demonstrations or local experiments.
How Sphero Mini Control Works
- The user identifies the Sphero Mini device's MAC or UUID address using the provided scanning script.
- A Bluetooth Low Energy (BLE) connection is established via the bleak library.
- The skill sends a wake command to the robot to transition it from deep sleep to an active state.
- Commands for movement, such as speed and heading, or LED color updates are transmitted asynchronously.
- The robot processes these packets in real-time, executing physical movements or light changes until a sleep or disconnect command is received.
Sphero Mini Control Setup
1. Install Dependencies
Install the required Bluetooth library using pip:
pip3 install bleak
2. Locate Your Device
Run the scan script to find your Sphero Mini's identifier (look for SM-XXXX):
python3 scripts/scan_sphero.py
3. Configure Scripts
Replace the placeholder SPHERO_MAC in your scripts with the address found during the scan step.
Sphero Mini Control Data Schema & Taxonomy
The skill interacts with the robot using specific command parameters as outlined in the following table:
| Parameter | Value Range | Description |
|---|---|---|
| Speed | 0 - 255 | Controls the velocity of the robot roll. |
| Heading | 0 - 359 | The direction in degrees the robot will face. |
| RGB Colors | 0 - 255 | Individual red, green, and blue values for the main LED. |
| Back LED | 0 - 255 | Brightness intensity for the rear orientation LED. |
| Battery | Voltage | Floating point value representing current battery status. |
Sphero Mini Control Advanced Features
- Cat Play Mode: A pre-built script that generates unpredictable movements and color cycles to engage pets.
- Shape Drawing API: Automated routines for rendering geometric patterns like stars and circles through heading increments.
- Battery Monitoring: Programmatic access to voltage levels to trigger low-power routines or docking alerts.
- Cross-Platform BLE: High-level abstraction using the bleak library for consistent performance on Windows, macOS, and Linux when using Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Home Assistant CLI
An advanced command-line interface for Home Assistant providing deep control over smart devices, event monitoring, and history tracking.
Decision Topology
A local-first skill that records the structural evolution of ideas, branches, and pivots in your conversations as a browsable JSON tree.
Research Library
A local-first multimedia research library designed to capture, organize, and search hardware project knowledge with intelligent weighting.
RAG Eval
A diagnostic tool for evaluating the accuracy and retrieval quality of RAG pipelines using Ragas metrics.
molt-life-kernel
A specialized Node.js infrastructure module providing AI agents with persistent identity, crash recovery, and cognitive health monitoring through a verifiable ledger system.
Molt Life Kernel
A specialized Node.js infrastructure module providing AI agents with persistent identity, crash recovery, and cognitive health monitoring.
Featured*
