A comprehensive hybrid CLI for Instagram that bridges Meta Graph API safety with private API feature depth for AI agents.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install clinstagram
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 clinstagram 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 clinstagram?
clinstagram is a professional-grade command-line interface built to empower AI agents and developers with full control over Instagram accounts. It operates using a unique hybrid architecture that intelligently routes requests between the official Meta Graph API and the instagrapi private API. This dual-backend approach ensures that users can prioritize safety and official compliance for standard tasks while accessing deep features like Direct Messages and Stories when necessary. As a key part of the Openclaw Skills ecosystem, it provides structured JSON outputs and clear error remediation paths.
The tool is designed with a safety-first philosophy, offering three distinct compliance modes: official-only, hybrid-safe (default), and private-enabled. This allows developers to strictly control the risk profile of their automation, making it suitable for everything from corporate brand management to experimental agentic growth strategies. Whether you are automating content pipelines or building a customer support bot, this skill provides the technical bridge needed to interact with Instagram at scale.
clinstagram Use Cases
- Automating the publication of photos, videos, reels, and carousels from local storage or remote URLs.
- Managing high-volume direct message inboxes and sending cold DMs programmatically.
- Monitoring brand performance through detailed post and hashtag analytics.
- Implementing automated engagement strategies including likes, comments, and follower management.
- Researching competitors and market trends by searching users and top hashtag content.
How clinstagram Works
- The user installs the CLI and sets a global compliance mode to define which API backends are authorized for use.
- Authentication is performed via official Meta logins (for graph_ig and graph_fb) or username/password credentials for the private API.
- Commands are issued using a specific syntax where global flags like --json and --account must precede the subcommand.
- The internal routing engine selects the best available backend based on the specific capability required (e.g., routing DMs through Facebook Graph or Private API).
- The skill executes the request and returns a structured JSON object containing the result, the backend used, and machine-readable error codes if a failure occurs.
clinstagram Setup
Install the skill via pip to begin integrating it with your Openclaw Skills workflow:
pip install clinstagram
Initialize your environment by setting the compliance mode and authenticating your accounts:
# Set compliance to allow necessary features
clinstagram config mode hybrid-safe
# Connect official Meta backends
clinstagram auth connect-ig
# Login to the private API for extended features
clinstagram auth login
clinstagram Data Schema & Taxonomy
The skill produces standardized JSON responses to ensure seamless interoperability. The data schema is organized as follows:
| Key | Type | Description |
|---|---|---|
exit_code |
Integer | 0 for success; 1-7 for specific error types like Auth or Rate Limits. |
data |
Object/Array | The actual payload (e.g., list of messages, post stats). |
backend_used |
String | Indicates if graph_ig, graph_fb, or private was used. |
remediation |
String | A suggested CLI command to resolve the current error. |
retry_after |
Integer/Null | Seconds to wait if rate-limited. |
error |
String | Short error identifier (e.g., session_expired). |
clinstagram Advanced Features
- Multi-account support via the --account flag for managing complex social portfolios.
- Growth action safety gates that require the --enable-growth-actions flag to prevent accidental mass-engagement.
- Dry-run capabilities to validate command syntax and API permissions without making live changes.
- Proxy support via the --proxy URL flag for distributed agent operations.
- Comprehensive capability matrix that automatically falls back to secondary backends if the primary is unavailable.
SKILL.md
Loading
Related Openclaw Skills
Daily Report Generator
A tool that automates the creation of professional work reports by aggregating data from git commits, calendar events, and task managers.
OpenClaw Safe Change Flow
A robust workflow and automation script for making safe configuration changes to OpenClaw instances with automatic rollback capabilities.
UI/UX Pro Max
A comprehensive UI/UX design intelligence skill for building polished, accessible, and implementation-ready web and mobile interfaces.
SendTradeSignal
A specialized connector for sending quantitative trading signals from an AI agent to the FMZ platform via HTTP API.
File Organizer Skill
Automatically sort cluttered directories into organized subfolders by file extension or creation date.
Guardian Wall
A security-focused skill for sanitizing external content and neutralizing prompt injection attacks in AI agent workflows.
Featured*
