PostPlanify

安装指南

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

什么是

PostPlanify 将 AI 代理连接到 PostPlanify REST API，使其能够在 Instagram、Facebook、X、LinkedIn、TikTok、YouTube、Threads、Pinterest、Bluesky 和 Google Business Profile 上安排发布、发布、编辑和查看社交媒体帖子。它还可以上传媒体、获取帖子和账户分析数据，以及阅读或回复受支持的评论和 Google 评价。
在 Openclaw Skills 中，PostPlanify 专为拥有 PostPlanify 账户和 API 访问权限、希望管理社交渠道的用户打造。它仅使用 curl 发送 HTTPS 请求；它不是撰写标题的工具，也不提供一般性的社交媒体建议。

应用场景

将已批准的帖子安排发布到选定的社交账户，或立即发布。
上传图片或视频，或重复使用 PostPlanify 媒体库中的媒体。
检查已安排和已发布的帖子，然后编辑、取消或删除符合条件的项目。
查看工作区、账户或趋势分析数据，了解社交媒体表现。
阅读评论和 Google 评价，或准备并发送已批准的公开回复。

工作原理

找到用户的工作区，并根据平台、账户名称或自定义标签匹配所请求的社交账户。如果匹配结果不明确，请询问用户指的是哪个账户。
如果帖子需要媒体，请通过公开 URL 或本地文件上传，或在媒体库中查找现有项目。轮播帖上传的媒体应保持预期的显示顺序。
使用工作区 ID、社交账户 ID、说明文字或媒体，以及未来的 scheduledAt 时间戳创建帖子。针对多个账户时，每个账户分别创建一个帖子，并根据平台要求调整内容。
检查返回的帖子及其状态。之后可获取其详细信息，以检查发布日志和同步的指标。
对于后续任务，使用相关 API 操作列出或编辑已安排的帖子、取消或删除项目、获取分析数据或阅读评论。执行破坏性操作或发布公开回复前，必须取得明确批准。

配置指南

在 https://postplanify.com/dashboard/api-keys 创建 PostPlanify API key。密钥以 sk_live_ 开头。
确保 PostPlanify 账户或工作区通过 Premium 或更高级别的方案拥有 API 访问权限。
在代理的环境中设置 POSTPLANIFY_API_KEY。切勿在帖子、回复、日志或面向用户的输出中暴露密钥。
确认系统已提供 curl；无需安装其他软件。
测试身份验证：
curl -s https://api.postplanify.com/api/v1/me
-H "Authorization: Bearer $POSTPLANIFY_API_KEY" 使用 https://api.postplanify.com/api/v1 作为 API 基础 URL，并在每个请求中发送 bearer authorization header。如果 API 访问权限未启用，调用将返回 403 SUBSCRIPTION_INACTIVE。

数据架构

此技能向 PostPlanify API 发送 HTTPS 请求；它不描述本地数据库，也不生成本地数据文件。成功响应使用 { "ok": true, "data": ... }，列表端点会包含分页信息；错误响应则使用 { "ok": false, "error": { "code": "...", "message": "..." } }。
资源 关键字段与组织方式
工作区和账户 工作区包含 workspaceId，以及带有 id、platform、accountName 和 customLabel 的 socialAccounts。
帖子 使用 workspaceId、socialAccountId、caption、scheduledAt 和可选的 mediaIds；如果有可用数据，响应会包含状态、日志和指标。每个帖子仅面向一个社交账户。
媒体 上传后会返回媒体 id，供 mediaIds 使用。支持的格式包括 JPEG、PNG、GIF、WebP、MP4、MOV 和 PDF，最大 100 MB。
分析数据 提供工作区概览、账户指标和时间趋势。null 指标表示数据尚未同步，并不表示数值为零。
评论和评价 可按工作区、平台、账户或未读状态筛选。Google Business 评价包含评分；LinkedIn 评论 ID 是 URN，必须在路径中进行 URL 编码。
配置参考 references/api-reference.md 记录端点和架构；references/platform-configs.md 介绍平台专属的媒体规则、说明文字限制和字段。

高级特性

支持 Instagram、Facebook、X、LinkedIn、TikTok、YouTube、Threads、Pinterest、Bluesky 和 Google Business Profile 的发布工作流程。
支持从 URL 或本地文件上传媒体，并支持轮播帖媒体排序。
提供帖子状态、发布日志、指标、账户分析、工作区概览，以及 1–365 天的趋势数据。
支持按状态、平台、账户、日期范围、分页和可选指标筛选帖子列表。
可以编辑已安排或重新安排的帖子、取消已安排的发布，以及删除帖子或已上传的媒体。API 不支持草稿帖子。
可阅读受支持的评论和评价、获取回复，或发布公开回复。
在发布、执行破坏性操作和立即发送公开回复之前，要求明确确认；对于批量请求，建议先创建一到两个帖子。
安全处理 API 错误：创建失败后不要盲目重试；将
权限或订阅错误视为最终结果；并区分速率限制冷却时间和账户发布上限。

name: postplanify description: Schedule and manage social media posts on Instagram, Facebook, X, LinkedIn, TikTok, YouTube, Threads, Pinterest, Bluesky and Google Business Profile through the PostPlanify API. Upload images and videos, read post and account analytics, and reply to comments. version: 1.0.0