A powerful automation tool for AI agents to post images to Instagram using residential proxies to bypass bot detection.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install instagram-poster
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 instagram-poster 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 Instagram Poster?
The instagram-poster skill is designed to bridge the gap between AI content generation and social media distribution. By utilizing Openclaw Skills, developers can empower their agents to publish images directly to Instagram while maintaining a high degree of account safety. The skill specifically addresses the challenge of bot detection by simulating real iPhone user behavior through a stealth browser environment.
This skill is particularly effective when combined with other Openclaw Skills, such as those used for image generation. It manages the entire lifecycle of a post, from initial authentication and session persistence to the final submission of captions and media, all while routed through a residential IP address to ensure reliability.
Instagram Poster Use Cases
- Automating a daily photo feed using AI-generated imagery.
- Managing multiple Instagram accounts via a centralized AI agent interface.
- Scheduling social media posts directly from a terminal or developer workflow.
- Sharing real-time visual updates from automated monitoring systems to a social audience.
How Instagram Poster Works
- The skill launches a stealth browser instance powered by a residential IP to mask the automation signature.
- It performs a secure login to Instagram, mimicking the fingerprint of a standard iPhone user.
- The system uploads the target image file and attaches the specified caption and hashtags.
- It saves session cookies to a local JSON file to allow for subsequent posts without triggering repeated login alerts.
Instagram Poster Setup
To get started with this entry in the Openclaw Skills library, you must first install the human-browser dependency and configure your credentials.
Add your credentials to your openclaw.json file:
{
"skills": {
"entries": {
"instagram-poster": {
"env": {
"IG_USERNAME": "your_username",
"IG_PASSWORD": "your_password"
}
}
}
}
}
Alternatively, you can run the poster directly via CLI:
node scripts/post.js --image ./photo.jpg --caption "My first automated post" --user USERNAME --pass PASSWORD
Instagram Poster Data Schema & Taxonomy
The skill manages data primarily through session files and environment configurations to ensure persistent access without repeated authentication.
| Data Point | Storage Method | Purpose |
|---|---|---|
| Session Cookies | ~/.openclaw/ig-session.json |
Stores authentication tokens to bypass login on future runs. |
| Credentials | Environment Variables | Secure storage for IG_USERNAME and IG_PASSWORD. |
| Media Input | File Path / URL | Defines the source image for the Instagram post. |
| Metadata | CLI Flags | Handles captions, mentions, and hashtags. |
Instagram Poster Advanced Features
- Full integration with WaveSpeed for automated image creation and immediate posting.
- Residential proxy rotation via human-browser to maintain high account reputation.
- Automatic session caching and cookie management to minimize account lockouts.
- Support for both local file paths and remote HTTPS URLs for image sourcing.
SKILL.md
Loading
Related Openclaw Skills
mcp-vods
A versatile media discovery skill that enables AI agents to find video content and cast it directly to smart TVs.
MCP Lark / FeiShu Integration
A powerful bridge connecting AI agents to the Lark and FeiShu ecosystem via the Model Context Protocol (MCP).
Home Assistant (mcp-hass)
A bridge for AI agents to interact with Home Assistant devices and states via the Model Context Protocol.
edge-tts-uvx
A high-fidelity text-to-speech engine leveraging Microsoft Edge's neural voices for natural-sounding audio generation.
Polyclawster Agent
A secure, non-custodial AI agent skill for automated and manual trading on Polymarket prediction markets using locally signed transactions.
pinets
A command-line utility for executing TradingView Pine Script indicators and outputting structured technical analysis data.
Featured*
