Eagle API Control for Openclaw

A powerful CLI-driven skill that enables automated control over the Eagle application for advanced digital asset management and organization.

roaycl
v1.0.0
Mar 24, 2026
0
771
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install eagle-skill

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 eagle-skill 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 Eagle API Control?

The Eagle API skill for Openclaw Skills provides a direct bridge between your AI coding agent and the Eagle application. It allows for programmatic interaction with your local digital asset library, enabling automated workflows for organizing images, videos, fonts, and design files via a Node.js-based CLI.

By leveraging this skill, developers and designers can extend the capabilities of their Openclaw Skills environment to include sophisticated library management. Whether you need to batch-process tags, restructure folder hierarchies, or perform semantic AI searches, this integration brings the full power of Eagle's local API server into your automated development lifecycle.

Eagle API Control Use Cases

  • Automated tagging and classification of design assets during the development process.
  • Programmatic migration of assets between different folders based on project milestones.
  • Bulk merging of duplicate tags to maintain library cleanliness.
  • Integrating semantic AI search into automated asset retrieval workflows.
  • Fetching currently selected items in Eagle to perform context-aware AI operations.

How Eagle API Control Works

  1. The skill connects to the local Eagle API server running on port 41596 via the Eagle MCP plugin.
  2. Commands are issued through the eagle-api-cli.js script using Node.js.
  3. The CLI parses user input, including JSON strings for complex objects like tag arrays or folder configurations.
  4. Requests are sent to specific tool categories including App, Item, Folder, Tag, and Tag Group.
  5. The Eagle application processes the request and updates the local library or returns requested metadata to the agent.

Eagle API Control Setup

To utilize this skill within Openclaw Skills, ensure the following requirements are met:

  1. Ensure the Eagle application is running on your machine.
  2. Enable the Eagle MCP plugin to provide the local API server on port 41596.
  3. Verify that Node.js is installed to execute the CLI script.

Basic command structure:

# List all available tools to verify connection
node scripts/eagle-api-cli.js list

# Get help for a specific item tool
node scripts/eagle-api-cli.js help item_get

Eagle API Control Data Schema & Taxonomy

The skill interacts with Eagle's internal database using the following primary entities:

Entity Description Key Attributes
Item Individual assets ID, tags, extension, folders, metadata
Folder Structural containers Name, iconColor, parentId, children
Tag Metadata labels Name, usage count, groups
Tag Group Tag categories Group name, associated tags

Data is passed as JSON objects, allowing for complex queries such as filtering by multiple tags: ["photo", "landscape"].

Eagle API Control Advanced Features

  • AI Semantic Search: Perform deep content searches by text or visual similarity using the AI Search plugin integration.
  • Batch Processing: Execute multi-item updates for tags and folder placements using the --json parameter flag.
  • Tag Merging: Programmatically clean up libraries by merging source tags into a single target tag.
  • Selection Tracking: Real-time retrieval of the user's active selection within the Eagle UI for immediate processing.
  • Auto-Parsing: Intelligent CLI parsing that converts string-based JSON inputs into functional JavaScript objects for API calls.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*