Instagram Auto-Poster AI Agent

What this agent does

Manually posting to Instagram every day is the single biggest reason content calendars fall apart — the caption is ready, the image is ready, and it still doesn't go out because nobody was at their desk at 9am. This agent closes that gap: it watches a folder (or a Notion/Sheets queue) of approved posts, and at the scheduled time it posts the image and caption to Instagram automatically, then logs the result.

1. stage-1-queue-check — reads your queue (a local folder of image + caption pairs, or a row in a tracked Sheet/Notion database marked "Ready"), and picks the next unposted item in order.
2. stage-2-publish — publishes the image and caption via the Instagram Graph API (Business/Creator account required), then writes the resulting post URL and timestamp back to the queue so nothing gets posted twice.

Every run appends a row to a local posting log — what was posted, when, and the resulting permalink — so you always have an audit trail without opening Instagram.

Requirements

• An Instagram Business or Creator account connected to a Facebook Page (required by Meta for any automated posting — personal accounts cannot use the Graph API).
• A Meta developer app with instagram_content_publish permission and a long-lived access token.
• Works on OpenClaw (scheduled via the Gateway's cron) and on Zo Computer (scheduled task). Claude AI alone cannot post directly — it needs one of these two runtimes to hold the scheduled trigger and the API token.

Setup

1. Unzip the package into your workspace, keeping the folder structure intact.
2. Create your Meta app, generate a long-lived Page access token, and store it in your local credentials configuration (never commit this — it's gitignored by default).
3. Point the queue configuration at your queue: a local folder path, or a Notion/Sheets database ID.
4. Run the starter prompt once to do a single manual post and confirm the token works end to end.
5. Schedule it to run on your posting cadence (once or twice daily is typical — Instagram rate-limits aggressive posting frequencies).

What you get

• Approved posts published to Instagram automatically at your scheduled time, no manual button-pressing
• A queue that tracks what's already been posted, so nothing goes out twice
• The resulting post URL and timestamp written back automatically for reference
• A full posting log with timestamp, caption excerpt, and permalink for every post — an audit trail without opening Instagram
• Setup that works on OpenClaw or Zo Computer, holding the scheduled trigger and API token for you