partykeys_midi

What This Skill Does

The partykeys_midi skill enables your OpenClaw AI agent to become a sophisticated music instructor and controller for the PartyKeys MIDI keyboard. By leveraging a high-performance WebSocket architecture, the agent can send real-time commands to the keyboard, managing individual LED key illumination using a 12-color palette. Beyond lighting, the agent can listen to real-time MIDI input from your instrument, execute complex pre-programmed music sequences, and guide users through interactive 'follow mode' lessons. It bridges the gap between hardware and software, whether you are using a local browser session or the PartyKeys Bridge mobile app for seamless remote connectivity.

Installation

To begin, ensure you have initialized your environment by running the setup script provided in your base directory: bash {baseDir}/scripts/setup.sh Once the dependencies are ready, install the skill via the ClawHub CLI: clawhub install openclaw/skills/skills/allen4z/partykeys-midi Ensure your device is powered on and your network permits local socket communication on port 18790.

Use Cases

• Music Education: Use 'follow mode' to have the AI teach you specific chords or scales by illuminating the correct keys in real-time.
• Performance/Lighting: Create stunning visual light shows synced to your live keyboard performance.
• MIDI Sequencing: Program the AI to play complex backing tracks or melodic lines while you practice accompaniment.
• Interactive Practice: Use the listening mode to have the AI analyze your playing and provide feedback on your accuracy during practice sessions.

Example Prompts

1. "Connect to my keyboard via the mobile bridge and light up the keys for a C Major chord in red, orange, and yellow."
2. "I'm ready to learn, please enter follow mode for the sequence of C4, E4, and G4, with a 5-second delay between notes."
3. "Clear all current lighting on the keyboard and listen for my next sequence of notes to record them."

Tips & Limitations

• Connection Modes: Always verify your security context. If you are using the 'web' mode, ensure your page is served over https or localhost due to browser-level Web Bluetooth security restrictions. If you encounter connectivity issues, the 'mobile' app bridge is the most reliable method, especially when running the agent on remote cloud servers.
• Color Mapping: The skill supports 12 distinct colors. Note that passing empty arrays to the lighting function is the standard way to reset all keys to 'off'.
• Stability: For the best performance, keep the mobile app in the foreground when using the 'mobile' bridge mode to prevent system power management from interrupting the Bluetooth stream.