Holocube Emotes for Openclaw

A specialized integration that gives your AI agent a physical presence by controlling a GeekMagic holocube display with custom holographic emotes.

thrive-spencerj
v1.0.0
Feb 8, 2026
0
2.1k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install holocube-emotes

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install holocube-emotes 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 Holocube Emotes?

Holocube Emotes is a sophisticated hardware integration designed to bridge the gap between digital AI agents and physical environments. By leveraging this skill within the broader ecosystem of Openclaw Skills, developers can transform a GeekMagic HelloCubic-Lite into a reactive, holographic interface. The skill facilitates the generation of custom character sprites using Gemini, automates the upload process to the device's limited internal storage, and provides a command-line interface for real-time expression swapping based on the agent's current state.

This utility is particularly effective for users who want a dedicated 'face' for their AI assistant on their desk. Whether the agent is idling, processing complex code, or encountering an error, Holocube Emotes ensures that the physical hardware reflects the digital context. It is an essential component for those building immersive, high-feedback AI workspaces using Openclaw Skills.

Holocube Emotes Use Cases

  • Provide a physical visual indicator for your AI agent's internal state (Thinking, Idle, Error).
  • Enhance your workstation with a personalized holographic character that reacts to conversation context.
  • Automate device behaviors such as putting the assistant to 'sleep' during night hours.
  • Create high-quality, themed sprite kits automatically using Gemini-powered image generation.

How Holocube Emotes Works

  1. The system auto-discovers GeekMagic holocube devices on the local network using IP scanning.
  2. Custom 240x240 sprite kits are generated via the Gemini API, producing both static JFIF and animated GIF assets.
  3. A setup script clears the device storage and uploads the optimized assets to the holocube's internal flash memory.
  4. During operation, the AI agent or user triggers specific scripts to swap the active display image based on task status.
  5. Heartbeat integrations can be configured to maintain the device state and handle automated time-of-day transitions.

Holocube Emotes Setup

Prerequisites

  • GeekMagic HelloCubic-Lite hardware
  • Python 3 with Pillow installed (pip install Pillow)
  • API access for sprite generation (via nano-banana-pro skill)

Installation Steps

# 1. Discover the device on your network
python3 scripts/holocube.py --discover

# 2. Generate a custom sprite kit
python3 scripts/generate_sprites.py --output-dir ./sprites --character "A neon wireframe robot"

# 3. Upload sprites to the device
python3 scripts/setup_device.py --sprites-dir ./sprites --clear

Holocube Emotes Data Schema & Taxonomy

The skill manages assets and state mapping to ensure compatibility with the holocube's 3MB storage limit:

Asset Type Resolution Format Usage
Static Sprites 240x240px JFIF JPEG Low-power/Static display
Animated Sprites 240x240px GIF Real-time agent expressions
Custom Slot 240x240px adam-custom.gif On-demand dynamic animations

Mappings:

  • thinking/working -> processing animation
  • happy/complete -> success animation
  • error/surprised -> alert animation
  • sleeping -> inactive/night mode

Holocube Emotes Advanced Features

  • Multi-state mapping allowing for various agent models (Opus, Haiku) to trigger unique visual styles.
  • Heartbeat integration for autonomous device management via HEARTBEAT.md.
  • Support for automatic time-aware transitions to manage brightness and 'sleep' states.
  • Backup and restore functionality for existing device assets before new deployments.
  • Optimization for dark/black backgrounds to enhance the 'holographic' floating effect on glass displays.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*