A specialized tool for controlling KoKonna AI e-ink art frames to upload images and monitor device status via AI agents.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install kokonna-frame
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 kokonna-frame 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 KoKonna Frame Control?
The KoKonna Frame Control skill enables developers and smart home enthusiasts to bridge the gap between AI agents and physical e-ink displays. By integrating this capability into your Openclaw Skills library, you can programmatically push artwork, photos, or data visualizations to your KoKonna devices using simple natural language triggers. It handles the technical heavy lifting of image processing and API communication, turning your e-ink frame into a dynamic, AI-driven canvas.
This skill is designed for those who want a seamless way to display visual content in their physical environment. Whether you are building an automated art gallery or a status dashboard, this integration provides the necessary tools to manage multiple devices from a single interface. By leveraging Openclaw Skills, users can enjoy a more interactive and visually responsive AI assistant experience.
KoKonna Frame Control Use Cases
- Instantly push AI-generated artwork from a chat interface to a physical e-ink display.
- Automate daily photo updates across multiple rooms using multi-frame support.
- Monitor the battery life and connectivity status of your art frames through voice queries.
- Create a rotating digital gallery that changes based on your current mood or AI agent context.
How KoKonna Frame Control Works
- The user provides a command or image path to the AI agent, triggering the Openclaw Skills workflow.
- The skill identifies the target device based on the local configuration file and specified aliases.
- The image is processed locally using the Pillow library to ensure it matches the specific aspect ratio and resolution of the e-ink display.
- The skill authenticates with the KoKonna OpenAPI using a secure API key and transmits the optimized image data.
- The e-ink frame updates its display, and the skill returns the current device status including battery level and firmware version.
KoKonna Frame Control Setup
To get started, first ensure you have the required Python dependencies installed:
pip install requests Pillow
Next, configure your devices by editing the configuration file located at ~/.openclaw/skills/kokonna-frame/config.yaml. You will need to obtain your API key from the settings menu at kokonna.art:
api_base_url: "https://api.galaxyguide.cn/openapi"
devices:
living_room: "your-api-key-here"
bedroom: "your-api-key-here"
KoKonna Frame Control Data Schema & Taxonomy
The skill manages device connectivity and image metadata using a structured schema to ensure compatibility across the Openclaw Skills ecosystem:
| Attribute | Description | Data Type |
|---|---|---|
| device_id | The unique identifier or alias for the target frame | String |
| image_name | A custom label displayed on the e-ink frame | String |
| status | The current operational state (online/offline) | Boolean |
| battery | Current charge level of the e-ink device | Integer |
| firmware | The version of the software running on the frame | String |
KoKonna Frame Control Advanced Features
- Automatic Image Resizing: Intelligent cropping and scaling to prevent distortion on e-ink displays.
- Multi-Device Broadcasting: Send a single image to all configured frames simultaneously using the all command.
- Python API Access: A dedicated KoKonnaFrame class for developers to build custom automation logic outside of basic CLI usage.
- Low-Power Monitoring: Integrated status checks to help manage device maintenance and charging schedules within your Openclaw Skills setup.
SKILL.md
Loading
Related Openclaw Skills
Detector AI
An advanced text analysis engine that identifies AI-generated content through multi-layered linguistic fingerprints and statistical modeling.
Aria: Antique Soul Virtual Girlfriend
Aria is a sophisticated AI companion persona featuring an antique soul genius personality designed for deep intellectual intimacy and traditional devotion.
Digital Gov Consultant
A professional AI consultant for digital government application scenarios, specializing in policy interpretation and document generation.
OnlyVPN CLI
A powerful command-line interface for the OnlyVPN desktop client, enabling seamless automation of VPN connections and subscription management.
Humanizer AI
An AI-driven skill designed to identify AI writing patterns and rewrite text to make it sound natural, authentic, and uniquely human.
Gongjian Catalog
A specialized AI agent skill for querying real-time health supplement data, pricing, and personalized nutritional recommendations.
Featured*
