NewGenerate AI UGC videos with your AI agent using agent-media

Post to Instagram from OpenClaw

OpenClaw can schedule Instagram feed posts, stories, and reels through the Postiz skill. You send OpenClaw an image or video from WhatsApp or Telegram with a caption, and it calls the Postiz CLI to upload the media, choose the post type, tag collaborators, and schedule the publish time.

Setup Guide ClawHub

Please make sure there is always a human in the loop.

Last updated: September 2026

How do you set up OpenClaw to post to Instagram?

Setup takes three commands: install the Postiz skill, sign in, and confirm OpenClaw lists it as eligible. After that you talk to OpenClaw in plain language and it runs the Postiz CLI for Instagram.

Setup once, then just ask

# Install the Postiz skill (ClawHub or the skills CLI)
openclaw skills install @nevo-david/postiz
# or: npx skills add gitroomhq/postiz-agent

# Sign in (OAuth2 device flow) or use an API key
postiz auth:login
# or: export POSTIZ_API_KEY=your_api_key

# Confirm OpenClaw can see the skill
openclaw skills list --eligible

# Then just ask OpenClaw from any chat app:
> Post this photo to Instagram as a feed post
  with the caption below, tomorrow at 6pm

OpenClaw: Done! Your Instagram post is scheduled for 6:00 PM.

Instagram-Specific Features

📷

Feed Posts

Publish photo and video posts to your Instagram feed with captions, hashtags, and location tags. Schedule for optimal engagement times.

📱

Stories

Share ephemeral content with Instagram Stories. Upload images or videos that disappear after 24 hours.

🎬

Trial Reels

Test content with trial reels that have limited initial reach. Graduate to full distribution manually or automatically based on performance.

🤝

Collaborator Tags

Tag collaborators on your posts to co-author content. The post appears on both profiles, doubling your reach.

📊

Graduation Strategy

Control how trial reels graduate to full reach. Choose MANUAL for hands-on control or SS_PERFORMANCE for automatic promotion.

📅

Scheduled Posting

Schedule posts and stories with precise timestamps. Plan your Instagram content calendar and let Postiz handle the publishing.

How does posting to Instagram from OpenClaw work?

You describe what you want in plain language and OpenClaw handles the Postiz calls for you. Here is how a typical conversation goes.

Find Your Instagram Integration

Ask OpenClaw whether your Instagram account is connected. It also checks which options the platform supports.

Example conversation

> Is my Instagram account connected to Postiz?

OpenClaw: Yes — your Instagram account is connected
  and ready. Want me to post something?

Upload Your Media

Upload your photo or video to get a public URL. Instagram requires media to be accessible via HTTPS. Supports JPG, PNG, MP4, and more.

Example conversation

> Draft a Instagram post about our new
  feature launch

OpenClaw: Here's a draft for Instagram:
  "We just shipped something big..."
  Want me to add media and schedule it?

Create Your Post

Schedule an Instagram post with your media, caption, hashtags, and platform-specific settings like post type, trial reels, and collaborators.

Example conversation

> Yes — add screenshot.png and schedule
  it for tomorrow at 9am

OpenClaw: Done! Scheduled on Instagram for
  tomorrow at 9:00 AM.

Instagram Settings Reference

Mention any of these in plain language and OpenClaw sets them for you. These are the Instagram options it can apply to any post.

Field	Type	Required	Description
`__type`	string	Yes	Must be "instagram" or "instagram-standalone"
`post_type`	string	Yes	Content type: "post" (feed) or "story"
`is_trial_reel`	boolean	No	Post as a trial reel with limited initial reach
`graduation_strategy`	string	No	Trial reel graduation: "MANUAL" or "SS_PERFORMANCE" (auto based on performance)
`collaborators`	array	No	List of collaborator objects, e.g. [{"label":"username"}]

Common Configurations

Ask OpenClaw for any of these common Instagram posting scenarios and it applies the matching settings.

Simple Feed Post

Just ask

> Post it with: Simple Feed Post

OpenClaw: Got it. Applying:
  post_type: post

Story Post

Just ask

> Post it with: Story Post

OpenClaw: Got it. Applying:
  post_type: story

Trial Reel with Auto Graduation

Just ask

> Post it with: Trial Reel with Auto Graduation

OpenClaw: Got it. Applying:
  post_type: post
  is_trial_reel: yes
  graduation_strategy: SS_PERFORMANCE

Collaborator Post

Just ask

> Post it with: Collaborator Post

OpenClaw: Got it. Applying:
  post_type: post
  collaborators: cofounder, designer_jane

What is OpenClaw?

OpenClaw is the open-source personal AI agent with 145k+ GitHub stars. It runs locally on your machine, connects through apps you already use, and takes real actions on your behalf.

💬

Works Where You Are

Message OpenClaw from WhatsApp, Telegram, Slack, Discord, Signal, iMessage, or 10+ other platforms. No new app to learn.

🧩

Skill-Based Architecture

OpenClaw extends its abilities through Skills — lightweight plugins defined in Markdown files. Postiz is available as a skill on ClawHub.

⏰

Proactive Automation

Schedule recurring tasks with cron jobs. OpenClaw can post your Instagram content on a schedule without you having to ask each time.

How Postiz Becomes an OpenClaw Skill

When you install Postiz Agent globally, OpenClaw automatically discovers it by reading the bundled SKILL.md file. This file tells OpenClaw what commands are available, what environment variables are needed, and how to compose Instagram posts with the right settings.

✓Install from ClawHub with one command: openclaw skills install @nevo-david/postiz
✓OpenClaw reads the SKILL.md and learns all Postiz commands
✓Run openclaw skills check to confirm the postiz binary and credentials are in place
✓Skills are loaded on-demand, keeping the agent context clean
✓Works with any LLM backend: Claude, GPT, Gemini, Llama, and more

Install from ClawHub

# Install the Postiz skill from ClawHub
openclaw skills install @nevo-david/postiz

# Or with the skills CLI
npx skills add gitroomhq/postiz-agent

# Sign in with OAuth2 (or set POSTIZ_API_KEY)
postiz auth:login

# Verify OpenClaw sees it
openclaw skills list --eligible
openclaw skills check

Instagram Posting with OpenClaw

Message OpenClaw from any platform — it reads the Postiz skill, discovers your Instagram integration, and handles the entire posting workflow autonomously.

🦀

From Any Chat App

WhatsApp, Telegram, Slack, Discord...

Send a message to OpenClaw from your favorite chat app. It runs as a persistent daemon on your machine, so it picks up your message, discovers your Instagram account via Postiz, uploads the photo, and schedules the post — all while you go about your day.

WhatsApp / Telegram

You: Post my sunset.jpg to Instagram
  as a feed post, schedule for tomorrow
  at 6pm, tag @photographer_friend

OpenClaw: Got it! Here's what I'll do:
  1. Upload sunset.jpg to Postiz
  2. Schedule for 2025-03-02T18:00:00Z
  3. Settings: feed post, collaborator
     tagged

  Done! Your Instagram post is scheduled.
  Post ID: abc-123

🦀

Scheduled & Proactive

openclaw automations for recurring content

OpenClaw automations run on cron expressions in an isolated session and can announce results to a chat channel. Create one that drafts and schedules your Instagram content through Postiz, so nothing waits on a manual trigger.

openclaw automations (cron)

openclaw automations create "0 9 * * 1-5" \
  "Take the next image in ~/content/instagram, write a caption with three hashtags, and schedule an Instagram feed post for 6pm." \
  --name "Instagram daily post" \
  --session isolated \
  --announce --channel telegram \
  --to "<your chat id>"

# openclaw cron is an alias for the same command

Why OpenClaw + Postiz for Instagram

OpenClaw's skill system makes Postiz a natural fit. The agent reads the SKILL.md to understand every available command, then autonomously chains them together for Instagram workflows.

✓Message from WhatsApp to post on Instagram — no terminal needed
✓Cron jobs for hands-free daily posting schedules
✓Structured JSON output lets OpenClaw verify each step succeeded
✓Trial reels and graduation strategies applied automatically
✓Cross-post to Instagram + other platforms in a single conversation
✓Model-agnostic — works with Claude, GPT, Gemini, or open-source LLMs

SKILL.md (auto-discovered)

---
name: postiz
description: Postiz is a tool to schedule
  social media and chat posts to 28+
  channels ...
homepage: https://docs.postiz.com/public-api/introduction
metadata: {"openclaw":{"emoji":"🌎",
  "requires":{"bins":[],"env":["POSTIZ_API_URL"]}}}
---

# Essential Commands
- postiz auth:login
- postiz integrations:list
- postiz integrations:settings <id>
- postiz integrations:trigger
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

# Instagram settings
post_type, is_trial_reel, graduation_strategy, collaborators

Also Works with Claude Code

Postiz works with any AI agent that can run commands or call MCP tools — you ask, the agent does the work. That includes Anthropic's Claude Code, which has its own guide for posting to Instagram from Claude Code.

Claude Code

by Anthropic

Claude reads the Postiz skill so it knows what it can do, then autonomously discovers your Instagram integration, uploads your photo, applies post type and collaborator settings, and schedules the post.

Claude Code

> Post my product photo to Instagram
  as a feed post with collaborator tags,
  schedule for tomorrow evening

Claude: Done! Scheduled on Instagram for
  tomorrow at 9:00 AM.

Instagram + Other Platforms

Schedule the same content to Instagram and other platforms in a single request. Each platform gets its own settings.

Example

> Post "Excited to announce our new feature!" to
  Instagram and LinkedIn tomorrow at 9am, then schedule
  a daily tip on Instagram every weekday at 10am

OpenClaw: Done! Scheduled:
  - Instagram + LinkedIn: tomorrow 9:00 AM
  - Daily tips on Instagram: Mon-Fri 10:00 AM

Post Types

Feed Post

post

Story

story

What can you ask OpenClaw to do on Instagram?

These are real messages you can send OpenClaw from WhatsApp, Telegram, Slack, or Discord. OpenClaw maps each one to the right Postiz command and Instagram settings.

Feed post with caption

Send to OpenClaw

> Post this photo to Instagram at 6pm with a two-line caption about the new studio and five relevant hashtags.

Story

Send to OpenClaw

> Share this vertical video to my Instagram story right now.

Collaborator reel

Send to OpenClaw

> Schedule this reel for Friday at noon and add @partnerbrand as a collaborator.

Instagram rules OpenClaw has to follow

Postiz enforces these Instagram constraints when OpenClaw creates a post. Knowing them up front avoids a failed request.

✓Instagram requires media. OpenClaw cannot publish a text-only post, so always send an image or video with your request.
✓post_type is required and must be post or story. Say "story" explicitly when you want one, otherwise OpenClaw schedules a feed post.
✓Captions are limited to 2,200 characters and Instagram allows up to 30 hashtags. Ask OpenClaw to keep the caption tight.
✓Collaborators are passed as usernames. The tagged account must accept the invite before it appears on their profile.

OpenClaw and Instagram: frequently asked questions

How do I post to Instagram from OpenClaw?

Install the Postiz skill in OpenClaw, run postiz auth:login, and connect your Instagram business or creator account in Postiz. Then send OpenClaw a photo or video with a caption and time. It uploads the file through Postiz and schedules the feed post or story.

Can OpenClaw post Instagram stories?

Yes. Instagram exposes a post_type setting through Postiz with two values, post and story. When you tell OpenClaw to "post this as a story", it sets post_type to story and Postiz publishes the media to your story instead of the feed.

Can OpenClaw schedule Instagram reels with collaborators?

Yes. Send a vertical video and name the collaborator account. OpenClaw passes the username in the collaborators setting, and Postiz sends the collaboration invite when the reel publishes. Trial reels are also supported through the is_trial_reel setting. Say the username exactly as it appears on Instagram.

Does OpenClaw need the Instagram Graph API?

No. OpenClaw runs the Postiz CLI and Postiz holds the Instagram connection, either through a Facebook business account or the standalone Instagram login. You never register a Meta developer app for OpenClaw. Authentication is postiz auth:login or a Postiz API key.

Can OpenClaw post to Instagram and TikTok at once?

Yes. Ask for both platforms in one message. OpenClaw creates a single Postiz post with two channels, applies Instagram settings such as post_type and TikTok settings such as privacy_level, and schedules both for the same time. Each channel keeps its own caption if you want them to differ.