Instagram Post

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install instagram-post
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 instagram-post。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Instagram Post 允许兼容的 AI 智能体通过 PostWire 批准的 Instagram 集成发布或安排 Instagram 内容。它支持单张照片、最多 10 张图片的轮播图，以及作为 Reels 发布的竖屏视频。Openclaw Skills 可以通过 MCP 工具或 HTTPS 请求使用该工作流，无需浏览器自动化、共享密码或 Meta 开发者应用。
该技能引导智能体检查账户连接、准备媒体和说明文字、与用户确认详情并提交帖子。它还可以交叉发布到 Facebook、TikTok 或 YouTube Shorts。需要一个 PostWire 账户和一个 Instagram 商业或创作者账户；无法通过官方工具发布到个人 Instagram 账户。

应用场景

将单张照片发布到已连接的 Instagram 商业或创作者账户。
从多张图片或视频创建轮播图，最多包含 10 个媒体项目。
将竖屏 9:16 视频发布为 Instagram Reel。
为指定时间或下一个可用时段安排帖子。
将相同的媒体交叉发布到 Facebook、TikTok 或 YouTube Shorts，并附带特定平台的说明文字。
当媒体没有公开 URL 时，通过 PostWire 从用户的设备上传文件。
检查 Instagram 是否已连接、识别相关品牌，并在发帖前解决连接或批准问题。

工作原理

检查连接： 使用 PostWire MCP 工具或 REST API 检查账户和已连接的品牌。如果 Instagram 未连接，请创建一个 Instagram 连接链接。账户必须是商业或创作者账户。
准备媒体： 提供公开的图片或视频 URL、用于轮播图的多达 10 个媒体 URL 列表，或创建一个上传链接以便用户上传本地文件。对于轮播图，使用一致的宽高比；1080 × 1350 的 4:5 比例占用更多动态消息空间。
起草说明文字： 保持在 Instagram 的 2,200 字符限制内，将核心吸引点放在前 125 个字符中，使用清晰的下一步行动或问题，并在末尾放置 3 到 5 个相关的标签。说明文字中的 Instagram 链接无法点击，因此请在适当时建议查看个人主页链接。
与用户确认： 显示媒体列表、说明文字及其字符数以及发帖时间。提交前征得明确确认；没有“是”的回复切勿发布。
发布或安排： 调用 post_to_social 立即发布，或使用带有 run_at 和 timezone 的 schedule_post 进行安排。当账户连接到多个品牌时，请包含 brand_id。
检查结果： 尊重返回的状态，例如 pending_approval、media_required、not_connected 和 ambiguous_brand。对于 Reels，使用返回的 ID 轮询 get_post_status，直到永久链接可用，然后与用户共享该链接。

配置指南

创建一个 PostWire 账户。该技能描述的是一个无需信用卡的免费账户。
连接 Instagram 商业或创作者账户。官方工具不支持发布到个人账户。如有需要，请在 Instagram 的“设置”→“账户类型和工具”中切换账户类型。
按照原始 PostWire SKILL.md 中的当前说明添加 PostWire 的 MCP 服务器：https://postwire.io/SKILL.md。或者，使用 REST API 并在环境中设置 POSTWIRE_API_KEY。切勿打印或泄露密钥。
发帖前检查账户连接。如果 Instagram 未连接，请使用 MCP 工具或 REST 端点创建一个连接链接。
以公开 HTTPS URL 的形式提供媒体，或使用 PostWire 的上传链接流程上传本地文件。聊天中附加的文件无法自动供 PostWire 使用。
REST API 快速检查：
export POSTWIRE_API_KEY="your-postwire-api-key"
curl -sS https://postwire.io/api/me
-H "Authorization: Bearer ${POSTWIRE_API_KEY}"
-H "Content-Type: application/json"
-H "X-PostWire-Source: mcp-sk-instagram" 如有必要，创建一个 Instagram 连接链接：
curl -sS https://postwire.io/api/connect-link
-X POST
-H "Authorization: Bearer ${POSTWIRE_API_KEY}"
-H "Content-Type: application/json"
-H "X-PostWire-Source: mcp-sk-instagram"
-d '{"platform":"instagram"}' 对于 REST 发布和安排，请使用 POST /api/post 和 POST /api/schedule。包含所需的媒体、平台和每个平台的说明文字字段；安排发帖还需 run_at 和 timezone。

数据架构

该技能将媒体、说明文字、平台选择和安排详情发送给 PostWire；它不指定本地数据库或生成的文件布局。
数据 格式或约束 用途
photo_url / video_url 公开 HTTPS 媒体 URL 提供单张图片或视频。
media 多达 10 个项目的数组，每个项目包含一个 URL 和可选的 type（例如 video） 提供轮播图项目。
media_url 上传达到 done 后返回的 URL 引用通过面向用户的上传流程上传的文件。
per_platform 包含平台特定 text 的平台键控对象 保存 Instagram 及任何交叉发布目的地的说明文字。
platforms 诸如 instagram、facebook、tiktok 或 youtube Shorts 目的地之类的列表 选择发布目的地。
brand_id 品牌标识符（必要时） 如果连接了多个品牌，选择正确的品牌。
run_at / timezone 带有偏移量或 next_slot 的 ISO 时间戳，加上时区 定义已安排帖子的时间。
帖子状态和永久链接 返回的帖子 ID 和状态；处理后可能会提供永久链接 支持状态检查和共享发布的链接。
说明文字最多限制 2,200 个字符。对于轮播图，请保持媒体宽高比一致。API 错误包括 code、what 和 fix；请查阅 https://postwire.io/docs/errors.md 获取完整的错误代码参考。

高级特性

MCP 和 REST 支持：
适用于可以调用 MCP 工具或发出 HTTPS 请求的兼容智能体，包括 OpenClaw 和其他列出的编码智能体。
定时发布：
按照带偏移量的 ISO 时间戳安排，或使用带时区的
next_slot
。
跨平台分发：
添加 Facebook、TikTok 或 YouTube Shorts 作为目的地，并为每个平台提供说明文字。TikTok 还要求所有者的隐私选择。
品牌选择：
当 Instagram 在多个品牌下连接时，指定
brand_id
；处理
ambiguous_brand
而不是盲目猜测。
审批感知工作流：
如果结果是
pending_approval
，请告知用户谁需要批准它，且不要重新发送帖子。
Reel 状态轮询：
发布调用返回后，Reel 可能仍在处理中；轮询返回的 ID，直到永久链接准备就绪。
套餐限制透明度：
在免费套餐中，一个帖子可以分发到两个网络——列出的前两个。Starter 套餐可以分发到所有选定的网络。报告受限制约束的任何目的地，切勿尝试绕过它。
安全发布控制：
绝不使用浏览器自动化或请求用户的 Instagram 密码，且在没有用户明确确认的情况下绝不发布。

name: instagram-post description: "Publish or schedule Instagram posts from your AI agent: a single photo, a carousel of up to 10 images, or a Reel, with a caption written for Instagram, through Instagram's official API (business or creator account, no Meta developer app, no password sharing, no browser bots). Returns the live post link. Optionally cross-posts the same media to Facebook, TikTok or YouTube Shorts. Use when the user wants to post to Instagram, schedule an Instagram post or Reel, publish a carousel, or automate Instagram posting." license: MIT-0
compatibility: Any agent that can call MCP tools or make HTTPS requests (Claude Code, the Claude app, Codex, Cursor, OpenClaw, Gemini CLI, VS Code Copilot). Needs a PostWire account (free, no card) with an Instagram business or creator account connected.