← 返回 Skills 市场
97
总下载
0
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install 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...
使用说明 (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.
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install kokonna-frame - 安装完成后，直接呼叫该 Skill 的名称或使用
/kokonna-frame触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
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.
元数据
常见问题
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 97 次。
如何安装 Kokonna Frame？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install kokonna-frame」即可一键安装，无需额外配置。
Kokonna Frame 是免费的吗？
是的，Kokonna Frame 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Kokonna Frame 支持哪些平台？
Kokonna Frame 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Kokonna Frame？
由 guooscar（@guooscar）开发并维护，当前版本 v1.2.0。
推荐 Skills