| name | instagram-publish |
| description | Publish posts and reels to Instagram via Meta Graph API. Supports single images, carousels (up to 10), and reels. Uses content container pattern. Requires Meta OAuth2 token with instagram_basic and instagram_content_publish permissions. |
| metadata | {"openclaw":{"emoji":"📸","requires":{"bins":["python3"]}}} |
Instagram 发布（instagram-publish）
通过 Meta Graph API 发布内容到 Instagram，支持单图、轮播（最多 10 张）和 Reels。使用 Content Container 模式。需要 Instagram Professional 账户关联到 Facebook Page。
前置条件
- Instagram Professional 账户（Business 或 Creator）
- 关联 Facebook Page
- Meta Developer 应用，获取
instagram_basic + instagram_content_publish 权限
- 长效 Page Access Token
配置
保存到 ~/.openclaw/credentials/instagram_config.json：
{
"page_access_token": "your_long_lived_page_token",
"ig_user_id": "your_ig_business_account_id"
}
使用方式
单图帖子：
python3 ./skills/instagram-publish/scripts/publish_instagram.py \
--caption "描述 #hashtag1 #hashtag2" \
--images photo.jpg \
--mode feed
轮播帖子：
python3 ./skills/instagram-publish/scripts/publish_instagram.py \
--caption "描述" \
--images img1.jpg img2.jpg img3.jpg \
--mode carousel
Reel：
python3 ./skills/instagram-publish/scripts/publish_instagram.py \
--caption "描述" \
--video reel.mp4 \
--mode reel
参数说明
| 参数 | 必填 | 说明 |
|---|
--caption | 是 | 描述，最多 2200 字，最多 30 个 hashtag |
--mode | 是 | feed/carousel/reel |
--images | feed/carousel必填 | 图片 URL 列表，carousel 最多 10 张 |
--video | reel必填 | 视频 URL，Reels 建议 9:16，≤90s |
错误处理
| 错误 | 原因 | 处理 |
|---|
| AUTH_REQUIRED | Token 失效 | 更新 Token |
| UPLOAD_FAILED | 容器创建失败 | 检查图片 URL 可访问性 |
| MEDIA_PROCESSING | 媒体处理中 | 轮询状态等待 |
| RATE_LIMIT | API 限制 | 等待后重试 |
注意：Instagram API 发布只支持 URL 形式的媒体，不支持本地文件上传。需要先将图片/视频上传到可公开访问的 URL。
发布记录（强制）
发布成功后，必须立即调用 published-track 技能记录发布信息：
./skills/published-track/scripts/record.sh \
--platform instagram \
--title "标题" \
--content-type post \
--source-folder "<原始文件夹路径>" \
--publish-url "<发布URL>" \
--publish-date "$(date +%Y-%m-%d)"
--source-folder 为原始内容所在的相对路径（如 output_articles/xxx 或 output_videos/xxx）。
--publish-url 为发布后获得的 URL，若发布失败则留空并在 --notes 中注明原因。
执行 ./skills/published-track/scripts/init-db.sh（幂等，重复执行无副作用）。
