← Back to Skills Marketplace
97
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install kokonna-frame
Description
Control KoKonna AI e-ink art frames. Upload images, query device info, and manage multiple frames. Use when user asks to "push to frame", "send to frame", "d...
README (SKILL.md)
KoKonna Frame Control
Control KoKonna AI e-ink art frames. Upload images, query device status, and manage multiple frames.
Configuration
Before using this skill, configure your KoKonna devices in ~/.openclaw/skills/kokonna-frame/config.yaml:
api_base_url: "https://api.galaxyguide.cn/openapi"
devices:
living_room: "your-api-key-here"
bedroom: "your-api-key-here"
# Add more devices as needed
Get your API key from your KoKonna frame settings at kokonna.art.
Usage
Command Line
# Upload image to a frame (auto-resize)
python3 scripts/upload.py --device living_room --image /path/to/image.jpg
# Upload with custom name
python3 scripts/upload.py --device living_room --image /path/to/image.jpg --name "Sunset"
# Query device info
python3 scripts/device_info.py --device living_room
# Push to all frames
python3 scripts/upload.py --device all --image /path/to/image.jpg --name "Art"
Python API
from kokonna import KoKonnaFrame
# Initialize frame
frame = KoKonnaFrame(device="living_room")
# Upload image
frame.upload_image("/path/to/image.jpg", name="Sunset")
# Get device info
info = frame.get_device_info()
print(info)
Features
- Automatic Resizing: Images are automatically cropped and resized to match frame display
- Custom Naming: Give images meaningful names that display on the frame
- Multi-Frame Support: Manage multiple KoKonna frames from one agent
- Device Status: Check battery level, online status, and firmware version
Requirements
- Python 3.7+
requestslibraryPillowlibrary
Install: pip install requests Pillow
About KoKonna
KoKonna is an AI-powered e-ink art frame that brings art, information, and personality into your space.
- E-ink Display: Paper-like, low power, beautiful in any light
- AI Art Generation: Automatically creates artwork based on preferences
- Smart Home Integration: Works with your AI assistant
Learn more at kokonna.art.
Usage Guidance
This skill appears to do what it says: resize images and POST them to a KoKonna API using per-device API keys stored in ~/.openclaw/skills/kokonna-frame/config.yaml. Before installing: (1) verify the API base URL (DEFAULT_API_BASE_URL is https://api.galaxyguide.cn/openapi) — confirm this is the official KoKonna endpoint for your device or change it in config.yaml; (2) correct or double-check the registry metadata vs the manifest (the skill actually requires a local config file even though registry metadata omitted it); (3) only provide API keys you obtained from a trusted source (kokonna.art) and avoid reusing high-privilege keys; (4) inspect or run the Python scripts in a controlled environment if you are unsure (they only use requests/Pillow and POST base64 image payloads); (5) prefer installing from a verifiable upstream (official repo or vendor) rather than an unknown source. If you want higher assurance, ask the author for a homepage/repo or for confirmation that api.galaxyguide.cn is the official API host.
Capability Analysis
Type: OpenClaw Skill
Name: kokonna-frame
Version: 1.2.0
The kokonna-frame skill is a legitimate integration for controlling KoKonna e-ink art frames. The code in kokonna.py and the associated scripts (upload.py, device_info.py) facilitates image processing and communication with the product's API at api.galaxyguide.cn. It follows standard security practices, such as using yaml.safe_load for configuration and sanitizing filenames via regex, with no evidence of malicious intent, unauthorized data access, or prompt injection.
Capability Assessment
Purpose & Capability
Name/description (control e-ink frames: upload images, query device info) align with the included Python code and CLI scripts. The code only talks to a single API (upload/device) and expects per-device API keys in a local config file. However, registry metadata omitted any required config path while manifest/README/SKILL.md/code all require ~/.openclaw/skills/kokonna-frame/config.yaml — this metadata mismatch is inconsistent.
Instruction Scope
SKILL.md instructs placing API keys in a local config file and shows CLI/Python usage. Runtime instructions and scripts only read that config file and the provided image path, resize the image, and POST base64 data to the declared API endpoints. There are no instructions to read unrelated local files, environment secrets, or to send data to other endpoints.
Install Mechanism
There is no install spec; the skill is instruction + source files. Dependencies are only requests and Pillow (declared in requirements.txt and SKILL.md). No arbitrary downloads or extract steps are present.
Credentials
The code requires per-device API keys (stored in config.yaml) which is proportional to the function. No environment variables or unrelated secrets are requested. Note: the registry metadata claimed 'Required config paths: none', which contradicts the actual code and SKILL.md that require a config file — this should be fixed/verified.
Persistence & Privilege
Skill does not request permanent/global privileges (always: false). It does not modify other skills or system settings. It will run with normal autonomous invocation behavior unless the platform or user restricts it.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install kokonna-frame - After installation, invoke the skill by name or use
/kokonna-frame - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.0
kokonna-frame 1.2.0
- Update version to 1.2.0 in SKILL.md and manifest.yaml
- No user-facing feature changes or API additions
- Documentation and metadata refreshed for latest release
v1.1.0
kokonna-frame 1.1.0
- Updated version number to 1.1.0.
- Made internal file and script updates for maintenance.
- No user-facing feature or documentation changes.
- All core functionality and usage remain unchanged.
v1.0.0
Initial release of the kokonna-frame skill:
- Control KoKonna AI e-ink art frames directly from your assistant.
- Upload images (with auto-resize and custom naming) to one or multiple frames.
- Query device information including battery, status, and firmware.
- Supports easy setup for multiple frames and smart-home integration.
- Provides both command-line and Python API usage options.
Metadata
Frequently Asked Questions
What is Kokonna Frame?
Control KoKonna AI e-ink art frames. Upload images, query device info, and manage multiple frames. Use when user asks to "push to frame", "send to frame", "d... It is an AI Agent Skill for Claude Code / OpenClaw, with 97 downloads so far.
How do I install Kokonna Frame?
Run "/install kokonna-frame" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Kokonna Frame free?
Yes, Kokonna Frame is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Kokonna Frame support?
Kokonna Frame is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Kokonna Frame?
It is built and maintained by guooscar (@guooscar); the current version is v1.2.0.
More Skills