{"id":"18524702-06b6-448c-ae8f-b9a14121fb73","entityType":"agent","slug":"clawhub-hith3sh-instagram-posts","name":"Instagram","canonicalUrl":"https://www.xpersona.co/agent/clawhub-hith3sh-instagram-posts","canonicalPath":"/agent/clawhub-hith3sh-instagram-posts","generatedAt":"2026-10-09T12:54:56.448Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T02:49:21.083Z","emptyReason":null},"description":"Manage Instagram Business and Creator accounts via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send DMs, and manage story content. Use this skill when users want to manage Instagram content, analyze engagement, or automate social media workflows. Skill: Instagram Owner: hith3sh Summary: Manage Instagram Business and Creator accounts via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send DMs, and manage story content. Use this skill when users want to manage Instagram content, analyze engagement, or automate social media workflows. Tags: latest:1.0.7 Version history: v1.0.7 | 2026-10-03T19:40:26.934Z | us","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 7.8K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s173vws87a7ss71xf9rq53k5gd8568kv:instagram-posts","sourceUrl":"https://clawhub.ai/hith3sh/instagram-posts","homepage":"https://clawhub.ai/hith3sh/skills/instagram-posts","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/hith3sh/instagram-posts","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/hith3sh/skills/instagram-posts","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":78,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Manage Instagram Business and Creator accounts via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send DM"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T02:49:21.083Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T02:49:21.083Z","emptyReason":null},"stars":null,"forks":null,"downloads":7767,"packageName":null,"latestVersion":"1.0.7","tractionLabel":"7.8K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T02:49:21.083Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T02:49:21.083Z","lastCrawledAt":"2026-10-09T02:49:21.083Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T02:49:21.083Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.7","createdAt":"2026-10-03T19:40:26.934Z","changelog":"Security section now states that the public-data tools read other people's public content without a connected account (read-only, paid from credit).","fileCount":3,"zipByteSize":6774},{"version":"1.0.6","createdAt":"2026-10-03T19:35:03.314Z","changelog":"New: read any public Instagram profile or post with no account to connect. Fixed images (they were broken).","fileCount":3,"zipByteSize":6799},{"version":"1.0.5","createdAt":"2026-06-09T07:11:51.278Z","changelog":"Add UTM attribution tags (utm_source=clawhub) to ClawLink branding links so visits from this skill page are tracked as a distinct traffic source.","fileCount":3,"zipByteSize":6492},{"version":"1.0.4","createdAt":"2026-06-09T04:57:05.827Z","changelog":"- Removed the file skill-card.md from the repository. - No functional or user-facing changes to the Instagram integration or documentation.","fileCount":3,"zipByteSize":6462},{"version":"1.0.1","createdAt":"2026-06-08T16:38:29.907Z","changelog":"instagram-posts 1.0.1 - Improved documentation in SKILL.md for better clarity, including the addition of an Instagram logo image. - Updated setup instructions and quick start examples in SKILL.md. - Removed skill-card.md file.","fileCount":3,"zipByteSize":6385},{"version":"0.1.1","createdAt":"2026-06-07T13:31:56.653Z","changelog":"Full rewrite to new standard: added tool reference tables, 3-step GIF table, architecture diagram, code examples, error handling, and troubleshooting.","fileCount":3,"zipByteSize":6384},{"version":"0.1.0","createdAt":"2026-05-03T15:31:57.685Z","changelog":"- Initial release of the instagram-posts skill, enabling Instagram content publishing, comment management, insights, and messaging via ClawLink. - Integrates with ClawLink to handle authentication, device pairing, and Instagram account connection securely—no manual API setup required. - Comprehensive setup documentation for installing the ClawLink plugin, pairing accounts, and connecting Instagram. - Provides dynamic discovery and execution of available Instagram tools based on user’s connected accounts and permissions. - Enforces strict rules for user security, confirmation before sensitive actions, and accurate capability reporting.","fileCount":3,"zipByteSize":3495}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s173vws87a7ss71xf9rq53k5gd8568kv:instagram-posts","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-instagram-posts/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-instagram-posts/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-instagram-posts/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-instagram-posts/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-instagram-posts/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-instagram-posts/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T12:54:56.444Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-instagram-posts/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-instagram-posts/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-instagram-posts/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-instagram-posts/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-09T02:49:21.083Z","emptyReason":null},"readme":"Skill: Instagram\n\nOwner: hith3sh\n\nSummary: Manage Instagram Business and Creator accounts via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send DMs, and manage story content. Use this skill when users want to manage Instagram content, analyze engagement, or automate social media workflows.\n\nTags: latest:1.0.7\n\nVersion history:\n\nv1.0.7 | 2026-10-03T19:40:26.934Z | user\n\nSecurity section now states that the public-data tools read other people's public content without a connected account (read-only, paid from credit).\n\nv1.0.6 | 2026-10-03T19:35:03.314Z | user\n\nNew: read any public Instagram profile or post with no account to connect. Fixed images (they were broken).\n\nv1.0.5 | 2026-06-09T07:11:51.278Z | user\n\nAdd UTM attribution tags (utm_source=clawhub) to ClawLink branding links so visits from this skill page are tracked as a distinct traffic source.\n\nv1.0.4 | 2026-06-09T04:57:05.827Z | auto\n\n- Removed the file skill-card.md from the repository.\n- No functional or user-facing changes to the Instagram integration or documentation.\n\nv1.0.1 | 2026-06-08T16:38:29.907Z | auto\n\ninstagram-posts 1.0.1\n\n- Improved documentation in SKILL.md for better clarity, including the addition of an Instagram logo image.\n- Updated setup instructions and quick start examples in SKILL.md.\n- Removed skill-card.md file.\n\nv0.1.1 | 2026-06-07T13:31:56.653Z | user\n\nFull rewrite to new standard: added tool reference tables, 3-step GIF table, architecture diagram, code examples, error handling, and troubleshooting.\n\nv0.1.0 | 2026-05-03T15:31:57.685Z | auto\n\n- Initial release of the instagram-posts skill, enabling Instagram content publishing, comment management, insights, and messaging via ClawLink.\n- Integrates with ClawLink to handle authentication, device pairing, and Instagram account connection securely—no manual API setup required.\n- Comprehensive setup documentation for installing the ClawLink plugin, pairing accounts, and connecting Instagram.\n- Provides dynamic discovery and execution of available Instagram tools based on user’s connected accounts and permissions.\n- Enforces strict rules for user security, confirmation before sensitive actions, and accurate capability reporting.\n\nArchive index:\n\nArchive v1.0.7: 3 files, 6774 bytes\n\nFiles: skill-card.md (2215b), SKILL.md (17557b), _meta.json (134b)\n\nFile v1.0.7:SKILL.md\n\n---\nname: instagram-posts\ndescription: Manage Instagram Business and Creator accounts via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send DMs, and manage story content. Use this skill when users want to manage Instagram content, analyze engagement, or automate social media workflows.\n---\n\n# Instagram\n\n\n\nManage an Instagram Business or Creator account via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send direct messages, and monitor story content.\n\nThis skill uses [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=instagram-posts) for hosted connection flows and credentials so you do not need to configure Instagram API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Instagram |\n|:---:|:---:|:---:|\n|  |  | *Connect Instagram from the ClawLink dashboard* |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Instagram |\n\n## No Account Needed: Public Instagram Data\n\nRead any public Instagram profile, post, reel or hashtag, see followers and comments, and get transcripts of reels, without connecting an Instagram account. These tools work as soon as the plugin is paired: there is nothing to connect, and each call is paid from ClawLink credit (most cost a fraction of a cent; new accounts get $0.50 free).\n\n| Tool | What it returns | Price |\n|------|-----------------|-------|\n| `instagramdata_user_profile` | Public Instagram profile by username: follower, following and post counts, bio, category, verified flag | $0.00282 |\n| `instagramdata_user_posts` | Recent public posts of an Instagram account with likes, comments and captions | $0.00282 |\n| `instagramdata_user_reels` | Recent public reels of an Instagram account with play counts | $0.00282 |\n| `instagramdata_post_comments` | Comments on an Instagram post or reel | $0.003 |\n| `instagramdata_hashtag_posts` | Public posts under an Instagram hashtag | $0.00282 |\n| `instagramdata_transcript` | Spoken-word transcript of an Instagram reel or video post | $0.00282 |\n\nUse the connected-account tools above for the user's own Instagram; use these for anyone else's public content. More: [Creator Scout](https://clawhub.ai/hith3sh/skills/creator-scout), [Transcribe Any Video](https://clawhub.ai/hith3sh/skills/transcribe-any-video).\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Instagram Graph │\n│ (User Chat) │ │ (OAuth) │ │ (API v22) │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect IG │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Instagram│\n │ File │ │ Auth │ │ Business │\n └──────────┘ └──────────┘ └──────────┘\n```\n\n## Install\n\nInstall the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.\n\n```bash\nopenclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart\n```\n\nThen tell the user: \"OpenClaw has been restarted. Send `/new` as a standalone message to start a fresh chat, then ask for Instagram again.\"\n\n## Quick Start\n\n```bash\n# Get your Instagram account info\nclawlink_call_tool --tool \"instagram_get_user_info\" --params '{}'\n\n# List recent media posts\nclawlink_call_tool --tool \"instagram_get_ig_user_media\" --params '{}'\n\n# Get insights on a specific post\nclawlink_call_tool --tool \"instagram_get_ig_media_insights\" --params '{\"media_id\": \"MEDIA_ID\"}'\n```\n\n## Authentication\n\nAll Instagram tool calls are authenticated automatically by ClawLink using the user's connected Instagram Business or Creator account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every Instagram Graph API request on the user's behalf.\n\n### Getting Connected\n\n1. Install the ClawLink plugin (see Install above).\n2. Pair the plugin with `clawlink_begin_pairing` if it is not configured yet.\n3. Open https://claw-link.dev/dashboard?add=instagram and connect Instagram (requires a Business or Creator account).\n4. Call `clawlink_list_integrations` to verify the connection is active.\n\n## Connection Management\n\n### List Connections\n\n```bash\nclawlink_list_integrations\n```\n\n**Response:** Returns all connected integrations. Look for `instagram` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration instagram\n```\n\n**Response:** Returns the live tool catalog for Instagram.\n\n### Reconnect\n\nIf Instagram tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=instagram\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration instagram`\n\n## Security & Permissions\n\n- Connected-account tools are scoped to the connected Instagram Business or Creator account.\n- The public-data tools under \"No Account Needed\" read other people's public Instagram content (profiles, posts, comments) without any connected account. They are read-only, never post or change anything, and each call is paid from the user's ClawLink credit.\n- A Business or Creator account is required — personal Instagram accounts are not supported by the Instagram Graph API.\n- **All write operations require explicit user confirmation.** Before executing any publish, comment, or DM action, confirm the target resource and intended effect with the user.\n- Destructive actions (delete comment, delete message) are marked as high-impact and must be confirmed.\n- Content publishing is rate-limited by Instagram (25 posts per 24-hour window per account).\n\n## Tool Reference\n\n### Media Retrieval & Publishing\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_user_media` | List all media (posts, photos, videos, reels, carousels) published by the account | Read |\n| `instagram_get_ig_media` | Get details for a specific published media item including engagement metrics | Read |\n| `instagram_get_ig_media_children` | Get individual media items from a carousel/album post | Read |\n| `instagram_post_ig_user_media` | Create a media container for publishing (first step of two-step publish) | Write |\n| `instagram_post_ig_user_media_publish` | Publish a media container to the account (auto-waits for processing) | Write |\n| `instagram_create_carousel_container` | Create a draft carousel post with 2–10 images/videos | Write |\n\n### Insights & Analytics\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_user_insights` | Get account-level insights (profile views, reach, follower count) | Read |\n| `instagram_get_ig_media_insights` | Get per-media performance metrics (views, likes, comments, saves, shares) | Read |\n| `instagram_get_user_info` | Get profile details and statistics for the Business/Creator account | Read |\n| `instagram_get_ig_user_content_publishing_limit` | Check remaining publish quota before posting | Read |\n\n### Comments & Replies\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_media_comments` | List comments on a specific post with cursor-based pagination | Read |\n| `instagram_get_ig_comment_replies` | Get replies to a specific comment | Read |\n| `instagram_post_ig_media_comments` | Post a comment on a media item (300 chars max, 4 hashtags, 1 URL) | Write |\n| `instagram_post_ig_comment_replies` | Reply to an existing comment (300 chars max) | Write |\n| `instagram_delete_comment` | Delete a comment (only comments your account created) | Write |\n\n### Stories & Live\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_user_stories` | List active stories within the 24-hour story window | Read |\n| `instagram_get_ig_user_live_media` | Get live media during an active broadcast | Read |\n\n### Conversations & Messaging\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_list_all_conversations` | List all Instagram DM conversations | Read |\n| `instagram_get_conversation` | Get details of a specific DM conversation | Read |\n| `instagram_list_all_messages` | List messages in a specific DM thread | Read |\n| `instagram_send_text_message` | Send a text DM (requires prior conversation thread) | Write |\n| `instagram_send_image` | Send an image via DM | Write |\n| `instagram_mark_seen` | Mark messages as read in a DM thread | Write |\n| `instagram_get_page_conversations` | Get conversations for the connected Page | Read |\n\n### Messaging Configuration\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_messenger_profile` | Get ice breakers and messaging settings | Read |\n| `instagram_update_messenger_profile` | Configure ice breakers for the Instagram inbox | Write |\n| `instagram_delete_messenger_profile` | Remove messaging configuration | Write |\n\n### Mentions & Tags\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_user_tags` | Get media where your account was tagged by others | Read |\n| `instagram_post_ig_user_mentions` | Reply to a mention of your account | Write |\n\n## Code Examples\n\n### Get account info and insights\n\n```bash\nclawlink_call_tool --tool \"instagram_get_user_info\" \\\n --params '{}'\n```\n\n### List recent posts with insights\n\n```bash\nclawlink_call_tool --tool \"instagram_get_ig_user_media\" \\\n --params '{}'\n```\n\n### Get insights for a specific post\n\n```bash\nclawlink_call_tool --tool \"instagram_get_ig_media_insights\" \\\n --params '{\"media_id\": \"MEDIA_ID\"}'\n```\n\n### Post a comment\n\n```bash\nclawlink_call_tool --tool \"instagram_post_ig_media_comments\" \\\n --params '{\"media_id\": \"MEDIA_ID\", \"text\": \"Great post! Thanks for sharing.\"}'\n```\n\n### Send a DM\n\n```bash\nclawlink_call_tool --tool \"instagram_send_text_message\" \\\n --params '{\"message\": \"Hi! Thanks for reaching out.\", \"conversation_id\": \"CONVERSATION_ID\"}'\n```\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Instagram is connected.\n2. Call `clawlink_list_tools --integration instagram` to see the live catalog.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `instagram`.\n5. If no Instagram tools appear, direct the user to https://claw-link.dev/dashboard?add=instagram.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ READ OPERATIONS (Safe) │\n│ list → get → search → describe → call │\n│ │\n│ Example: List media → Get insights → Show results │\n└─────────────────────────────────────────────────────────────┘\n │\n ▼\n┌─────────────────────────────────────────────────────────────┐\n│ WRITE OPERATIONS (Require Confirmation) │\n│ list → get → describe → preview → confirm → call │\n│ │\n│ Example: Preview comment → User approves → Execute │\n└─────────────────────────────────────────────────────────────┘\n```\n\n1. For unfamiliar tools, ambiguous requests, or any write action, call `clawlink_describe_tool` first.\n2. Use the returned guidance, schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups` to shape the call.\n3. Prefer read, list, search, and get operations before writes when that reduces ambiguity.\n4. For writes or anything marked as requiring confirmation, call `clawlink_preview_tool` first.\n5. Execute with `clawlink_call_tool`. Pass confirmation only after the preview matches the user's intent.\n6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## Notes\n\n- Only **Business** or **Creator** Instagram accounts are supported — personal accounts return permission errors.\n- Content publishing is limited to 25 API-published posts per 24-hour moving window per account.\n- Media container `creation_id`s expire in under 24 hours — publish promptly after creating a container.\n- Comments are limited to 300 characters, 4 hashtags, and 1 URL.\n- DMs can only be sent in existing conversation threads — new threads cannot be initiated via the API.\n- Insights data is only available for posts published within the last 2 years and requires at least 1,000 followers.\n- Instagram IDs in API responses use the format `1784140xxxxx` (not numeric strings).\n\n## Error Handling\n\n| Status / Error | Meaning |\n|----------------|---------|\n| Tool not found | The tool name does not exist in the current catalog. Verify with `clawlink_list_tools --integration instagram`. |\n| Missing connection | Instagram is not connected. Direct the user to https://claw-link.dev/dashboard?add=instagram. |\n| Permission error | The account is a personal Instagram profile, not a Business/Creator account. |\n| ` OAuthException` | Instagram OAuth token is invalid or expired. Reconnect Instagram. |\n| Rate limit exceeded | Publishing quota used. Wait or reduce publish frequency. |\n| Write rejected | User did not confirm a write action. Always confirm before executing writes. |\n\n### Troubleshooting: Tools Not Visible\n\n1. Check that the ClawLink plugin is installed:\n ```bash\n openclaw plugins list\n ```\n2. If the plugin is installed but tools are missing, tell the user to send `/new` as a standalone message to reload the catalog.\n3. If a fresh chat does not help, run:\n ```bash\n openclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\n openclaw gateway restart\n ```\n4. After restart, tell the user to send `/new` again and retry.\n\n### Troubleshooting: Permission Errors\n\n1. Confirm the Instagram account is a **Business** or **Creator** account, not personal.\n2. Verify the account is connected at https://claw-link.dev/dashboard?add=instagram.\n3. For messaging tools, ensure the Instagram account has the **Instagram Messaging** permission scope.\n\n## Resources\n\n- [Instagram Graph API Overview](https://developers.facebook.com/docs/instagram-api)\n- [Instagram Media Publishing API](https://developers.facebook.com/docs/instagram-api/reference/ig-media)\n- [Instagram Insights API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/insights)\n- [Instagram Messaging API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/conversations)\n- ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=instagram-posts\n- ClawLink Docs: https://docs.claw-link.dev/openclaw\n- ClawLink Verification: https://claw-link.dev/verify\n\n## Related Skills\n\n- [Creator Scout](https://clawhub.ai/hith3sh/skills/creator-scout)\n- [Transcribe Any Video](https://clawhub.ai/hith3sh/skills/transcribe-any-video)\n- [LinkedIn Social](https://clawhub.ai/hith3sh/linkedin-social) — For LinkedIn page and post management\n- [Twitter](https://clawhub.ai/hith3sh/twitter) — For Twitter/X post management and analytics\n- [Facebook Pages](https://clawhub.ai/hith3sh/facebook-pages) — For Facebook Page management\n\n---\n\n**Powered by [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=instagram-posts)** — an integration hub for OpenClaw\n\n\n\nFile v1.0.7:_meta.json\n\n{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"instagram-posts\",\n \"version\": \"1.0.7\",\n \"publishedAt\": 1791056426934\n}\n\nFile v1.0.7:skill-card.md\n\n## Description:\n\nManage Instagram Business and Creator accounts by publishing content, reviewing insights, moderating comments, and handling direct messages.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[hith3sh](https://clawhub.ai/user/hith3sh)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nSocial media managers and other external users can manage connected Instagram Business or Creator accounts, review engagement, and look up public Instagram content.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Publishing, messaging, comment deletion, and inbox configuration can change the connected account or contact other users.\n\nMitigation: Preview the intended action and confirm its target and effect with the user before executing any write.\n\nRisk: Public-content lookups incur charges against the user's ClawLink credit.\n\nMitigation: Disclose the credit cost before making public-data lookups.\n\n## Reference(s):\n\n- [Instagram skill on ClawHub](https://clawhub.ai/hith3sh/skills/instagram-posts)\n- [ClawLink OpenClaw documentation](https://docs.claw-link.dev/openclaw)\n- [Instagram Graph API overview](https://developers.facebook.com/docs/instagram-api)\n- [Instagram media publishing API](https://developers.facebook.com/docs/instagram-api/reference/ig-media)\n- [Instagram insights API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/insights)\n- [Instagram messaging API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/conversations)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Guidance, Shell commands]\n\n**Output Format:** [Markdown with inline shell commands and account data summaries]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Public-data lookups use ClawLink credit; account management requires a connected Business or Creator account.]\n\n## Skill Version(s):\n\n1.0.7 (source: ClawHub release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.6: 3 files, 6799 bytes\n\nFiles: skill-card.md (2384b), SKILL.md (17284b), _meta.json (134b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: instagram-posts\ndescription: Manage Instagram Business and Creator accounts via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send DMs, and manage story content. Use this skill when users want to manage Instagram content, analyze engagement, or automate social media workflows.\n---\n\n# Instagram\n\n\n\nManage an Instagram Business or Creator account via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send direct messages, and monitor story content.\n\nThis skill uses [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=instagram-posts) for hosted connection flows and credentials so you do not need to configure Instagram API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Instagram |\n|:---:|:---:|:---:|\n|  |  | *Connect Instagram from the ClawLink dashboard* |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Instagram |\n\n## No Account Needed: Public Instagram Data\n\nRead any public Instagram profile, post, reel or hashtag, see followers and comments, and get transcripts of reels, without connecting an Instagram account. These tools work as soon as the plugin is paired: there is nothing to connect, and each call is paid from ClawLink credit (most cost a fraction of a cent; new accounts get $0.50 free).\n\n| Tool | What it returns | Price |\n|------|-----------------|-------|\n| `instagramdata_user_profile` | Public Instagram profile by username: follower, following and post counts, bio, category, verified flag | $0.00282 |\n| `instagramdata_user_posts` | Recent public posts of an Instagram account with likes, comments and captions | $0.00282 |\n| `instagramdata_user_reels` | Recent public reels of an Instagram account with play counts | $0.00282 |\n| `instagramdata_post_comments` | Comments on an Instagram post or reel | $0.003 |\n| `instagramdata_hashtag_posts` | Public posts under an Instagram hashtag | $0.00282 |\n| `instagramdata_transcript` | Spoken-word transcript of an Instagram reel or video post | $0.00282 |\n\nUse the connected-account tools above for the user's own Instagram; use these for anyone else's public content. More: [Creator Scout](https://clawhub.ai/hith3sh/skills/creator-scout), [Transcribe Any Video](https://clawhub.ai/hith3sh/skills/transcribe-any-video).\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Instagram Graph │\n│ (User Chat) │ │ (OAuth) │ │ (API v22) │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect IG │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Instagram│\n │ File │ │ Auth │ │ Business │\n └──────────┘ └──────────┘ └──────────┘\n```\n\n## Install\n\nInstall the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.\n\n```bash\nopenclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart\n```\n\nThen tell the user: \"OpenClaw has been restarted. Send `/new` as a standalone message to start a fresh chat, then ask for Instagram again.\"\n\n## Quick Start\n\n```bash\n# Get your Instagram account info\nclawlink_call_tool --tool \"instagram_get_user_info\" --params '{}'\n\n# List recent media posts\nclawlink_call_tool --tool \"instagram_get_ig_user_media\" --params '{}'\n\n# Get insights on a specific post\nclawlink_call_tool --tool \"instagram_get_ig_media_insights\" --params '{\"media_id\": \"MEDIA_ID\"}'\n```\n\n## Authentication\n\nAll Instagram tool calls are authenticated automatically by ClawLink using the user's connected Instagram Business or Creator account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every Instagram Graph API request on the user's behalf.\n\n### Getting Connected\n\n1. Install the ClawLink plugin (see Install above).\n2. Pair the plugin with `clawlink_begin_pairing` if it is not configured yet.\n3. Open https://claw-link.dev/dashboard?add=instagram and connect Instagram (requires a Business or Creator account).\n4. Call `clawlink_list_integrations` to verify the connection is active.\n\n## Connection Management\n\n### List Connections\n\n```bash\nclawlink_list_integrations\n```\n\n**Response:** Returns all connected integrations. Look for `instagram` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration instagram\n```\n\n**Response:** Returns the live tool catalog for Instagram.\n\n### Reconnect\n\nIf Instagram tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=instagram\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration instagram`\n\n## Security & Permissions\n\n- Access is scoped to the connected Instagram Business or Creator account only.\n- A Business or Creator account is required — personal Instagram accounts are not supported by the Instagram Graph API.\n- **All write operations require explicit user confirmation.** Before executing any publish, comment, or DM action, confirm the target resource and intended effect with the user.\n- Destructive actions (delete comment, delete message) are marked as high-impact and must be confirmed.\n- Content publishing is rate-limited by Instagram (25 posts per 24-hour window per account).\n\n## Tool Reference\n\n### Media Retrieval & Publishing\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_user_media` | List all media (posts, photos, videos, reels, carousels) published by the account | Read |\n| `instagram_get_ig_media` | Get details for a specific published media item including engagement metrics | Read |\n| `instagram_get_ig_media_children` | Get individual media items from a carousel/album post | Read |\n| `instagram_post_ig_user_media` | Create a media container for publishing (first step of two-step publish) | Write |\n| `instagram_post_ig_user_media_publish` | Publish a media container to the account (auto-waits for processing) | Write |\n| `instagram_create_carousel_container` | Create a draft carousel post with 2–10 images/videos | Write |\n\n### Insights & Analytics\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_user_insights` | Get account-level insights (profile views, reach, follower count) | Read |\n| `instagram_get_ig_media_insights` | Get per-media performance metrics (views, likes, comments, saves, shares) | Read |\n| `instagram_get_user_info` | Get profile details and statistics for the Business/Creator account | Read |\n| `instagram_get_ig_user_content_publishing_limit` | Check remaining publish quota before posting | Read |\n\n### Comments & Replies\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_media_comments` | List comments on a specific post with cursor-based pagination | Read |\n| `instagram_get_ig_comment_replies` | Get replies to a specific comment | Read |\n| `instagram_post_ig_media_comments` | Post a comment on a media item (300 chars max, 4 hashtags, 1 URL) | Write |\n| `instagram_post_ig_comment_replies` | Reply to an existing comment (300 chars max) | Write |\n| `instagram_delete_comment` | Delete a comment (only comments your account created) | Write |\n\n### Stories & Live\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_user_stories` | List active stories within the 24-hour story window | Read |\n| `instagram_get_ig_user_live_media` | Get live media during an active broadcast | Read |\n\n### Conversations & Messaging\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_list_all_conversations` | List all Instagram DM conversations | Read |\n| `instagram_get_conversation` | Get details of a specific DM conversation | Read |\n| `instagram_list_all_messages` | List messages in a specific DM thread | Read |\n| `instagram_send_text_message` | Send a text DM (requires prior conversation thread) | Write |\n| `instagram_send_image` | Send an image via DM | Write |\n| `instagram_mark_seen` | Mark messages as read in a DM thread | Write |\n| `instagram_get_page_conversations` | Get conversations for the connected Page | Read |\n\n### Messaging Configuration\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_messenger_profile` | Get ice breakers and messaging settings | Read |\n| `instagram_update_messenger_profile` | Configure ice breakers for the Instagram inbox | Write |\n| `instagram_delete_messenger_profile` | Remove messaging configuration | Write |\n\n### Mentions & Tags\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_user_tags` | Get media where your account was tagged by others | Read |\n| `instagram_post_ig_user_mentions` | Reply to a mention of your account | Write |\n\n## Code Examples\n\n### Get account info and insights\n\n```bash\nclawlink_call_tool --tool \"instagram_get_user_info\" \\\n --params '{}'\n```\n\n### List recent posts with insights\n\n```bash\nclawlink_call_tool --tool \"instagram_get_ig_user_media\" \\\n --params '{}'\n```\n\n### Get insights for a specific post\n\n```bash\nclawlink_call_tool --tool \"instagram_get_ig_media_insights\" \\\n --params '{\"media_id\": \"MEDIA_ID\"}'\n```\n\n### Post a comment\n\n```bash\nclawlink_call_tool --tool \"instagram_post_ig_media_comments\" \\\n --params '{\"media_id\": \"MEDIA_ID\", \"text\": \"Great post! Thanks for sharing.\"}'\n```\n\n### Send a DM\n\n```bash\nclawlink_call_tool --tool \"instagram_send_text_message\" \\\n --params '{\"message\": \"Hi! Thanks for reaching out.\", \"conversation_id\": \"CONVERSATION_ID\"}'\n```\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Instagram is connected.\n2. Call `clawlink_list_tools --integration instagram` to see the live catalog.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `instagram`.\n5. If no Instagram tools appear, direct the user to https://claw-link.dev/dashboard?add=instagram.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ READ OPERATIONS (Safe) │\n│ list → get → search → describe → call │\n│ │\n│ Example: List media → Get insights → Show results │\n└─────────────────────────────────────────────────────────────┘\n │\n ▼\n┌─────────────────────────────────────────────────────────────┐\n│ WRITE OPERATIONS (Require Confirmation) │\n│ list → get → describe → preview → confirm → call │\n│ │\n│ Example: Preview comment → User approves → Execute │\n└─────────────────────────────────────────────────────────────┘\n```\n\n1. For unfamiliar tools, ambiguous requests, or any write action, call `clawlink_describe_tool` first.\n2. Use the returned guidance, schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups` to shape the call.\n3. Prefer read, list, search, and get operations before writes when that reduces ambiguity.\n4. For writes or anything marked as requiring confirmation, call `clawlink_preview_tool` first.\n5. Execute with `clawlink_call_tool`. Pass confirmation only after the preview matches the user's intent.\n6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## Notes\n\n- Only **Business** or **Creator** Instagram accounts are supported — personal accounts return permission errors.\n- Content publishing is limited to 25 API-published posts per 24-hour moving window per account.\n- Media container `creation_id`s expire in under 24 hours — publish promptly after creating a container.\n- Comments are limited to 300 characters, 4 hashtags, and 1 URL.\n- DMs can only be sent in existing conversation threads — new threads cannot be initiated via the API.\n- Insights data is only available for posts published within the last 2 years and requires at least 1,000 followers.\n- Instagram IDs in API responses use the format `1784140xxxxx` (not numeric strings).\n\n## Error Handling\n\n| Status / Error | Meaning |\n|----------------|---------|\n| Tool not found | The tool name does not exist in the current catalog. Verify with `clawlink_list_tools --integration instagram`. |\n| Missing connection | Instagram is not connected. Direct the user to https://claw-link.dev/dashboard?add=instagram. |\n| Permission error | The account is a personal Instagram profile, not a Business/Creator account. |\n| ` OAuthException` | Instagram OAuth token is invalid or expired. Reconnect Instagram. |\n| Rate limit exceeded | Publishing quota used. Wait or reduce publish frequency. |\n| Write rejected | User did not confirm a write action. Always confirm before executing writes. |\n\n### Troubleshooting: Tools Not Visible\n\n1. Check that the ClawLink plugin is installed:\n ```bash\n openclaw plugins list\n ```\n2. If the plugin is installed but tools are missing, tell the user to send `/new` as a standalone message to reload the catalog.\n3. If a fresh chat does not help, run:\n ```bash\n openclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\n openclaw gateway restart\n ```\n4. After restart, tell the user to send `/new` again and retry.\n\n### Troubleshooting: Permission Errors\n\n1. Confirm the Instagram account is a **Business** or **Creator** account, not personal.\n2. Verify the account is connected at https://claw-link.dev/dashboard?add=instagram.\n3. For messaging tools, ensure the Instagram account has the **Instagram Messaging** permission scope.\n\n## Resources\n\n- [Instagram Graph API Overview](https://developers.facebook.com/docs/instagram-api)\n- [Instagram Media Publishing API](https://developers.facebook.com/docs/instagram-api/reference/ig-media)\n- [Instagram Insights API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/insights)\n- [Instagram Messaging API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/conversations)\n- ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=instagram-posts\n- ClawLink Docs: https://docs.claw-link.dev/openclaw\n- ClawLink Verification: https://claw-link.dev/verify\n\n## Related Skills\n\n- [Creator Scout](https://clawhub.ai/hith3sh/skills/creator-scout)\n- [Transcribe Any Video](https://clawhub.ai/hith3sh/skills/transcribe-any-video)\n- [LinkedIn Social](https://clawhub.ai/hith3sh/linkedin-social) — For LinkedIn page and post management\n- [Twitter](https://clawhub.ai/hith3sh/twitter) — For Twitter/X post management and analytics\n- [Facebook Pages](https://clawhub.ai/hith3sh/facebook-pages) — For Facebook Page management\n\n---\n\n**Powered by [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=instagram-posts)** — an integration hub for OpenClaw\n\n\n\nFile v1.0.6:_meta.json\n\n{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"instagram-posts\",\n \"version\": \"1.0.6\",\n \"publishedAt\": 1791056103314\n}\n\nFile v1.0.6:skill-card.md\n\n## Description:\n\nHelps manage Instagram Business and Creator accounts, including publishing, analytics, comment moderation, messaging, and reading public Instagram content.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[hith3sh](https://clawhub.ai/user/hith3sh)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nSocial media managers and other Instagram Business or Creator account holders use this skill to publish content, review insights, moderate comments, and handle messages. Agents can also retrieve public Instagram profiles, posts, and reel transcripts without a connected Instagram account through paid lookup tools.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: ClawLink hosts the Instagram connection and mediates credentials and tool calls.\n\nMitigation: Connect an account only if comfortable using ClawLink as a hosted intermediary.\n\nRisk: Publishing, comment moderation, direct messages, and messaging-profile changes can affect the account.\n\nMitigation: Preview the target and intended effect, then get explicit user confirmation before each write.\n\nRisk: Public Instagram lookups and video transcripts may spend ClawLink credit even without a connected Instagram account.\n\nMitigation: Check the requested lookup and its cost before invoking paid tools.\n\n## Reference(s):\n\n- [Instagram skill on ClawHub](https://clawhub.ai/hith3sh/skills/instagram-posts)\n- [Instagram Graph API overview](https://developers.facebook.com/docs/instagram-api)\n- [Instagram Media Publishing API](https://developers.facebook.com/docs/instagram-api/reference/ig-media)\n- [ClawLink documentation](https://docs.claw-link.dev/openclaw)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Guidance]\n\n**Output Format:** [Markdown with tool results and optional shell commands]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include account and media insights, public post details, or reel transcripts; account-changing actions require user confirmation.]\n\n## Skill Version(s):\n\n1.0.6 (source: ClawHub release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.5: 3 files, 6492 bytes\n\nFiles: skill-card.md (2940b), SKILL.md (15878b), _meta.json (134b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: instagram-posts\ndescription: Manage Instagram Business and Creator accounts via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send DMs, and manage story content. Use this skill when users want to manage Instagram content, analyze engagement, or automate social media workflows.\n---\n\n# Instagram\n\n\n\nManage an Instagram Business or Creator account via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send direct messages, and monitor story content.\n\nThis skill uses [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=instagram-posts) for hosted connection flows and credentials so you do not need to configure Instagram API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Instagram |\n|:---:|:---:|:---:|\n|  |  |  |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Instagram |\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Instagram Graph │\n│ (User Chat) │ │ (OAuth) │ │ (API v22) │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect IG │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Instagram│\n │ File │ │ Auth │ │ Business │\n └──────────┘ └──────────┘ └──────────┘\n```\n\n## Install\n\nInstall the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.\n\n```bash\nopenclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart\n```\n\nThen tell the user: \"OpenClaw has been restarted. Send `/new` as a standalone message to start a fresh chat, then ask for Instagram again.\"\n\n## Quick Start\n\n```bash\n# Get your Instagram account info\nclawlink_call_tool --tool \"instagram_get_user_info\" --params '{}'\n\n# List recent media posts\nclawlink_call_tool --tool \"instagram_get_ig_user_media\" --params '{}'\n\n# Get insights on a specific post\nclawlink_call_tool --tool \"instagram_get_ig_media_insights\" --params '{\"media_id\": \"MEDIA_ID\"}'\n```\n\n## Authentication\n\nAll Instagram tool calls are authenticated automatically by ClawLink using the user's connected Instagram Business or Creator account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every Instagram Graph API request on the user's behalf.\n\n### Getting Connected\n\n1. Install the ClawLink plugin (see Install above).\n2. Pair the plugin with `clawlink_begin_pairing` if it is not configured yet.\n3. Open https://claw-link.dev/dashboard?add=instagram and connect Instagram (requires a Business or Creator account).\n4. Call `clawlink_list_integrations` to verify the connection is active.\n\n## Connection Management\n\n### List Connections\n\n```bash\nclawlink_list_integrations\n```\n\n**Response:** Returns all connected integrations. Look for `instagram` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration instagram\n```\n\n**Response:** Returns the live tool catalog for Instagram.\n\n### Reconnect\n\nIf Instagram tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=instagram\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration instagram`\n\n## Security & Permissions\n\n- Access is scoped to the connected Instagram Business or Creator account only.\n- A Business or Creator account is required — personal Instagram accounts are not supported by the Instagram Graph API.\n- **All write operations require explicit user confirmation.** Before executing any publish, comment, or DM action, confirm the target resource and intended effect with the user.\n- Destructive actions (delete comment, delete message) are marked as high-impact and must be confirmed.\n- Content publishing is rate-limited by Instagram (25 posts per 24-hour window per account).\n\n## Tool Reference\n\n### Media Retrieval & Publishing\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_user_media` | List all media (posts, photos, videos, reels, carousels) published by the account | Read |\n| `instagram_get_ig_media` | Get details for a specific published media item including engagement metrics | Read |\n| `instagram_get_ig_media_children` | Get individual media items from a carousel/album post | Read |\n| `instagram_post_ig_user_media` | Create a media container for publishing (first step of two-step publish) | Write |\n| `instagram_post_ig_user_media_publish` | Publish a media container to the account (auto-waits for processing) | Write |\n| `instagram_create_carousel_container` | Create a draft carousel post with 2–10 images/videos | Write |\n\n### Insights & Analytics\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_user_insights` | Get account-level insights (profile views, reach, follower count) | Read |\n| `instagram_get_ig_media_insights` | Get per-media performance metrics (views, likes, comments, saves, shares) | Read |\n| `instagram_get_user_info` | Get profile details and statistics for the Business/Creator account | Read |\n| `instagram_get_ig_user_content_publishing_limit` | Check remaining publish quota before posting | Read |\n\n### Comments & Replies\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_media_comments` | List comments on a specific post with cursor-based pagination | Read |\n| `instagram_get_ig_comment_replies` | Get replies to a specific comment | Read |\n| `instagram_post_ig_media_comments` | Post a comment on a media item (300 chars max, 4 hashtags, 1 URL) | Write |\n| `instagram_post_ig_comment_replies` | Reply to an existing comment (300 chars max) | Write |\n| `instagram_delete_comment` | Delete a comment (only comments your account created) | Write |\n\n### Stories & Live\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_user_stories` | List active stories within the 24-hour story window | Read |\n| `instagram_get_ig_user_live_media` | Get live media during an active broadcast | Read |\n\n### Conversations & Messaging\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_list_all_conversations` | List all Instagram DM conversations | Read |\n| `instagram_get_conversation` | Get details of a specific DM conversation | Read |\n| `instagram_list_all_messages` | List messages in a specific DM thread | Read |\n| `instagram_send_text_message` | Send a text DM (requires prior conversation thread) | Write |\n| `instagram_send_image` | Send an image via DM | Write |\n| `instagram_mark_seen` | Mark messages as read in a DM thread | Write |\n| `instagram_get_page_conversations` | Get conversations for the connected Page | Read |\n\n### Messaging Configuration\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_messenger_profile` | Get ice breakers and messaging settings | Read |\n| `instagram_update_messenger_profile` | Configure ice breakers for the Instagram inbox | Write |\n| `instagram_delete_messenger_profile` | Remove messaging configuration | Write |\n\n### Mentions & Tags\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_user_tags` | Get media where your account was tagged by others | Read |\n| `instagram_post_ig_user_mentions` | Reply to a mention of your account | Write |\n\n## Code Examples\n\n### Get account info and insights\n\n```bash\nclawlink_call_tool --tool \"instagram_get_user_info\" \\\n --params '{}'\n```\n\n### List recent posts with insights\n\n```bash\nclawlink_call_tool --tool \"instagram_get_ig_user_media\" \\\n --params '{}'\n```\n\n### Get insights for a specific post\n\n```bash\nclawlink_call_tool --tool \"instagram_get_ig_media_insights\" \\\n --params '{\"media_id\": \"MEDIA_ID\"}'\n```\n\n### Post a comment\n\n```bash\nclawlink_call_tool --tool \"instagram_post_ig_media_comments\" \\\n --params '{\"media_id\": \"MEDIA_ID\", \"text\": \"Great post! Thanks for sharing.\"}'\n```\n\n### Send a DM\n\n```bash\nclawlink_call_tool --tool \"instagram_send_text_message\" \\\n --params '{\"message\": \"Hi! Thanks for reaching out.\", \"conversation_id\": \"CONVERSATION_ID\"}'\n```\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Instagram is connected.\n2. Call `clawlink_list_tools --integration instagram` to see the live catalog.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `instagram`.\n5. If no Instagram tools appear, direct the user to https://claw-link.dev/dashboard?add=instagram.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ READ OPERATIONS (Safe) │\n│ list → get → search → describe → call │\n│ │\n│ Example: List media → Get insights → Show results │\n└─────────────────────────────────────────────────────────────┘\n │\n ▼\n┌─────────────────────────────────────────────────────────────┐\n│ WRITE OPERATIONS (Require Confirmation) │\n│ list → get → describe → preview → confirm → call │\n│ │\n│ Example: Preview comment → User approves → Execute │\n└─────────────────────────────────────────────────────────────┘\n```\n\n1. For unfamiliar tools, ambiguous requests, or any write action, call `clawlink_describe_tool` first.\n2. Use the returned guidance, schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups` to shape the call.\n3. Prefer read, list, search, and get operations before writes when that reduces ambiguity.\n4. For writes or anything marked as requiring confirmation, call `clawlink_preview_tool` first.\n5. Execute with `clawlink_call_tool`. Pass confirmation only after the preview matches the user's intent.\n6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## Notes\n\n- Only **Business** or **Creator** Instagram accounts are supported — personal accounts return permission errors.\n- Content publishing is limited to 25 API-published posts per 24-hour moving window per account.\n- Media container `creation_id`s expire in under 24 hours — publish promptly after creating a container.\n- Comments are limited to 300 characters, 4 hashtags, and 1 URL.\n- DMs can only be sent in existing conversation threads — new threads cannot be initiated via the API.\n- Insights data is only available for posts published within the last 2 years and requires at least 1,000 followers.\n- Instagram IDs in API responses use the format `1784140xxxxx` (not numeric strings).\n\n## Error Handling\n\n| Status / Error | Meaning |\n|----------------|---------|\n| Tool not found | The tool name does not exist in the current catalog. Verify with `clawlink_list_tools --integration instagram`. |\n| Missing connection | Instagram is not connected. Direct the user to https://claw-link.dev/dashboard?add=instagram. |\n| Permission error | The account is a personal Instagram profile, not a Business/Creator account. |\n| ` OAuthException` | Instagram OAuth token is invalid or expired. Reconnect Instagram. |\n| Rate limit exceeded | Publishing quota used. Wait or reduce publish frequency. |\n| Write rejected | User did not confirm a write action. Always confirm before executing writes. |\n\n### Troubleshooting: Tools Not Visible\n\n1. Check that the ClawLink plugin is installed:\n ```bash\n openclaw plugins list\n ```\n2. If the plugin is installed but tools are missing, tell the user to send `/new` as a standalone message to reload the catalog.\n3. If a fresh chat does not help, run:\n ```bash\n openclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\n openclaw gateway restart\n ```\n4. After restart, tell the user to send `/new` again and retry.\n\n### Troubleshooting: Permission Errors\n\n1. Confirm the Instagram account is a **Business** or **Creator** account, not personal.\n2. Verify the account is connected at https://claw-link.dev/dashboard?add=instagram.\n3. For messaging tools, ensure the Instagram account has the **Instagram Messaging** permission scope.\n\n## Resources\n\n- [Instagram Graph API Overview](https://developers.facebook.com/docs/instagram-api)\n- [Instagram Media Publishing API](https://developers.facebook.com/docs/instagram-api/reference/ig-media)\n- [Instagram Insights API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/insights)\n- [Instagram Messaging API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/conversations)\n- ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=instagram-posts\n- ClawLink Docs: https://docs.claw-link.dev/openclaw\n- ClawLink Verification: https://claw-link.dev/verify\n\n## Related Skills\n\n- [LinkedIn Social](https://clawhub.ai/hith3sh/linkedin-social) — For LinkedIn page and post management\n- [Twitter](https://clawhub.ai/hith3sh/twitter) — For Twitter/X post management and analytics\n- [Facebook Pages](https://clawhub.ai/hith3sh/facebook-pages) — For Facebook Page management\n\n---\n\n**Powered by [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=instagram-posts)** — an integration hub for OpenClaw\n\n\n\nFile v1.0.5:_meta.json\n\n{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"instagram-posts\",\n \"version\": \"1.0.5\",\n \"publishedAt\": 1780989111278\n}\n\nFile v1.0.5:skill-card.md\n\n## Description:\n\nManage Instagram Business and Creator accounts via the Instagram Graph API for publishing, media retrieval, insights, comment moderation, direct messages, and story workflows.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[hith3sh](https://clawhub.ai/user/hith3sh)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users, social media managers, and developers use this skill to manage Instagram Business or Creator accounts through ClawLink-hosted Instagram Graph API tools. It supports content publishing, media and account analytics, comment moderation, messaging workflows, and story monitoring.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill installs and enables a third-party ClawLink plugin that can access the user's connected Instagram account.\n\nMitigation: Confirm trust in ClawLink and the ClawHub plugin package before installation, review Instagram OAuth permissions, and revoke the Instagram connection if access is no longer wanted.\n\nRisk: Publishing, comments, DMs, message-read changes, and deletions can affect a live Instagram Business or Creator account.\n\nMitigation: Use the skill's preview and explicit confirmation flow before write, high-impact, or destructive operations.\n\nRisk: Instagram account type, permissions, quotas, and token state can prevent expected operations.\n\nMitigation: Verify the account is Business or Creator, confirm the connection is active, check required messaging permissions, and reconnect through ClawLink if OAuth errors occur.\n\n## Reference(s):\n\n- [Instagram Graph API Overview](https://developers.facebook.com/docs/instagram-api)\n- [Instagram Media Publishing API](https://developers.facebook.com/docs/instagram-api/reference/ig-media)\n- [Instagram Insights API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/insights)\n- [Instagram Messaging API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/conversations)\n- [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=instagram-posts)\n- [ClawLink Docs](https://docs.claw-link.dev/openclaw)\n- [ClawLink Verification](https://claw-link.dev/verify)\n\n## Skill Output:\n\n**Output Type(s):** [guidance, shell commands, configuration, API calls, text]\n\n**Output Format:** [Markdown with inline shell commands and tool-call examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires a connected Instagram Business or Creator account through ClawLink; write operations should be previewed and explicitly confirmed.]\n\n## Skill Version(s):\n\n1.0.5 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.4: 3 files, 6462 bytes\n\nFiles: skill-card.md (3092b), SKILL.md (15674b), _meta.json (134b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: instagram-posts\ndescription: Manage Instagram Business and Creator accounts via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send DMs, and manage story content. Use this skill when users want to manage Instagram content, analyze engagement, or automate social media workflows.\n---\n\n# Instagram\n\n\n\nManage an Instagram Business or Creator account via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send direct messages, and monitor story content.\n\nThis skill uses [ClawLink](https://claw-link.dev) for hosted connection flows and credentials so you do not need to configure Instagram API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Instagram |\n|:---:|:---:|:---:|\n|  |  |  |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Instagram |\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Instagram Graph │\n│ (User Chat) │ │ (OAuth) │ │ (API v22) │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect IG │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Instagram│\n │ File │ │ Auth │ │ Business │\n └──────────┘ └──────────┘ └──────────┘\n```\n\n## Install\n\nInstall the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.\n\n```bash\nopenclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart\n```\n\nThen tell the user: \"OpenClaw has been restarted. Send `/new` as a standalone message to start a fresh chat, then ask for Instagram again.\"\n\n## Quick Start\n\n```bash\n# Get your Instagram account info\nclawlink_call_tool --tool \"instagram_get_user_info\" --params '{}'\n\n# List recent media posts\nclawlink_call_tool --tool \"instagram_get_ig_user_media\" --params '{}'\n\n# Get insights on a specific post\nclawlink_call_tool --tool \"instagram_get_ig_media_insights\" --params '{\"media_id\": \"MEDIA_ID\"}'\n```\n\n## Authentication\n\nAll Instagram tool calls are authenticated automatically by ClawLink using the user's connected Instagram Business or Creator account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every Instagram Graph API request on the user's behalf.\n\n### Getting Connected\n\n1. Install the ClawLink plugin (see Install above).\n2. Pair the plugin with `clawlink_begin_pairing` if it is not configured yet.\n3. Open https://claw-link.dev/dashboard?add=instagram and connect Instagram (requires a Business or Creator account).\n4. Call `clawlink_list_integrations` to verify the connection is active.\n\n## Connection Management\n\n### List Connections\n\n```bash\nclawlink_list_integrations\n```\n\n**Response:** Returns all connected integrations. Look for `instagram` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration instagram\n```\n\n**Response:** Returns the live tool catalog for Instagram.\n\n### Reconnect\n\nIf Instagram tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=instagram\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration instagram`\n\n## Security & Permissions\n\n- Access is scoped to the connected Instagram Business or Creator account only.\n- A Business or Creator account is required — personal Instagram accounts are not supported by the Instagram Graph API.\n- **All write operations require explicit user confirmation.** Before executing any publish, comment, or DM action, confirm the target resource and intended effect with the user.\n- Destructive actions (delete comment, delete message) are marked as high-impact and must be confirmed.\n- Content publishing is rate-limited by Instagram (25 posts per 24-hour window per account).\n\n## Tool Reference\n\n### Media Retrieval & Publishing\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_user_media` | List all media (posts, photos, videos, reels, carousels) published by the account | Read |\n| `instagram_get_ig_media` | Get details for a specific published media item including engagement metrics | Read |\n| `instagram_get_ig_media_children` | Get individual media items from a carousel/album post | Read |\n| `instagram_post_ig_user_media` | Create a media container for publishing (first step of two-step publish) | Write |\n| `instagram_post_ig_user_media_publish` | Publish a media container to the account (auto-waits for processing) | Write |\n| `instagram_create_carousel_container` | Create a draft carousel post with 2–10 images/videos | Write |\n\n### Insights & Analytics\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_user_insights` | Get account-level insights (profile views, reach, follower count) | Read |\n| `instagram_get_ig_media_insights` | Get per-media performance metrics (views, likes, comments, saves, shares) | Read |\n| `instagram_get_user_info` | Get profile details and statistics for the Business/Creator account | Read |\n| `instagram_get_ig_user_content_publishing_limit` | Check remaining publish quota before posting | Read |\n\n### Comments & Replies\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_media_comments` | List comments on a specific post with cursor-based pagination | Read |\n| `instagram_get_ig_comment_replies` | Get replies to a specific comment | Read |\n| `instagram_post_ig_media_comments` | Post a comment on a media item (300 chars max, 4 hashtags, 1 URL) | Write |\n| `instagram_post_ig_comment_replies` | Reply to an existing comment (300 chars max) | Write |\n| `instagram_delete_comment` | Delete a comment (only comments your account created) | Write |\n\n### Stories & Live\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_user_stories` | List active stories within the 24-hour story window | Read |\n| `instagram_get_ig_user_live_media` | Get live media during an active broadcast | Read |\n\n### Conversations & Messaging\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_list_all_conversations` | List all Instagram DM conversations | Read |\n| `instagram_get_conversation` | Get details of a specific DM conversation | Read |\n| `instagram_list_all_messages` | List messages in a specific DM thread | Read |\n| `instagram_send_text_message` | Send a text DM (requires prior conversation thread) | Write |\n| `instagram_send_image` | Send an image via DM | Write |\n| `instagram_mark_seen` | Mark messages as read in a DM thread | Write |\n| `instagram_get_page_conversations` | Get conversations for the connected Page | Read |\n\n### Messaging Configuration\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_messenger_profile` | Get ice breakers and messaging settings | Read |\n| `instagram_update_messenger_profile` | Configure ice breakers for the Instagram inbox | Write |\n| `instagram_delete_messenger_profile` | Remove messaging configuration | Write |\n\n### Mentions & Tags\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_user_tags` | Get media where your account was tagged by others | Read |\n| `instagram_post_ig_user_mentions` | Reply to a mention of your account | Write |\n\n## Code Examples\n\n### Get account info and insights\n\n```bash\nclawlink_call_tool --tool \"instagram_get_user_info\" \\\n --params '{}'\n```\n\n### List recent posts with insights\n\n```bash\nclawlink_call_tool --tool \"instagram_get_ig_user_media\" \\\n --params '{}'\n```\n\n### Get insights for a specific post\n\n```bash\nclawlink_call_tool --tool \"instagram_get_ig_media_insights\" \\\n --params '{\"media_id\": \"MEDIA_ID\"}'\n```\n\n### Post a comment\n\n```bash\nclawlink_call_tool --tool \"instagram_post_ig_media_comments\" \\\n --params '{\"media_id\": \"MEDIA_ID\", \"text\": \"Great post! Thanks for sharing.\"}'\n```\n\n### Send a DM\n\n```bash\nclawlink_call_tool --tool \"instagram_send_text_message\" \\\n --params '{\"message\": \"Hi! Thanks for reaching out.\", \"conversation_id\": \"CONVERSATION_ID\"}'\n```\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Instagram is connected.\n2. Call `clawlink_list_tools --integration instagram` to see the live catalog.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `instagram`.\n5. If no Instagram tools appear, direct the user to https://claw-link.dev/dashboard?add=instagram.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ READ OPERATIONS (Safe) │\n│ list → get → search → describe → call │\n│ │\n│ Example: List media → Get insights → Show results │\n└─────────────────────────────────────────────────────────────┘\n │\n ▼\n┌─────────────────────────────────────────────────────────────┐\n│ WRITE OPERATIONS (Require Confirmation) │\n│ list → get → describe → preview → confirm → call │\n│ │\n│ Example: Preview comment → User approves → Execute │\n└─────────────────────────────────────────────────────────────┘\n```\n\n1. For unfamiliar tools, ambiguous requests, or any write action, call `clawlink_describe_tool` first.\n2. Use the returned guidance, schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups` to shape the call.\n3. Prefer read, list, search, and get operations before writes when that reduces ambiguity.\n4. For writes or anything marked as requiring confirmation, call `clawlink_preview_tool` first.\n5. Execute with `clawlink_call_tool`. Pass confirmation only after the preview matches the user's intent.\n6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## Notes\n\n- Only **Business** or **Creator** Instagram accounts are supported — personal accounts return permission errors.\n- Content publishing is limited to 25 API-published posts per 24-hour moving window per account.\n- Media container `creation_id`s expire in under 24 hours — publish promptly after creating a container.\n- Comments are limited to 300 characters, 4 hashtags, and 1 URL.\n- DMs can only be sent in existing conversation threads — new threads cannot be initiated via the API.\n- Insights data is only available for posts published within the last 2 years and requires at least 1,000 followers.\n- Instagram IDs in API responses use the format `1784140xxxxx` (not numeric strings).\n\n## Error Handling\n\n| Status / Error | Meaning |\n|----------------|---------|\n| Tool not found | The tool name does not exist in the current catalog. Verify with `clawlink_list_tools --integration instagram`. |\n| Missing connection | Instagram is not connected. Direct the user to https://claw-link.dev/dashboard?add=instagram. |\n| Permission error | The account is a personal Instagram profile, not a Business/Creator account. |\n| ` OAuthException` | Instagram OAuth token is invalid or expired. Reconnect Instagram. |\n| Rate limit exceeded | Publishing quota used. Wait or reduce publish frequency. |\n| Write rejected | User did not confirm a write action. Always confirm before executing writes. |\n\n### Troubleshooting: Tools Not Visible\n\n1. Check that the ClawLink plugin is installed:\n ```bash\n openclaw plugins list\n ```\n2. If the plugin is installed but tools are missing, tell the user to send `/new` as a standalone message to reload the catalog.\n3. If a fresh chat does not help, run:\n ```bash\n openclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\n openclaw gateway restart\n ```\n4. After restart, tell the user to send `/new` again and retry.\n\n### Troubleshooting: Permission Errors\n\n1. Confirm the Instagram account is a **Business** or **Creator** account, not personal.\n2. Verify the account is connected at https://claw-link.dev/dashboard?add=instagram.\n3. For messaging tools, ensure the Instagram account has the **Instagram Messaging** permission scope.\n\n## Resources\n\n- [Instagram Graph API Overview](https://developers.facebook.com/docs/instagram-api)\n- [Instagram Media Publishing API](https://developers.facebook.com/docs/instagram-api/reference/ig-media)\n- [Instagram Insights API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/insights)\n- [Instagram Messaging API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/conversations)\n- ClawLink: https://claw-link.dev\n- ClawLink Docs: https://docs.claw-link.dev/openclaw\n- ClawLink Verification: https://claw-link.dev/verify\n\n## Related Skills\n\n- [LinkedIn Social](https://clawhub.ai/hith3sh/linkedin-social) — For LinkedIn page and post management\n- [Twitter](https://clawhub.ai/hith3sh/twitter) — For Twitter/X post management and analytics\n- [Facebook Pages](https://clawhub.ai/hith3sh/facebook-pages) — For Facebook Page management\n\n---\n\n**Powered by [ClawLink](https://claw-link.dev)** — an integration hub for OpenClaw\n\n\n\nFile v1.0.4:_meta.json\n\n{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"instagram-posts\",\n \"version\": \"1.0.4\",\n \"publishedAt\": 1780981025827\n}\n\nFile v1.0.4:skill-card.md\n\n## Description:
\nManage Instagram Business and Creator accounts via the Instagram Graph API, including publishing posts and carousels, retrieving media and insights, moderating comments, sending DMs, and managing story content.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[hith3sh](https://clawhub.ai/user/hith3sh)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users and social media operators use this skill to manage Instagram Business or Creator accounts, including publishing content, reviewing insights, moderating comments, sending direct messages, and managing story workflows.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill can publish, comment, message, or moderate through a connected Instagram Business or Creator account.
\nMitigation: Give explicit instructions and review the intended account, content, audience, and timing before allowing any write or moderation action.
\nRisk: The integration requires OAuth credentials and Instagram management authority for the connected account.
\nMitigation: Install it only for accounts where granting Instagram management access is acceptable, and keep access scoped to the intended Business or Creator account.
\nRisk: Some Instagram operations have platform limits or prerequisites, including Business or Creator account requirements, publishing quotas, existing DM threads, comment limits, and insight availability windows.
\nMitigation: Verify the live tool catalog and operation constraints before executing account actions, especially publishing, messaging, and analytics requests.
\n\n\n## Reference(s):
\n- [Instagram Graph API Overview](https://developers.facebook.com/docs/instagram-api)
\n- [Instagram Media Publishing API](https://developers.facebook.com/docs/instagram-api/reference/ig-media)
\n- [Instagram Insights API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/insights)
\n- [Instagram Messaging API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/conversations)
\n- [ClawLink](https://claw-link.dev)
\n- [ClawLink Docs](https://docs.claw-link.dev/openclaw)
\n- [ClawHub Release Page](https://clawhub.ai/hith3sh/instagram-posts)
\n\n\n## Skill Output:
\n**Output Type(s):** [Guidance, Shell commands, Configuration, API calls, Markdown]
\n**Output Format:** [Markdown with inline shell commands and JSON tool parameters]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [May produce Instagram Graph API tool-call guidance, preview steps, and read/write operation instructions for the connected account.]
\n\n## Skill Version(s):
\n1.0.4 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v1.0.1: 3 files, 6385 bytes\n\nFiles: skill-card.md (2897b), SKILL.md (15674b), _meta.json (134b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: instagram-posts\ndescription: Manage Instagram Business and Creator accounts via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send DMs, and manage story content. Use this skill when users want to manage Instagram content, analyze engagement, or automate social media workflows.\n---\n\n# Instagram\n\n\n\nManage an Instagram Business or Creator account via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send direct messages, and monitor story content.\n\nThis skill uses [ClawLink](https://claw-link.dev) for hosted connection flows and credentials so you do not need to configure Instagram API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Instagram |\n|:---:|:---:|:---:|\n|  |  |  |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Instagram |\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Instagram Graph │\n│ (User Chat) │ │ (OAuth) │ │ (API v22) │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect IG │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Instagram│\n │ File │ │ Auth │ │ Business │\n └──────────┘ └──────────┘ └──────────┘\n```\n\n## Install\n\nInstall the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.\n\n```bash\nopenclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart\n```\n\nThen tell the user: \"OpenClaw has been restarted. Send `/new` as a standalone message to start a fresh chat, then ask for Instagram again.\"\n\n## Quick Start\n\n```bash\n# Get your Instagram account info\nclawlink_call_tool --tool \"instagram_get_user_info\" --params '{}'\n\n# List recent media posts\nclawlink_call_tool --tool \"instagram_get_ig_user_media\" --params '{}'\n\n# Get insights on a specific post\nclawlink_call_tool --tool \"instagram_get_ig_media_insights\" --params '{\"media_id\": \"MEDIA_ID\"}'\n```\n\n## Authentication\n\nAll Instagram tool calls are authenticated automatically by ClawLink using the user's connected Instagram Business or Creator account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every Instagram Graph API request on the user's behalf.\n\n### Getting Connected\n\n1. Install the ClawLink plugin (see Install above).\n2. Pair the plugin with `clawlink_begin_pairing` if it is not configured yet.\n3. Open https://claw-link.dev/dashboard?add=instagram and connect Instagram (requires a Business or Creator account).\n4. Call `clawlink_list_integrations` to verify the connection is active.\n\n## Connection Management\n\n### List Connections\n\n```bash\nclawlink_list_integrations\n```\n\n**Response:** Returns all connected integrations. Look for `instagram` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration instagram\n```\n\n**Response:** Returns the live tool catalog for Instagram.\n\n### Reconnect\n\nIf Instagram tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=instagram\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration instagram`\n\n## Security & Permissions\n\n- Access is scoped to the connected Instagram Business or Creator account only.\n- A Business or Creator account is required — personal Instagram accounts are not supported by the Instagram Graph API.\n- **All write operations require explicit user confirmation.** Before executing any publish, comment, or DM action, confirm the target resource and intended effect with the user.\n- Destructive actions (delete comment, delete message) are marked as high-impact and must be confirmed.\n- Content publishing is rate-limited by Instagram (25 posts per 24-hour window per account).\n\n## Tool Reference\n\n### Media Retrieval & Publishing\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_user_media` | List all media (posts, photos, videos, reels, carousels) published by the account | Read |\n| `instagram_get_ig_media` | Get details for a specific published media item including engagement metrics | Read |\n| `instagram_get_ig_media_children` | Get individual media items from a carousel/album post | Read |\n| `instagram_post_ig_user_media` | Create a media container for publishing (first step of two-step publish) | Write |\n| `instagram_post_ig_user_media_publish` | Publish a media container to the account (auto-waits for processing) | Write |\n| `instagram_create_carousel_container` | Create a draft carousel post with 2–10 images/videos | Write |\n\n### Insights & Analytics\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_user_insights` | Get account-level insights (profile views, reach, follower count) | Read |\n| `instagram_get_ig_media_insights` | Get per-media performance metrics (views, likes, comments, saves, shares) | Read |\n| `instagram_get_user_info` | Get profile details and statistics for the Business/Creator account | Read |\n| `instagram_get_ig_user_content_publishing_limit` | Check remaining publish quota before posting | Read |\n\n### Comments & Replies\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_media_comments` | List comments on a specific post with cursor-based pagination | Read |\n| `instagram_get_ig_comment_replies` | Get replies to a specific comment | Read |\n| `instagram_post_ig_media_comments` | Post a comment on a media item (300 chars max, 4 hashtags, 1 URL) | Write |\n| `instagram_post_ig_comment_replies` | Reply to an existing comment (300 chars max) | Write |\n| `instagram_delete_comment` | Delete a comment (only comments your account created) | Write |\n\n### Stories & Live\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_user_stories` | List active stories within the 24-hour story window | Read |\n| `instagram_get_ig_user_live_media` | Get live media during an active broadcast | Read |\n\n### Conversations & Messaging\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_list_all_conversations` | List all Instagram DM conversations | Read |\n| `instagram_get_conversation` | Get details of a specific DM conversation | Read |\n| `instagram_list_all_messages` | List messages in a specific DM thread | Read |\n| `instagram_send_text_message` | Send a text DM (requires prior conversation thread) | Write |\n| `instagram_send_image` | Send an image via DM | Write |\n| `instagram_mark_seen` | Mark messages as read in a DM thread | Write |\n| `instagram_get_page_conversations` | Get conversations for the connected Page | Read |\n\n### Messaging Configuration\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_messenger_profile` | Get ice breakers and messaging settings | Read |\n| `instagram_update_messenger_profile` | Configure ice breakers for the Instagram inbox | Write |\n| `instagram_delete_messenger_profile` | Remove messaging configuration | Write |\n\n### Mentions & Tags\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_user_tags` | Get media where your account was tagged by others | Read |\n| `instagram_post_ig_user_mentions` | Reply to a mention of your account | Write |\n\n## Code Examples\n\n### Get account info and insights\n\n```bash\nclawlink_call_tool --tool \"instagram_get_user_info\" \\\n --params '{}'\n```\n\n### List recent posts with insights\n\n```bash\nclawlink_call_tool --tool \"instagram_get_ig_user_media\" \\\n --params '{}'\n```\n\n### Get insights for a specific post\n\n```bash\nclawlink_call_tool --tool \"instagram_get_ig_media_insights\" \\\n --params '{\"media_id\": \"MEDIA_ID\"}'\n```\n\n### Post a comment\n\n```bash\nclawlink_call_tool --tool \"instagram_post_ig_media_comments\" \\\n --params '{\"media_id\": \"MEDIA_ID\", \"text\": \"Great post! Thanks for sharing.\"}'\n```\n\n### Send a DM\n\n```bash\nclawlink_call_tool --tool \"instagram_send_text_message\" \\\n --params '{\"message\": \"Hi! Thanks for reaching out.\", \"conversation_id\": \"CONVERSATION_ID\"}'\n```\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Instagram is connected.\n2. Call `clawlink_list_tools --integration instagram` to see the live catalog.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `instagram`.\n5. If no Instagram tools appear, direct the user to https://claw-link.dev/dashboard?add=instagram.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ READ OPERATIONS (Safe) │\n│ list → get → search → describe → call │\n│ │\n│ Example: List media → Get insights → Show results │\n└─────────────────────────────────────────────────────────────┘\n │\n ▼\n┌─────────────────────────────────────────────────────────────┐\n│ WRITE OPERATIONS (Require Confirmation) │\n│ list → get → describe → preview → confirm → call │\n│ │\n│ Example: Preview comment → User approves → Execute │\n└─────────────────────────────────────────────────────────────┘\n```\n\n1. For unfamiliar tools, ambiguous requests, or any write action, call `clawlink_describe_tool` first.\n2. Use the returned guidance, schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups` to shape the call.\n3. Prefer read, list, search, and get operations before writes when that reduces ambiguity.\n4. For writes or anything marked as requiring confirmation, call `clawlink_preview_tool` first.\n5. Execute with `clawlink_call_tool`. Pass confirmation only after the preview matches the user's intent.\n6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## Notes\n\n- Only **Business** or **Creator** Instagram accounts are supported — personal accounts return permission errors.\n- Content publishing is limited to 25 API-published posts per 24-hour moving window per account.\n- Media container `creation_id`s expire in under 24 hours — publish promptly after creating a container.\n- Comments are limited to 300 characters, 4 hashtags, and 1 URL.\n- DMs can only be sent in existing conversation threads — new threads cannot be initiated via the API.\n- Insights data is only available for posts published within the last 2 years and requires at least 1,000 followers.\n- Instagram IDs in API responses use the format `1784140xxxxx` (not numeric strings).\n\n## Error Handling\n\n| Status / Error | Meaning |\n|----------------|---------|\n| Tool not found | The tool name does not exist in the current catalog. Verify with `clawlink_list_tools --integration instagram`. |\n| Missing connection | Instagram is not connected. Direct the user to https://claw-link.dev/dashboard?add=instagram. |\n| Permission error | The account is a personal Instagram profile, not a Business/Creator account. |\n| ` OAuthException` | Instagram OAuth token is invalid or expired. Reconnect Instagram. |\n| Rate limit exceeded | Publishing quota used. Wait or reduce publish frequency. |\n| Write rejected | User did not confirm a write action. Always confirm before executing writes. |\n\n### Troubleshooting: Tools Not Visible\n\n1. Check that the ClawLink plugin is installed:\n ```bash\n openclaw plugins list\n ```\n2. If the plugin is installed but tools are missing, tell the user to send `/new` as a standalone message to reload the catalog.\n3. If a fresh chat does not help, run:\n ```bash\n openclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\n openclaw gateway restart\n ```\n4. After restart, tell the user to send `/new` again and retry.\n\n### Troubleshooting: Permission Errors\n\n1. Confirm the Instagram account is a **Business** or **Creator** account, not personal.\n2. Verify the account is connected at https://claw-link.dev/dashboard?add=instagram.\n3. For messaging tools, ensure the Instagram account has the **Instagram Messaging** permission scope.\n\n## Resources\n\n- [Instagram Graph API Overview](https://developers.facebook.com/docs/instagram-api)\n- [Instagram Media Publishing API](https://developers.facebook.com/docs/instagram-api/reference/ig-media)\n- [Instagram Insights API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/insights)\n- [Instagram Messaging API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/conversations)\n- ClawLink: https://claw-link.dev\n- ClawLink Docs: https://docs.claw-link.dev/openclaw\n- ClawLink Verification: https://claw-link.dev/verify\n\n## Related Skills\n\n- [LinkedIn Social](https://clawhub.ai/hith3sh/linkedin-social) — For LinkedIn page and post management\n- [Twitter](https://clawhub.ai/hith3sh/twitter) — For Twitter/X post management and analytics\n- [Facebook Pages](https://clawhub.ai/hith3sh/facebook-pages) — For Facebook Page management\n\n---\n\n**Powered by [ClawLink](https://claw-link.dev)** — an integration hub for OpenClaw\n\n\n\nFile v1.0.1:_meta.json\n\n{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"instagram-posts\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1780936709907\n}\n\nFile v1.0.1:skill-card.md\n\n## Description:
\nManage Instagram Business and Creator accounts via the Instagram Graph API to publish posts and carousels, retrieve media and insights, moderate comments, send DMs, and manage story content.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[hith3sh](https://clawhub.ai/user/hith3sh)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users and social media operators use this skill to manage connected Instagram Business or Creator accounts, including publishing content, reviewing media performance, moderating comments, and handling existing DM conversations.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill requires OAuth access to a connected Instagram account.
\nMitigation: Confirm trust in ClawLink before connecting an account and disconnect the integration when access is no longer needed.
\nRisk: Publishing, commenting, messaging, deleting content, or changing messaging settings can affect a live Instagram account.
\nMitigation: Review previews carefully and require explicit user confirmation before write, messaging, or destructive operations.
\nRisk: The Instagram Graph API supports only Business or Creator accounts for the workflows described by this skill.
\nMitigation: Verify the connected account type before relying on publishing, insights, or messaging workflows.
\n\n\n## Reference(s):
\n- [ClawHub Instagram skill page](https://clawhub.ai/hith3sh/instagram-posts)
\n- [Instagram Graph API Overview](https://developers.facebook.com/docs/instagram-api)
\n- [Instagram Media Publishing API](https://developers.facebook.com/docs/instagram-api/reference/ig-media)
\n- [Instagram Insights API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/insights)
\n- [Instagram Messaging API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/conversations)
\n- [ClawLink](https://claw-link.dev)
\n- [ClawLink OpenClaw docs](https://docs.claw-link.dev/openclaw)
\n\n\n## Skill Output:
\n**Output Type(s):** [guidance, shell commands, configuration, API calls, text]
\n**Output Format:** [Markdown with inline shell commands and JSON tool parameters]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires a connected Instagram Business or Creator account through ClawLink OAuth; write, messaging, and destructive operations require explicit user confirmation.]
\n\n## Skill Version(s):
\n1.0.1 (source: server-resolved release evidence)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v0.1.1: 3 files, 6384 bytes\n\nFiles: skill-card.md (2878b), SKILL.md (15559b), _meta.json (134b)\n\nFile v0.1.1:SKILL.md\n\n---\nname: instagram-posts\ndescription: Manage Instagram Business and Creator accounts via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send DMs, and manage story content. Use this skill when users want to manage Instagram content, analyze engagement, or automate social media workflows.\n---\n\n# Instagram\n\nManage an Instagram Business or Creator account via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send direct messages, and monitor story content.\n\nThis skill uses [ClawLink](https://claw-link.dev) for hosted connection flows and credentials so you do not need to configure Instagram API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Instagram |\n|:---:|:---:|:---:|\n|  |  |  |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Instagram |\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Instagram Graph │\n│ (User Chat) │ │ (OAuth) │ │ (API v22) │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect IG │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Instagram│\n │ File │ │ Auth │ │ Business │\n └──────────┘ └──────────┘ └──────────┘\n```\n\n## Install\n\nInstall the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.\n\n```bash\nopenclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart\n```\n\nThen tell the user: \"OpenClaw has been restarted. Send `/new` as a standalone message to start a fresh chat, then ask for Instagram again.\"\n\n## Quick Start\n\n```bash\n# Get your Instagram account info\nclawlink_call_tool --tool \"instagram_get_user_info\" --params '{}'\n\n# List recent media posts\nclawlink_call_tool --tool \"instagram_get_ig_user_media\" --params '{}'\n\n# Get insights on a specific post\nclawlink_call_tool --tool \"instagram_get_ig_media_insights\" --params '{\"media_id\": \"MEDIA_ID\"}'\n```\n\n## Authentication\n\nAll Instagram tool calls are authenticated automatically by ClawLink using the user's connected Instagram Business or Creator account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every Instagram Graph API request on the user's behalf.\n\n### Getting Connected\n\n1. Install the ClawLink plugin (see Install above).\n2. Pair the plugin with `clawlink_begin_pairing` if it is not configured yet.\n3. Open https://claw-link.dev/dashboard?add=instagram and connect Instagram (requires a Business or Creator account).\n4. Call `clawlink_list_integrations` to verify the connection is active.\n\n## Connection Management\n\n### List Connections\n\n```bash\nclawlink_list_integrations\n```\n\n**Response:** Returns all connected integrations. Look for `instagram` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration instagram\n```\n\n**Response:** Returns the live tool catalog for Instagram.\n\n### Reconnect\n\nIf Instagram tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=instagram\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration instagram`\n\n## Security & Permissions\n\n- Access is scoped to the connected Instagram Business or Creator account only.\n- A Business or Creator account is required — personal Instagram accounts are not supported by the Instagram Graph API.\n- **All write operations require explicit user confirmation.** Before executing any publish, comment, or DM action, confirm the target resource and intended effect with the user.\n- Destructive actions (delete comment, delete message) are marked as high-impact and must be confirmed.\n- Content publishing is rate-limited by Instagram (25 posts per 24-hour window per account).\n\n## Tool Reference\n\n### Media Retrieval & Publishing\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_user_media` | List all media (posts, photos, videos, reels, carousels) published by the account | Read |\n| `instagram_get_ig_media` | Get details for a specific published media item including engagement metrics | Read |\n| `instagram_get_ig_media_children` | Get individual media items from a carousel/album post | Read |\n| `instagram_post_ig_user_media` | Create a media container for publishing (first step of two-step publish) | Write |\n| `instagram_post_ig_user_media_publish` | Publish a media container to the account (auto-waits for processing) | Write |\n| `instagram_create_carousel_container` | Create a draft carousel post with 2–10 images/videos | Write |\n\n### Insights & Analytics\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_user_insights` | Get account-level insights (profile views, reach, follower count) | Read |\n| `instagram_get_ig_media_insights` | Get per-media performance metrics (views, likes, comments, saves, shares) | Read |\n| `instagram_get_user_info` | Get profile details and statistics for the Business/Creator account | Read |\n| `instagram_get_ig_user_content_publishing_limit` | Check remaining publish quota before posting | Read |\n\n### Comments & Replies\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_media_comments` | List comments on a specific post with cursor-based pagination | Read |\n| `instagram_get_ig_comment_replies` | Get replies to a specific comment | Read |\n| `instagram_post_ig_media_comments` | Post a comment on a media item (300 chars max, 4 hashtags, 1 URL) | Write |\n| `instagram_post_ig_comment_replies` | Reply to an existing comment (300 chars max) | Write |\n| `instagram_delete_comment` | Delete a comment (only comments your account created) | Write |\n\n### Stories & Live\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_user_stories` | List active stories within the 24-hour story window | Read |\n| `instagram_get_ig_user_live_media` | Get live media during an active broadcast | Read |\n\n### Conversations & Messaging\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_list_all_conversations` | List all Instagram DM conversations | Read |\n| `instagram_get_conversation` | Get details of a specific DM conversation | Read |\n| `instagram_list_all_messages` | List messages in a specific DM thread | Read |\n| `instagram_send_text_message` | Send a text DM (requires prior conversation thread) | Write |\n| `instagram_send_image` | Send an image via DM | Write |\n| `instagram_mark_seen` | Mark messages as read in a DM thread | Write |\n| `instagram_get_page_conversations` | Get conversations for the connected Page | Read |\n\n### Messaging Configuration\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_messenger_profile` | Get ice breakers and messaging settings | Read |\n| `instagram_update_messenger_profile` | Configure ice breakers for the Instagram inbox | Write |\n| `instagram_delete_messenger_profile` | Remove messaging configuration | Write |\n\n### Mentions & Tags\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `instagram_get_ig_user_tags` | Get media where your account was tagged by others | Read |\n| `instagram_post_ig_user_mentions` | Reply to a mention of your account | Write |\n\n## Code Examples\n\n### Get account info and insights\n\n```bash\nclawlink_call_tool --tool \"instagram_get_user_info\" \\\n --params '{}'\n```\n\n### List recent posts with insights\n\n```bash\nclawlink_call_tool --tool \"instagram_get_ig_user_media\" \\\n --params '{}'\n```\n\n### Get insights for a specific post\n\n```bash\nclawlink_call_tool --tool \"instagram_get_ig_media_insights\" \\\n --params '{\"media_id\": \"MEDIA_ID\"}'\n```\n\n### Post a comment\n\n```bash\nclawlink_call_tool --tool \"instagram_post_ig_media_comments\" \\\n --params '{\"media_id\": \"MEDIA_ID\", \"text\": \"Great post! Thanks for sharing.\"}'\n```\n\n### Send a DM\n\n```bash\nclawlink_call_tool --tool \"instagram_send_text_message\" \\\n --params '{\"message\": \"Hi! Thanks for reaching out.\", \"conversation_id\": \"CONVERSATION_ID\"}'\n```\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Instagram is connected.\n2. Call `clawlink_list_tools --integration instagram` to see the live catalog.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `instagram`.\n5. If no Instagram tools appear, direct the user to https://claw-link.dev/dashboard?add=instagram.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ READ OPERATIONS (Safe) │\n│ list → get → search → describe → call │\n│ │\n│ Example: List media → Get insights → Show results │\n└─────────────────────────────────────────────────────────────┘\n │\n ▼\n┌─────────────────────────────────────────────────────────────┐\n│ WRITE OPERATIONS (Require Confirmation) │\n│ list → get → describe → preview → confirm → call │\n│ │\n│ Example: Preview comment → User approves → Execute │\n└─────────────────────────────────────────────────────────────┘\n```\n\n1. For unfamiliar tools, ambiguous requests, or any write action, call `clawlink_describe_tool` first.\n2. Use the returned guidance, schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups` to shape the call.\n3. Prefer read, list, search, and get operations before writes when that reduces ambiguity.\n4. For writes or anything marked as requiring confirmation, call `clawlink_preview_tool` first.\n5. Execute with `clawlink_call_tool`. Pass confirmation only after the preview matches the user's intent.\n6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## Notes\n\n- Only **Business** or **Creator** Instagram accounts are supported — personal accounts return permission errors.\n- Content publishing is limited to 25 API-published posts per 24-hour moving window per account.\n- Media container `creation_id`s expire in under 24 hours — publish promptly after creating a container.\n- Comments are limited to 300 characters, 4 hashtags, and 1 URL.\n- DMs can only be sent in existing conversation threads — new threads cannot be initiated via the API.\n- Insights data is only available for posts published within the last 2 years and requires at least 1,000 followers.\n- Instagram IDs in API responses use the format `1784140xxxxx` (not numeric strings).\n\n## Error Handling\n\n| Status / Error | Meaning |\n|----------------|---------|\n| Tool not found | The tool name does not exist in the current catalog. Verify with `clawlink_list_tools --integration instagram`. |\n| Missing connection | Instagram is not connected. Direct the user to https://claw-link.dev/dashboard?add=instagram. |\n| Permission error | The account is a personal Instagram profile, not a Business/Creator account. |\n| ` OAuthException` | Instagram OAuth token is invalid or expired. Reconnect Instagram. |\n| Rate limit exceeded | Publishing quota used. Wait or reduce publish frequency. |\n| Write rejected | User did not confirm a write action. Always confirm before executing writes. |\n\n### Troubleshooting: Tools Not Visible\n\n1. Check that the ClawLink plugin is installed:\n ```bash\n openclaw plugins list\n ```\n2. If the plugin is installed but tools are missing, tell the user to send `/new` as a standalone message to reload the catalog.\n3. If a fresh chat does not help, run:\n ```bash\n openclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\n openclaw gateway restart\n ```\n4. After restart, tell the user to send `/new` again and retry.\n\n### Troubleshooting: Permission Errors\n\n1. Confirm the Instagram account is a **Business** or **Creator** account, not personal.\n2. Verify the account is connected at https://claw-link.dev/dashboard?add=instagram.\n3. For messaging tools, ensure the Instagram account has the **Instagram Messaging** permission scope.\n\n## Resources\n\n- [Instagram Graph API Overview](https://developers.facebook.com/docs/instagram-api)\n- [Instagram Media Publishing API](https://developers.facebook.com/docs/instagram-api/reference/ig-media)\n- [Instagram Insights API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/insights)\n- [Instagram Messaging API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/conversations)\n- ClawLink: https://claw-link.dev\n- ClawLink Docs: https://docs.claw-link.dev/openclaw\n- ClawLink Verification: https://claw-link.dev/verify\n\n## Related Skills\n\n- [LinkedIn Social](https://clawhub.ai/hith3sh/linkedin-social) — For LinkedIn page and post management\n- [Twitter](https://clawhub.ai/hith3sh/twitter) — For Twitter/X post management and analytics\n- [Facebook Pages](https://clawhub.ai/hith3sh/facebook-pages) — For Facebook Page management\n\n---\n\n**Powered by [ClawLink](https://claw-link.dev)** — an integration hub for OpenClaw\n\n\n\nFile v0.1.1:_meta.json\n\n{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"instagram-posts\",\n \"version\": \"0.1.1\",\n \"publishedAt\": 1780839116653\n}\n\nFile v0.1.1:skill-card.md\n\n## Description:
\nManage Instagram Business and Creator accounts via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send DMs, and manage story content.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[hith3sh](https://clawhub.ai/user/hith3sh)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users, social media operators, and developers use this skill to manage Instagram Business or Creator accounts, including publishing content, reviewing media and insights, moderating comments, and handling existing DM conversations.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill relies on OAuth credentials for a connected Instagram account.
\nMitigation: Confirm the user trusts ClawLink to handle OAuth and review the Meta/Instagram permissions during connection.
\nRisk: Publishing, comments, DMs, message-read changes, deletes, and messaging-profile updates can change account state.
\nMitigation: Preview the target resource and intended effect, then require explicit user confirmation before executing account-changing actions.
\nRisk: Personal Instagram accounts are not supported by the Instagram Graph API.
\nMitigation: Use the skill only with Instagram Business or Creator accounts and verify the connected integration before making tool calls.
\n\n\n## Reference(s):
\n- [ClawHub skill listing](https://clawhub.ai/hith3sh/instagram-posts)
\n- [Instagram Graph API Overview](https://developers.facebook.com/docs/instagram-api)
\n- [Instagram Media Publishing API](https://developers.facebook.com/docs/instagram-api/reference/ig-media)
\n- [Instagram Insights API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/insights)
\n- [Instagram Messaging API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/conversations)
\n- [ClawLink OpenClaw docs](https://docs.claw-link.dev/openclaw)
\n- [ClawLink verification](https://claw-link.dev/verify)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]
\n**Output Format:** [Markdown with inline shell commands and JSON tool parameters]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [May propose Instagram Graph API actions and ClawLink tool calls; write actions should be previewed and explicitly confirmed before execution.]
\n\n## Skill Version(s):
\n0.1.1 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v0.1.0: 3 files, 3495 bytes\n\nFiles: skill-card.md (2308b), SKILL.md (5124b), _meta.json (134b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: instagram-posts\ndescription: Publish content, manage comments, get insights, and handle messaging on Instagram — powered by ClawLink.\n---\n\n# Instagram via ClawLink\n\nWork with Instagram from chat — publish content, manage comments, get insights, and handle messaging.\n\nPowered by [ClawLink](https://claw-link.dev), an integration hub for OpenClaw that handles hosted connection flows and credentials so you don't need to configure Instagram API access yourself.\n\n## Quick start\n\n1. Install the verified ClawLink plugin: `openclaw plugins install clawhub:clawlink-plugin`\n2. Start a fresh OpenClaw chat if the plugin was just installed and ClawLink tools are not visible yet\n3. If ClawLink is not configured, call `clawlink_begin_pairing`\n4. Tell the user to open the returned pairing URL, sign in to ClawLink if needed, and approve the device\n5. After the user confirms approval, call `clawlink_get_pairing_status`\n6. Tell the user to connect Instagram at [claw-link.dev/dashboard?add=instagram](https://claw-link.dev/dashboard?add=instagram)\n7. When the user confirms Instagram is connected, call `clawlink_list_integrations` and then `clawlink_list_tools` with the `instagram` integration slug\n\n## Setup details\n\n### Installing the plugin\n\nIf the ClawLink plugin is not installed yet, tell the user to run:\n\n```\nopenclaw plugins install clawhub:clawlink-plugin\n```\n\nIf the current chat started before the plugin was installed and ClawLink tools are still unavailable, tell the user to start a fresh chat so OpenClaw reloads the plugin tool catalog.\n\n### Pairing ClawLink\n\nIf ClawLink reports that the plugin is not configured, the plugin has not been paired with the user's ClawLink account yet.\n\n1. Call `clawlink_begin_pairing`.\n2. Tell the user to open the returned pairing URL in their browser.\n3. The user signs in to ClawLink if needed and approves the OpenClaw device.\n4. After the user confirms approval, call `clawlink_get_pairing_status` to finish local setup.\n\nThe resulting device credential is stored locally in OpenClaw's plugin config and is only sent to `claw-link.dev`. The user should not paste raw credentials into chat.\n\n### Connecting Instagram\n\nTell the user to open https://claw-link.dev/dashboard?add=instagram and connect Instagram there. The page opens the add-connection panel filtered to Instagram. ClawLink's hosted page runs the Instagram OAuth flow — the user clicks through the login and authorization screen. When they confirm it is done, call `clawlink_list_integrations` to verify, then call `clawlink_list_tools` with integration `instagram`.\n\n## Using Instagram tools\n\nClawLink provides tools dynamically based on what the user has connected. You do not need to know tool names or schemas in advance.\n\n### Discovery\n\n1. Call `clawlink_list_integrations` to confirm Instagram is connected.\n2. Call `clawlink_list_tools` with integration `instagram`.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `instagram`.\n5. If no Instagram tools appear, direct the user to https://claw-link.dev/dashboard?add=instagram.\n\n### Execution\n\n1. Call `clawlink_describe_tool` before using an unfamiliar tool, before any write, or when the request is ambiguous.\n2. Use the returned schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups`.\n3. Prefer read, list, search, and get operations before writes.\n4. For writes or anything marked as requiring confirmation, call `clawlink_preview_tool` first, then confirm with the user.\n5. Execute with `clawlink_call_tool`.\n6. If it fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## What you can do\n\nTypical Instagram tasks (actual availability depends on the user's connected account, permissions, scopes, and current ClawLink tool catalog):\n\n- Get user info and insights\n- List media items and stories\n- Get media details and children (carousel items)\n- Get media insights and comments\n- Create and publish media containers\n- Create carousel containers\n- Post comments on media\n- View comment replies\n- Check content publishing limits\n\n## Rules\n\n- Always use ClawLink tools for Instagram. Do not ask the user for separate Instagram credentials.\n- Do not claim a capability is missing without checking the live ClawLink catalog in the current turn.\n- Do not invent slash commands or ask the user to paste raw credentials.\n- Ask for confirmation before destructive, external-facing, or bulk write actions.\n- If Instagram is not connected, direct the user to https://claw-link.dev/dashboard?add=instagram.\n- Never echo or repeat the user's ClawLink credential.\n\n## Resources\n\n- ClawLink: https://claw-link.dev\n- ClawLink Docs: https://docs.claw-link.dev/openclaw\n- ClawLink Verification: https://claw-link.dev/verify\n- ClawLink Source: https://github.com/hith3sh/clawlink\n- Instagram Graph API: https://developers.facebook.com/docs/instagram-api/\n\nFile v0.1.0:_meta.json\n\n{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"instagram-posts\",\n \"version\": \"0.1.0\",\n \"publishedAt\": 1777822317685\n}\n\nFile v0.1.0:skill-card.md\n\n## Description:
\nPublish content, manage comments, get insights, and handle messaging on Instagram - powered by ClawLink.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[hith3sh](https://clawhub.ai/user/hith3sh)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users and developers use this skill to connect Instagram through ClawLink, discover available Instagram tools, and perform account, content, comment, insight, and messaging workflows with user confirmation for sensitive actions.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Delegated Instagram access can expose or modify account content through approved actions.
\nMitigation: Review OAuth permissions, connect only the intended Instagram account, and approve previews only for posts, comments, messages, or bulk actions the user actually wants performed.
\nRisk: Available Instagram capabilities can vary by connected account, permissions, scopes, and current ClawLink tool catalog.
\nMitigation: Confirm the Instagram integration and inspect the live ClawLink tool catalog before claiming or using a capability.
\n\n\n## Reference(s):
\n- [ClawLink](https://claw-link.dev)
\n- [ClawLink OpenClaw Docs](https://docs.claw-link.dev/openclaw)
\n- [ClawLink Verification](https://claw-link.dev/verify)
\n- [Instagram Graph API](https://developers.facebook.com/docs/instagram-api/)
\n- [ClawHub Skill Page](https://clawhub.ai/hith3sh/instagram-posts)
\n\n\n## Skill Output:
\n**Output Type(s):** [Guidance, Shell commands, Configuration instructions, API calls]
\n**Output Format:** [Markdown guidance with inline shell commands and ClawLink tool-call instructions]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Uses the live ClawLink tool catalog as the source of truth for available Instagram actions.]
\n\n## Skill Version(s):
\n0.1.0 (source: server release metadata)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
","readmeExcerpt":"Skill: Instagram Owner: hith3sh Summary: Manage Instagram Business and Creator accounts via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send DMs, and manage story content. Use this skill when users want to manage Instagram content, analyze engagement, or automate social media workflows. Tags: latest:1.0.7 Version history: v1.0.7 | 2026-10-03T19:40:26.934Z | us","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Instagram Graph │\n│ (User Chat) │ │ (OAuth) │ │ (API v22) │\n└─────────────────┘ └──────────────┘ └──────────────────┘\n │ │ │\n │ 1. Install Plugin │ │\n │ 2. Pair Device │ │\n │ 3. Connect IG │ │\n │ │ 4. Secure Token │\n │ │ 5. Proxy Requests │\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ SKILL │ │ Dashboard│ │ Instagram│\n │ File │ │ Auth │ │ Business │\n └──────────┘ └──────────┘ └──────────┘"},{"language":"bash","snippet":"openclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart"},{"language":"bash","snippet":"# Get your Instagram account info\nclawlink_call_tool --tool \"instagram_get_user_info\" --params '{}'\n\n# List recent media posts\nclawlink_call_tool --tool \"instagram_get_ig_user_media\" --params '{}'\n\n# Get insights on a specific post\nclawlink_call_tool --tool \"instagram_get_ig_media_insights\" --params '{\"media_id\": \"MEDIA_ID\"}'"},{"language":"bash","snippet":"clawlink_list_integrations"},{"language":"bash","snippet":"clawlink_list_tools --integration instagram"},{"language":"bash","snippet":"clawlink_call_tool --tool \"instagram_get_user_info\" \\\n --params '{}'"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: instagram-posts\ndescription: Manage Instagram Business and Creator accounts via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send DMs, and manage story content. Use this skill when users want to manage Instagram content, analyze engagement, or automate social media workflows.\n---\n\n# Instagram\n\n\n\nManage an Instagram Business or Creator account via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send direct messages, and monitor story content.\n\nThis skill uses [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=instagram-posts) for hosted connection flows and credentials so you do not need to configure Instagram API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Instagram |\n|:---:|:---:|:---:|\n|  |  | *Connect Instagram from the ClawLink dashboard* |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Instagram |\n\n## No Account Needed: Public Instagram Data\n\nRead any public Instagram profile, post, reel or hashtag, see followers and comments, and get transcripts of reels, without connecting an Instagram account. These tools work as soon as the plugin is paired: there is nothing to connect, and each call is paid from ClawLink credit (most cost a fraction of a cent; new accounts get $0.50 free).\n\n| Tool | What it returns | Price |\n|------|-----------------|-------|\n| `instagramdata_user_profile` | Public Instagram profile by username: follower, following and post counts, bio, category, verified flag | $0.00282 |\n| `instagramdata_user_posts` | Recent public posts of an Instagram account with likes, comments and captions | $0.00282 |\n| `instagramdata_user_reels` | Recent public reels of an Instagram account with play counts | $0.00282 |\n| `instagramdata_post_comments` | Comments on an Instagram post or reel | $0.003 |\n| `instagramdata_hashtag_posts` | Public posts under an Instagram hashtag | $0.00282 |\n| `instagramdata_transcript` | Spoken-word transcript of an Instagram reel or video post | $0.00282 |\n\nUse the connected-account tools above for the user's own Instagram; use these for anyone else's public content. More: [Creator Scout](https://clawhub.ai/hith3sh/skills/creator-scout), [Transcribe Any Video](https://clawhub.ai/hith3sh/skills/transcribe-any-video).\n\n## How It Works\n\n```\n┌─────────────────┐ ┌──────────────┐ ┌──────────────────┐\n│ OpenClaw │────▶│ ClawLink │────▶│ Instagram Graph │\n│ (User Chat) │ │ (OAuth) │ │ (API v22) │\n└─────────────────┘ └──────────────┘ "},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n \"slug\": \"instagram-posts\",\n \"version\": \"1.0.7\",\n \"publishedAt\": 1791056426934\n}"},{"path":"skill-card.md","content":"## Description:\n\nManage Instagram Business and Creator accounts by publishing content, reviewing insights, moderating comments, and handling direct messages.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[hith3sh](https://clawhub.ai/user/hith3sh)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nSocial media managers and other external users can manage connected Instagram Business or Creator accounts, review engagement, and look up public Instagram content.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Publishing, messaging, comment deletion, and inbox configuration can change the connected account or contact other users.\n\nMitigation: Preview the intended action and confirm its target and effect with the user before executing any write.\n\nRisk: Public-content lookups incur charges against the user's ClawLink credit.\n\nMitigation: Disclose the credit cost before making public-data lookups.\n\n## Reference(s):\n\n- [Instagram skill on ClawHub](https://clawhub.ai/hith3sh/skills/instagram-posts)\n- [ClawLink OpenClaw documentation](https://docs.claw-link.dev/openclaw)\n- [Instagram Graph API overview](https://developers.facebook.com/docs/instagram-api)\n- [Instagram media publishing API](https://developers.facebook.com/docs/instagram-api/reference/ig-media)\n- [Instagram insights API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/insights)\n- [Instagram messaging API](https://developers.facebook.com/docs/instagram-api/reference/ig-user/conversations)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Guidance, Shell commands]\n\n**Output Format:** [Markdown with inline shell commands and account data summaries]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Public-data lookups use ClawLink credit; account management requires a connected Business or Creator account.]\n\n## Skill Version(s):\n\n1.0.7 (source: ClawHub release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Manage Instagram Business and Creator accounts via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send DMs, and manage story content. Use this skill when users want to manage Instagram content, analyze engagement, or automate social media workflows. Skill: Instagram Owner: hith3sh Summary: Manage Instagram Business and Creator accounts via the Instagram Graph API. Publish posts and carousels, retrieve media and insights, moderate comments, send DMs, and manage story content. Use this skill when users want to manage Instagram content, analyze engagement, or automate social media workflows. Tags: latest:1.0.7 Version history: v1.0.7 | 2026-10-03T19:40:26.934Z | us","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1176,"uniquenessScore":49,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T02:49:21.083Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T02:49:21.083Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T12:54:56.448Z","emptyReason":null},"items":[{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}