✓ Verified 💻 Development ✓ Enhanced Data

Instagram Poster

Post images to Instagram automatically via Telegram.

Rating: 4.6 (52 reviews)
Downloads: 2,558 downloads
Version: 1.0.0

Overview

Post images to Instagram automatically via Telegram.

Complete Documentation

View Source →

instagram-poster

Post images to Instagram directly from your AI agent — bypasses bot detection with a real residential IP.

Quick start

bash

node {baseDir}/scripts/post.js \
  --image ./photo.jpg \
  --caption "Good morning 🌅 #photography" \
  --user YOUR_USERNAME \
  --pass YOUR_PASSWORD

Post a WaveSpeed-generated image:

bash

# 1. Generate image
node /workspace/.agents/skills/wavespeed/scripts/wavespeed.js generate \
  --model flux-schnell --prompt "sunset over mountains" --output /tmp/post.png

# 2. Post to Instagram
node {baseDir}/scripts/post.js \
  --image /tmp/post.png \
  --caption "Golden hour 🏔️ #nature #photography"

Options

Flag	Env	Description
--image	IG_IMAGE	Local file path or HTTPS URL
--caption	IG_CAPTION	Post caption (optional)
--user	IG_USERNAME	Instagram username
--pass	IG_PASSWORD	Instagram password
--session	IG_SESSION_PATH	Cookie session file (default: ~/.openclaw/ig-session.json)

Session caching

On first run, logs in and saves cookies to ~/.openclaw/ig-session.json. Subsequent runs reuse the session — no re-login needed.

Config in openclaw.json

json5

{
  skills: {
    entries: {
      "instagram-poster": {
        env: {
          IG_USERNAME: "your_username",
          IG_PASSWORD: "your_password"
        }
      }
    }
  }
}

How it works

Launches a stealth browser with a Romanian residential IP (via human-browser)
Logs into Instagram as a real iPhone user — passes all bot checks
Uploads your image and submits the caption
Saves session cookies so you stay logged in

Requirements

human-browser skill installed
Human Browser subscription (residential proxy) → humanbrowser.dev
Instagram account credentials

Agent usage example

text

User: Post this sunset photo to Instagram with caption "Golden hour 🌅"
Agent: node {baseDir}/scripts/post.js --image /tmp/sunset.jpg --caption "Golden hour 🌅"

Installation

Terminal bash


openclaw install instagram-poster

Copied!

💻Code Examples

--caption "Golden hour 🏔️ #nature #photography"

---caption-golden-hour--nature-photography.txt

## Options

| Flag | Env | Description |
|------|-----|-------------|
| `--image` | `IG_IMAGE` | Local file path or HTTPS URL |
| `--caption` | `IG_CAPTION` | Post caption (optional) |
| `--user` | `IG_USERNAME` | Instagram username |
| `--pass` | `IG_PASSWORD` | Instagram password |
| `--session` | `IG_SESSION_PATH` | Cookie session file (default: `~/.openclaw/ig-session.json`) |

## Session caching

On first run, logs in and saves cookies to `~/.openclaw/ig-session.json`.
Subsequent runs reuse the session — no re-login needed.

## Config in openclaw.json

}

.txt

## How it works

1. Launches a stealth browser with a **Romanian residential IP** (via human-browser)
2. Logs into Instagram as a real iPhone user — passes all bot checks
3. Uploads your image and submits the caption
4. Saves session cookies so you stay logged in

## Requirements

- [human-browser](https://clawhub.ai/skills/human-browser) skill installed
- Human Browser subscription (residential proxy) → [humanbrowser.dev](https://humanbrowser.dev)
- Instagram account credentials

## Agent usage example

example.sh

node {baseDir}/scripts/post.js \
  --image ./photo.jpg \
  --caption "Good morning 🌅 #photography" \
  --user YOUR_USERNAME \
  --pass YOUR_PASSWORD

example.sh

# 1. Generate image
node /workspace/.agents/skills/wavespeed/scripts/wavespeed.js generate \
  --model flux-schnell --prompt "sunset over mountains" --output /tmp/post.png

# 2. Post to Instagram
node {baseDir}/scripts/post.js \
  --image /tmp/post.png \
  --caption "Golden hour 🏔️ #nature #photography"

example.txt

{
  skills: {
    entries: {
      "instagram-poster": {
        env: {
          IG_USERNAME: "your_username",
          IG_PASSWORD: "your_password"
        }
      }
    }
  }
}