A comprehensive interface for managing IMA notes and knowledge bases via official OpenAPI endpoints.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ima-skill
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 ima-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 IMA OpenAPI Skill?
The IMA OpenAPI skill is a unified solution for users looking to bridge their AI agents with the IMA ecosystem. It enables seamless management of digital assets by providing dedicated modules for note-taking and knowledge base organization. This integration, part of the wider ecosystem of Openclaw Skills, ensures that users can interact with their personal documents, search research repositories, and capture web content through a secure and structured API.
By utilizing this skill, developers can build workflows that automatically synchronize information between their local environment and the cloud-based IMA platform. It prioritizes data integrity through strict encoding standards and official authentication protocols, making it a reliable tool for professional knowledge management.
IMA OpenAPI Skill Use Cases
- Searching and browsing personal note collections or research logs.
- Uploading local files, PDFs, and Excel documents directly to a knowledge base.
- Appending new insights or web-scraped content to existing digital notes.
- Creating new document entries to record AI-generated research results.
- Linking specific notes to broader knowledge base repositories for better context.
How IMA OpenAPI Skill Works
- The skill initializes by validating user-provisioned credentials from environment variables or local config files.
- It analyzes user intent to route requests to either the notes module or the knowledge-base module.
- For text-based operations, it performs a critical UTF-8 encoding check to ensure character compatibility.
- It constructs a secure HTTP POST request containing the JSON body and authentication headers.
- The request is sent strictly to the official ima.qq.com endpoints.
- For legacy environments like PowerShell 5.1, it automatically converts the body to a byte array to prevent silent encoding corruption.
IMA OpenAPI Skill Setup
First, obtain your Client ID and API Key from the official portal at https://ima.qq.com/agent-interface.
Option A: Configuration File (Recommended)
mkdir -p ~/.config/ima
echo "your_client_id" > ~/.config/ima/client_id
echo "your_api_key" > ~/.config/ima/api_key
Option B: Environment Variables
export IMA_OPENAPI_CLIENTID="your_client_id"
export IMA_OPENAPI_APIKEY="your_api_key"
IMA OpenAPI Skill Data Schema & Taxonomy
The skill manages data through official IMA metadata structures. Below is the primary schema for API interactions:
| Attribute | Description | Protocol |
|---|---|---|
| Client ID | Unique identifier for API authentication | HTTP Header |
| API Key | Secret key for secure access | HTTP Header |
| doc_id | Unique identifier for specific notes or documents | JSON Body |
| content | UTF-8 encoded text for note operations | JSON Body |
| media_type | Identifier for resource types (e.g., 11 for notes) | JSON Body |
IMA OpenAPI Skill Advanced Features
- Multi-module sequencing allowing for 'Search Knowledge Base then Append to Note' workflows.
- Intelligent character encoding detection and conversion to prevent data corruption across different operating systems.
- Binary-safe file handling for knowledge base uploads, preserving original document integrity.
- Native compatibility layer for legacy PowerShell 5.1 environments to ensure reliable cross-platform execution.
SKILL.md
Loading
Related Openclaw Skills
Luban Game Configuration Skill
A specialized tool for managing Luban game configuration tables, enabling seamless CRUD operations on Excel-based game data, enums, and beans.
Skill Finder
A powerful command-line discovery engine for searching, filtering, and exploring Openclaw Skills across the ClawHub platform.
Amazon FBA Prep Assistant
A comprehensive AI-driven preparation guide for Amazon FBA shipments, ensuring compliance and cost-optimization for e-commerce sellers.
Bilibili Research Kit
A comprehensive data extraction and analysis tool for Bilibili video content, subtitles, and danmaku powered by yt-dlp.
CoreLocationCLI
A macOS command-line tool that provides physical device coordinates and reverse geocoding information through the terminal.
ClawDef
ClawDef is a native security and protection system designed to safeguard AI agents within the Openclaw ecosystem through real-time monitoring and threat mitigation.
Featured*
