threads-publish - SKILL.md Agent Skill

name: threads-publish description: Publish posts to Threads via Meta Graph API. Supports text, image, video, and carousel posts. Requires Meta OAuth2 token with threads_basic and threads_content_publish permissions. metadata: openclaw: emoji: 🧵 requires: bins: - python3

Threads 发布（threads-publish）

通过 Meta Graph API 发布内容到 Threads，支持文字、图片、视频和轮播帖子。使用 Content Container 模式。

前置条件

Meta Developer 应用，获取 threads_basic + threads_content_publish 权限
Threads 账户关联到应用
长效 Token

配置

保存到 ~/.openclaw/credentials/threads_config.json：

{
  "access_token": "your_long_lived_token",
  "threads_user_id": "your_threads_user_id"
}

使用方式

文字帖：

python3 ./skills/threads-publish/scripts/publish_threads.py \
  --text "帖子内容 #hashtag"

图片帖：

python3 ./skills/threads-publish/scripts/publish_threads.py \
  --text "描述" \
  --images https://example.com/image.jpg

视频帖：

python3 ./skills/threads-publish/scripts/publish_threads.py \
  --text "描述" \
  --video https://example.com/video.mp4

参数说明

参数	必填	说明
`--text`	是	帖子文本内容
`--images`	否	图片 URL（逗号分隔，最多 10 张）
`--video`	否	视频 URL

错误处理

错误	原因	处理
AUTH_REQUIRED	Token 失效	更新 Token
UPLOAD_FAILED	容器创建失败	检查 URL 可访问性
MEDIA_PROCESSING	媒体处理中	轮询状态等待

注意：Threads API 同 Instagram，仅支持 URL 形式的媒体。

发布记录（强制）

发布成功后，必须立即调用 published-track 技能记录发布信息：

./skills/published-track/scripts/record.sh \
  --platform threads \
  --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（幂等，重复执行无副作用）。