- name
- instagram-poster
- description
- >
- metadata
- openclaw
- emoji
- 📸
- os
- [linux, darwin, win32]
- requires
- skills
- [human-browser]
- env
- [IG_USERNAME, IG_PASSWORD]
instagram-poster
Post images to Instagram directly from your AI agent — bypasses bot detection with a real residential IP.
Quick start
node {baseDir}/scripts/post.js \
--image ./photo.jpg \
--caption "Good morning 🌅 #photography" \
--user YOUR_USERNAME \
--pass YOUR_PASSWORDPost a WaveSpeed-generated image:
# 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
{
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
User: Post this sunset photo to Instagram with caption "Golden hour 🌅"
Agent: node {baseDir}/scripts/post.js --image /tmp/sunset.jpg --caption "Golden hour 🌅"