instagram-poster

What This Skill Does

The Instagram Poster skill is a powerful automation tool designed for OpenClaw that facilitates content management on Instagram without relying on third-party cloud-based APIs or expensive Cloudflare-dependent services. By leveraging local Puppeteer instances, it mimics real human interaction, allowing users to perform complex publishing tasks such as creating feed posts, carousels, reels, and stories directly from their environment. This tool handles the entire lifecycle of a post—from authentication and file uploading to caption writing and final submission—providing a headless browser solution that is both private and highly customizable. It is designed for creators, marketers, and developers who require reliable, programmatic control over their social media presence.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface. Ensure you have Node.js installed in your project directory before running the installation command.

clawhub install openclaw/skills/skills/sa9saq/instagram-poster

Additionally, you must install the core dependency to allow the skill to control the browser:

npm install puppeteer

Use Cases

This skill is ideal for several automation scenarios:

• Content Scheduling: Maintain a consistent presence by automating post deployments at optimal times of the day.
• Batch Processing: Efficiently upload series of product images or multi-slide carousel educational content.
• Data-Driven Marketing: Integrate with other AI tools to generate caption variants or hashtag clouds based on performance trends, then automatically push them live.
• Workflow Automation: Connect this skill to local file system triggers, where dropping an image into a specific folder initiates an automated draft and upload process.

Example Prompts

1. "Instagramに画像を投稿して。キャプションは『最新のテックニュースをチェック！ #tech #ai』でお願いします。"
2. "Instagramリールを投稿して。動画ファイルは /exports/video_final.mp4 にあります。キャプションにはプロモーション用のハッシュタグを最適化して含めてください。"
3. "Instagramカルーセル投稿を作成して。画像1から画像3を順番に使用し、『週末のまとめ』というテーマでキャプションを作成してください。"

Tips & Limitations

• Safety: Always ensure that your INSTAGRAM_USERNAME and INSTAGRAM_PASSWORD are stored securely in a .env file and never hardcoded in your scripts.
• Headless Mode: While the skill defaults to headless mode for efficiency, you may occasionally need to toggle headless: false during initial login troubleshooting to pass manual CAPTCHA challenges.
• Rate Limiting: As this automates browser actions, avoid flooding Instagram with requests in a short time window to prevent account flagging or temporary blocks.
• Maintenance: Instagram frequently updates its UI classes; if selectors stop working, update the Puppeteer selectors in the postToInstagram function to reflect the current DOM structure.