Instagram

通过 Instagram Graph API 管理 Instagram 商务账号或创作者账号。发布帖子与轮播帖（carousels）、获取媒体内容与数据洞察（insights）、审核评论、发送站内信（Direct Messages），以及监控快拍（Story）内容。

本技能使用 ClawLink 提供托管的连接流程和凭证管理，因此您无需自行配置 Instagram API 访问权限。

三步完成设置

工作原理

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│ Instagram Graph  │
│   (用户聊天)    │     │   (OAuth)    │     │   (API v22)     │
└─────────────────┘     └──────────────┘     └──────────────────┘
         │                       │                       │
         │  1. 安装插件         │                       │
         │  2. 绑定设备         │                       │
         │  3. 连接 Instagram   │                       │
         │                   │  4. 获取安全 Token     │
         │                   │  5. 代理请求           │
         │                   │                       │
         ▼                   ▼                       ▼
   ┌──────────┐      ┌──────────┐           ┌──────────┐
   │  SKILL   │      │ 控制台   │           │ Instagram│
   │  文件     │      │ 认证     │           │ 商务账号 │
   └──────────┘      └──────────┘           └──────────┘

安装

从 ClawHub 安装经认证的 ClawLink 插件。用户确认后，请完成全部设置流程，以便在下一次 OpenClaw 聊天中可见 ClawLink 工具。

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

然后告知用户：“OpenClaw 已重启。请单独发送一条 /new 消息以开启全新会话，随后再次提出 Instagram 相关需求。”

快速上手

# 获取您的 Instagram 账号信息
clawlink_call_tool --tool "instagram_get_user_info" --params '{}'

# 列出最近发布的媒体内容
clawlink_call_tool --tool "instagram_get_ig_user_media" --params '{}'

# 获取某条特定帖子的数据洞察
clawlink_call_tool --tool "instagram_get_ig_media_insights" --params '{"media_id": "MEDIA_ID"}'

身份验证

所有 Instagram 工具调用均由 ClawLink 自动完成身份验证，使用的是用户已连接的 Instagram 商务账号或创作者账号。

聊天中无需提供 API 密钥。 ClawLink 安全地存储 OAuth Token，并代表用户将其注入每一次 Instagram Graph API 请求中。

建立连接

1. 安装 ClawLink 插件（参见上方“安装”部分）。
2. 若插件尚未配置，请使用 clawlink_begin_pairing 启动配对流程。
3. 访问 https://claw-link.dev/dashboard?add=instagram 并连接 Instagram（需为商务账号或创作者账号）。
4. 调用 clawlink_list_integrations 验证连接是否已激活。

连接管理

列出所有连接

clawlink_list_integrations

响应：返回所有已连接的集成服务。请在列表中查找 instagram。

验证连接状态

clawlink_list_tools --integration instagram

响应：返回 Instagram 的实时工具目录。

重新连接

若 Instagram 工具缺失或连接显示错误：

1. 引导用户访问 https://claw-link.dev/dashboard?add=instagram
2. 待用户确认后，调用 clawlink_list_integrations 验证连接状态
3. 再调用 clawlink_list_tools --integration instagram

安全与权限

• 访问范围严格限定于已连接的 Instagram 商务账号或创作者账号。
• 必须使用商务账号或创作者账号——Instagram Graph API 不支持个人账号。
• 所有写入操作均需用户明确确认。 在执行任何发布、评论或站内信操作前，须向用户确认目标资源及预期效果。
• 破坏性操作（如删除评论、删除消息）被标记为高影响操作，必须经过用户确认。
• 内容发布受 Instagram 速率限制（每个账号每 24 小时最多发布 25 条）。

工具参考

媒体获取与发布

数据洞察与分析

评论与回复

快拍（Stories）与直播（Live）

会话与消息

消息配置

提及（Mentions）与标签（Tags）

代码示例

获取账号信息与洞察数据

clawlink_call_tool --tool "instagram_get_user_info" 
  --params '{}'

列出近期帖子及其洞察数据

clawlink_call_tool --tool "instagram_get_ig_user_media" 
  --params '{}'

获取某条特定帖子的洞察数据

clawlink_call_tool --tool "instagram_get_ig_media_insights" 
  --params '{"media_id": "MEDIA_ID"}'

发布评论

clawlink_call_tool --tool "instagram_post_ig_media_comments" 
  --params '{"media_id": "MEDIA_ID", "text": "Great post! Thanks for sharing."}'

发送站内信

clawlink_call_tool --tool "instagram_send_text_message" 
  --params '{"message": "Hi! Thanks for reaching out.", "conversation_id": "CONVERSATION_ID"}'

发现工作流（Discovery Workflow）

1. 调用 clawlink_list_integrations 确认 Instagram 是否已连接。
2. 调用 clawlink_list_tools --integration instagram 查看实时工具目录。
3. 以该返回列表为准，切勿猜测或假设工具是否存在。
4. 若用户描述了某项能力但无法确定具体工具，请使用短查询配合 clawlink_search_tools，并指定集成名称为 instagram。
5. 若未返回任何 Instagram 工具，请引导用户访问 https://claw-link.dev/dashboard?add=instagram。

执行工作流（Execution Workflow）

┌─────────────────────────────────────────────────────────────┐
│  读取操作（安全）                                             │
│  list → get → search → describe → call                      │
│                                                             │
│  示例：列出媒体 → 获取洞察 → 展示结果                       │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│  写入操作（需用户确认）                                       │
│  list → get → describe → preview → confirm → call           │
│                                                             │
│  示例：预览评论 → 用户批准 → 执行                           │
└─────────────────────────────────────────────────────────────┘

1. 对于不熟悉的工具、模糊请求或任何写入操作，请先调用 clawlink_describe_tool。
2. 依据返回的说明、参数 Schema、whenToUse、askBefore、safeDefaults、examples 和 followups 构建后续调用。
3. 在可能降低歧义的前提下，优先执行读取、列举、搜索和获取类操作，再执行写入操作。
4. 对于写入操作或任何标记为“需确认”的操作，请先调用 clawlink_preview_tool。
5. 使用 clawlink_call_tool 执行；仅当预览结果与用户意图一致时，才传入确认标识。
6. 若工具调用失败，请如实反馈真实错误信息。不得虚构结果，也不得将失败简单归因为“功能缺失”，除非实时目录明确不支持该能力。

注意事项

• 仅支持 商务账号 或 创作者账号 —— 个人账号将返回权限错误。
• 内容发布受限制：每个账号每 24 小时滚动窗口内最多通过 API 发布 25 条内容。
• 媒体容器的 creation_id 在 24 小时内过期，请在创建容器后尽快完成发布。
• 评论内容限制为最多 300 字符、4 个话题标签、1 个 URL。
• 站内信只能在已有会话线程中发送，无法通过 API 发起新会话线程。
• 洞察数据仅适用于过去两年内发布的帖子，且要求账号至少拥有 1,000 名关注者。
• API 响应中的 Instagram ID 格式为 1784140xxxxx（非纯数字字符串）。

错误处理

排查：工具不可见

1. 检查 ClawLink 插件是否已安装：

   openclaw plugins list
   

2. 若插件已安装但工具缺失，请告知用户单独发送 /new 消息以重新加载工具目录。
3. 若新会话仍未解决，请运行：

   openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
   openclaw gateway restart
   

4. 重启后，请告知用户再次发送 /new 并重试。

排查：权限错误

1. 确认 Instagram 账号为 商务账号 或 创作者账号，而非个人账号。
2. 在 https://claw-link.dev/dashboard?add=instagram 上确认账号已成功连接。
3. 对于消息类工具，请确保 Instagram 账号已启用 Instagram Messaging 权限范围。

参考资料

• Instagram Graph API 概览
• Instagram 媒体发布 API
• Instagram 数据洞察 API
• Instagram 消息 API
• ClawLink：https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=instagram-posts
• ClawLink 文档：https://docs.claw-link.dev/openclaw
• ClawLink 认证页面：https://claw-link.dev/verify

相关技能

• LinkedIn 社交 — 用于 LinkedIn 页面与帖子管理
• Twitter — 用于 Twitter/X 帖子管理与数据分析
• Facebook Pages — 用于 Facebook 页面管理

由 ClawLink 提供支持 — OpenClaw 的集成中心