Imans CLI Integration for Openclaw

An AI-agent skill that connects OpenClaw to the Imans CLI, enabling seamless queries of workspace metadata, catalogs, and sales orders.

imans-ai
v1.0.0
Jun 5, 2026
0
540
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install imans-claw

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 imans-claw 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 Imans CLI Integration?

The imans-claw skill empowers OpenClaw agents to interface directly with the Imans CLI to retrieve and manage enterprise-level sales, workspace, catalog, and product variant information. By utilizing this integration, developers and operations teams can automate complex inventory and order queries natively within their conversational AI workspaces.

This skill is a key addition to your suite of Openclaw Skills, allowing agents to fetch structured JSON payloads representing product classifications, sales orders, and customer insights. Instead of manual data exports, agents can dynamically parse, filter, and summarize crucial Imans business datasets to solve customer inquiries or automate back-office pipelines safely.

Imans CLI Integration Use Cases

  • Retrieving Product and Variant Details: Instantly lookup catalog specifications, variant details, and inventory classifications.
  • Sales Order Monitoring: Check sales orders by status or date ranges (e.g., retrieving recent orders to answer shipping or fulfillment questions).
  • Workspace and Profile Audits: View active Imans profiles, check authentication status, and query workspace metadata securely.
  • Automated Reporting: Leverage AI agents to generate summaries of product performance, classification metrics, or recent sales pipelines.

How Imans CLI Integration Works

  1. User Request Identification: The user asks a question in OpenClaw regarding Imans products, workspace profiles, or sales history.
  2. Command Selection: The agent identifies the precise CLI parameters and runs the narrowest imans command, prioritizing narrow JSON formatted outputs.
  3. Data Retrieval & Parsing: The underlying system executes the local imans binary, feeding the structured JSON payload back to the agent.
  4. Summary and Delivery: The agent parses the raw JSON locally, extracts key metrics or anomalies, and outputs a highly readable, compact summary to the channel.

Imans CLI Integration Setup

  • Ensure the imans binary is installed on your host system PATH or inside the agent's sandbox container.
  • Install the CLI via Homebrew or curl:
# Using Homebrew
brew install imans-ai/tap/imans

# Using curl
curl -fsSL https://imans.ai/install | bash
  • Authenticate safely using environment tokens:
imans login --token-env IMANS_TOKEN
  • Verify and register with your Openclaw Skills workspace:
openclaw skills list
  • Activate the skill specifically during a session: /skill imans-claw

Imans CLI Integration Data Schema & Taxonomy

Detailed data hierarchy for Imans entities:

Entity Query Command Format Scope
Workspace imans workspace get JSON Active Workspace metadata
Products imans products list JSON Searchable catalog listings
Product Variants imans product-variants list JSON Filtered by product-id
Sales Orders imans sales-orders list JSON Filtered by date, status
Order Items imans sales-order-items list JSON Nested items by order-id
Classifications imans sales-order-classifications list JSON Entire taxonomy mapping

Commands strictly leverage the --json option to generate machine-readable arrays, containing nested keys like id, status, order-date, product-id, and workspace-metadata.

Imans CLI Integration Advanced Features

  • Secure Automated Authentication: Leverages standard environment variables --token-env or stdin streams --token-stdin to prevent sensitive API keys from showing up in shell histories.
  • Multi-Workspace Profile Switching: Uses the --profile <name> flag natively to direct requests across different environments without altering global active parameters.
  • Granular Error Handling: Interprets discrete exit codes (e.g., exit code 3 for auth failures, 5 for resource not found, 7 for server issues) allowing advanced error recovery scripts in Openclaw Skills.
  • Localized Data Condensation: Intelligently summarizes bulk JSON pipelines inside the AI agent to minimize token overhead in group or mobile communication channels.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins imans
Github Stars: 0
forks: 0

Featured*