Instagram is a key platform for brands and creators, but its API is significantly more restricted than its visual simplicity suggests. Connecting OpenClaw to Instagram requires navigating Meta's App Review process and working within tight data access boundaries.
How OpenClaw Integrations Work
OpenClaw is a self-hosted AI assistant that runs on your own server — typically an EC2 instance — and connects to Slack. It uses Claude under the hood to process requests. Out of the box, OpenClaw doesn't ship with pre-built connections to third-party tools. Instead, integrations are built using the skills system: markdown files in ~/.openclaw/skills/ that give Claude instructions for a particular domain, combined with HTTP tool calls to any API you expose to it.
In practice, adding a real integration means: getting API credentials from the third-party service, building or configuring a small proxy/endpoint that OpenClaw can call, and writing a skill file that tells Claude how to use it. For some tools this is an afternoon of work. For others — like Instagram — it's considerably more involved.
Connecting OpenClaw with Instagram: Step by Step
Step 1: Create a Meta App and Connect an Instagram Business Account
Go to developers.facebook.com and create a new app with Business as the type. Connect an Instagram Professional account (Business or Creator) linked to a Facebook Page. The Instagram Graph API only works with Professional accounts — personal Instagram accounts are not accessible via the API.
Step 2: Request the Required Permissions
For basic Instagram insights, you need the instagram_basic and instagram_manage_insights permissions. For content publishing, add instagram_content_publish. These permissions go through Meta App Review — submit your use case description and a screen recording demonstrating the feature.
Step 3: Build the Proxy and Skill File
The Instagram Graph API base URL is https://graph.instagram.com/v19.0/. Key endpoints: /{ig-user-id}/media (list posts), /{ig-media-id}/insights (per-post engagement metrics), /{ig-user-id}/insights (account-level metrics — reach, impressions, profile views). Write ~/.openclaw/skills/instagram.md documenting what metrics are available and at what granularity.
Challenges and Caveats
Only Professional Accounts Are Supported
The Instagram Graph API does not work with personal accounts. Your account must be a Business or Creator account, and it must be connected to a Facebook Page. If you're managing a personal brand account that hasn't been converted, you'll need to do that first.
Competitor and Hashtag Data Is No Longer Available
Earlier versions of the Instagram API allowed querying hashtag activity and competitor account data. Those endpoints have been removed. Today, the API only gives you data about your own accounts — there's no way to query other users' posts or follower counts.
App Review Can Take Weeks
Meta's App Review process for Instagram permissions is unpredictable — reviews can take days or weeks, and applications can be rejected if the use case isn't clearly articulated. Plan for this delay in your project timeline.
Skip All of This — Use Cody Instead
Cody has Instagram integration built in. Get post performance and account insights in Slack without App Review or Facebook Page linking.
Related Guides
- Connecting OpenClaw with Twitter X: A Practical Guide
- Connecting OpenClaw with Linkedin: A Practical Guide
- Connecting OpenClaw with Facebook Ads: A Practical Guide
Need the model-flexible version? See: How to Connect Instagram to OpenClaw: Setup, Models, and Workflow Guide.