Post to Instagram from NanoClaw

NanoClaw can publish and schedule Instagram feed posts, stories, and reels through Postiz. Send NanoClaw a photo or video from WhatsApp, Telegram, Slack, or Discord with a caption and a time, and it uploads the media through Postiz, sets the post type and collaborators, and schedules it on your connected Instagram account.

Setup Guide GitHub

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

Last updated: September 2026

How do I set up NanoClaw to post to Instagram?

Setup, then just ask

# 1. Install NanoClaw (once)
git clone https://github.com/nanocoai/nanoclaw.git
cd NanoClaw && bash nanoclaw.sh

# 2. Add the Postiz skill to your NanoClaw fork
npx skills add gitroomhq/postiz-agent

# 3. Authenticate Postiz (OAuth device flow)
postiz auth:login   # or: export POSTIZ_API_KEY=...

# 4. Connect Instagram in Postiz, then message NanoClaw:
> Post the product photo to Instagram
  with a caption, tomorrow at 6pm

NanoClaw: Done! Your Instagram post is scheduled.

Which Instagram features does NanoClaw support?

📷

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 do I post to Instagram from NanoClaw?

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

Find Your Instagram Integration

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

Example conversation

> Is my Instagram account connected to Postiz?

NanoClaw: 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

NanoClaw: 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

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

Instagram Settings Reference

Mention any of these in plain language and NanoClaw 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 NanoClaw for any of these common Instagram scenarios and it applies the matching settings.

Simple Feed Post

Just ask

> Post it with: Simple Feed Post

NanoClaw: Got it. Applying:
  post_type: post

Story Post

Just ask

> Post it with: Story Post

NanoClaw: Got it. Applying:
  post_type: story

Trial Reel with Auto Graduation

Just ask

> Post it with: Trial Reel with Auto Graduation

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

Collaborator Post

Just ask

> Post it with: Collaborator Post

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

What is NanoClaw?

NanoClaw is an open-source AI assistant that runs each agent in its own Docker container and is built on Anthropic's Claude Agent SDK. It was created as a smaller, easier-to-audit alternative to OpenClaw. It connects to WhatsApp, Telegram, Slack, Discord, Microsoft Teams, iMessage, and more, and supports per-group memory and recurring jobs.

📦

Container-Based

NanoClaw runs in containers for easy deployment and isolation. Spin up your social media automation agent in seconds with Docker.

💬

Multi-Platform Chat

Connect to WhatsApp, Telegram, Slack, Discord, Microsoft Teams, and more. Message NanoClaw from wherever you already communicate.

🧠

Memory & Context

NanoClaw remembers your preferences and past interactions. It learns your posting style and content strategy over time.

How Postiz Works with NanoClaw

NanoClaw discovers Postiz through its skill system. Add the Postiz skill to your NanoClaw fork and the agent reads the SKILL.md to learn every postiz command, then runs them inside its own container when you ask.

✓Install Postiz skill with npx skills add gitroomhq/postiz-agent
✓NanoClaw reads the SKILL.md and learns all Postiz commands
✓Authenticate with postiz auth:login (OAuth device flow) or a POSTIZ_API_KEY
✓Skills are loaded on-demand, keeping the agent context clean
✓Built on Anthropic's Claude Agent SDK, running in an isolated Docker container

Install Postiz

# In your NanoClaw fork: add the Postiz skill
npx skills add gitroomhq/postiz-agent

# Sign in to Postiz (OAuth device flow)
postiz auth:login

# Or use an API key instead
export POSTIZ_API_KEY=your_api_key

# Check the connection
postiz auth:status
postiz integrations:list

Instagram Posting with NanoClaw

Message NanoClaw from WhatsApp, Telegram, or Slack — it discovers your integrations via Postiz, composes your content, and handles the entire posting workflow from within its container.

🐳

From Any Chat App

WhatsApp, Telegram, Slack, or Discord

Send a message to NanoClaw from your favorite chat app. It runs as a background service in an isolated container, 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.

NanoClaw

You: Post to Instagram about our new
  feature launch, schedule for tomorrow
  at 9am

NanoClaw: On it! Here's my plan:
  1. Found your Instagram integration
  2. Composing your post
  3. Scheduling for tomorrow 9:00 AM

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

🐳

Scheduled & Proactive

Recurring jobs, requested in chat

NanoClaw supports recurring jobs you request in chat. Set up a recurring job that checks a folder for new photos and posts them to Instagram automatically — no manual trigger needed.

Recurring job (ask in chat)

> @Andy every weekday at 9am, check
  ~/content/posts for new files and
  schedule each one to Instagram for
  noon. Move posted files to
  ~/content/published.

NanoClaw: Got it. I'll run this every
  weekday at 9:00 AM and schedule the
  posts through Postiz.

Why NanoClaw + Postiz for Instagram

NanoClaw makes Postiz a natural fit for your Instagram workflow. The agent discovers all available commands and autonomously chains them together.

✓Message from WhatsApp or Telegram to post to Instagram — no terminal needed
✓Container-based — easy to deploy, isolate, and scale
✓Built-in memory remembers your content preferences
✓Scheduled jobs for hands-free daily posting
✓Cross-post to Instagram + other platforms in a single conversation
✓Built on Anthropic's Claude Agent SDK, with each agent group in its own container

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including Instagram
metadata:
  NanoClaw:
    requirements:
      env:
        - POSTIZ_API_KEY
      binaries:
        - postiz
---

# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

# Instagram Settings
post_type, is_trial_reel,
graduation_strategy,
collaborators

Does Postiz work with other agents too?

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.

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.

Can NanoClaw post to Instagram and other platforms at once?

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

NanoClaw: 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 I ask NanoClaw to post on Instagram?

You can ask NanoClaw for anything Postiz supports on Instagram: a single post, a scheduled batch, or a recurring job. These are prompts you would type in WhatsApp, Telegram, Slack, or Discord. @Andy is NanoClaw's default trigger word; use whatever name you gave your agent.

Feed post with caption

Say to NanoClaw

> @Andy post this photo to Instagram tomorrow at 6pm with a caption about the new office and three relevant hashtags

NanoClaw: Uploads the image, writes the caption, sets post_type to post, schedules for 6:00 PM.

Story

Say to NanoClaw

> @Andy share the event poster as an Instagram story at 10am on Friday

NanoClaw: Sets post_type to story and schedules the media for Friday 10:00 AM.

Collab reel

Say to NanoClaw

> @Andy post the demo video to Instagram as a trial reel with @partnerbrand as collaborator, graduate it manually

NanoClaw: Sets is_trial_reel true, graduation_strategy MANUAL, collaborators [{label: "partnerbrand"}].

What should I know before posting to Instagram from NanoClaw?

Instagram has a few rules that Postiz enforces at publish time. NanoClaw applies them when you mention them in plain language, and asks when a required value is missing.

✓Instagram does not accept text-only posts. Every post NanoClaw creates needs at least one image or video; send it in chat or reference a file in the container workspace.
✓post_type is required and must be post (feed) or story. Stories disappear after 24 hours and do not carry a visible caption, so keep the message on the image itself.
✓Two account types exist in Postiz: instagram (via a Facebook Page) and instagram-standalone (Instagram Login). Both work; NanoClaw picks the one you connected.
✓Collaborators are passed as usernames without the @ sign, for example [{"label":"username"}]. The other account has to accept the invite before it appears on their profile.

Frequently asked questions about NanoClaw and Instagram

How do I post to Instagram from NanoClaw?

Install the Postiz skill in NanoClaw with npx skills add gitroomhq/postiz-agent, run postiz auth:login, and connect Instagram in Postiz. Then send NanoClaw a photo or video in chat with the caption and time you want. It uploads the media through Postiz, sets post_type, and schedules the post.

Can NanoClaw post Instagram stories and reels?

Yes. Say "as a story" and NanoClaw sets post_type to story. Videos posted to the feed are published as reels, and you can ask for a trial reel with is_trial_reel and a graduation_strategy of MANUAL or SS_PERFORMANCE. Feed posts, stories, and reels all go through the same Postiz channel.

Can NanoClaw post to Instagram without an image?

No. Instagram requires media on every post, so a text-only request will fail at publish time. NanoClaw should ask you for an image or video before scheduling. If you want text-heavy content, ask it to generate a simple image with the text or to post the message to X or Threads instead.

Can NanoClaw tag collaborators on Instagram posts?

Yes. Mention the collaborator account and NanoClaw passes it in the collaborators array as a username label. Instagram sends the other account a collab invite; once they accept, the post appears on both profiles and shares likes and comments. Collaborators work on feed posts and reels.

Does NanoClaw need my Instagram password?

No. Instagram is connected to Postiz once with OAuth, either through a Facebook Page or the standalone Instagram login. NanoClaw only authenticates to Postiz with postiz auth:login or a POSTIZ_API_KEY. Your Instagram password and tokens stay inside Postiz, never inside the NanoClaw container or your chat history.

Post to other platforms from NanoClaw

The same Postiz skill covers 30+ channels. Start from the NanoClaw social media automation guide or jump to a platform that pairs well with Instagram.

TikTok from NanoClaw→Facebook from NanoClaw→Pinterest from NanoClaw→YouTube from NanoClaw→X (Twitter) from NanoClaw→

All NanoClaw guides Instagram scheduling on Postiz Instagram with OpenClaw Instagram with Claude Code Postiz for any AI agent Postiz MCP server Pricing

Start posting to Instagram

Install Postiz Agent and automate your Instagram content strategy with AI-powered scheduling and publishing.

Get Started