tiktok-publish - SKILL.md Agent Skill

name: tiktok-publish description: Upload videos to TikTok via Content Posting API. Supports direct upload and URL-based publish, hashtags, and privacy settings. Requires TikTok OAuth2 credentials. metadata: openclaw: emoji: 🎵 requires: bins: - python3

TikTok 视频发布（tiktok-publish）

通过 TikTok Content Posting API 上传视频，支持直接上传和 URL 拉取两种模式。使用 TikTok OAuth2 认证。

前置条件

TikTok Developer Portal 创建应用，获取 client_key / client_secret
配置 OAuth2 重定向 URI
首次运行需浏览器授权，后续自动使用 refresh token

配置

环境变量或配置文件：

{
  "client_key": "your_client_key",
  "client_secret": "your_client_secret",
  "redirect_uri": "https://localhost:8080/callback"
}

保存到 ~/.openclaw/credentials/tiktok_config.json

首次授权后 token 保存到 ~/.openclaw/credentials/tiktok_token.json

使用方式

python3 ./skills/tiktok-publish/scripts/publish_tiktok.py \
  --title "视频标题" \
  --video video.mp4 \
  --description "描述 #hashtag1 #hashtag2" \
  --privacy public

参数说明

参数	必填	说明
`--title`	是	视频标题，最多 150 字
`--video`	是	视频文件路径，支持 mp4/mov/webm
`--description`	否	视频描述，最多 2200 字
`--privacy`	否	`public`/`mutual_follow`/`follower`/`private`，默认 `public`
`--disable-comment`	否	禁用评论
`--disable-duet`	否	禁用合拍
`--disable-stitch`	否	禁止拼接

Agent 工作流

检查 TikTok 配置和 token 是否存在
准备视频 + 标题 + 描述
运行 publish_tiktok.py 脚本
检查 stdout JSON 输出：
- {"ok": true, "publish_id": "xxx"} → 上传成功（发布可能需要几分钟处理）
- {"ok": false, "error": "AUTH_REQUIRED"} → 需要用户完成 OAuth2 授权
- {"ok": false, "error": "..."} → 其他错误

错误处理

错误	原因	处理
AUTH_REQUIRED	无有效 OAuth2 token	提示用户完成浏览器授权
UPLOAD_FAILED	上传失败	检查文件格式和大小，重试一次
PUBLISH_PENDING	视频处理中	正常现象，TikTok 服务器处理视频需要时间
QUOTA_EXCEEDED	API 配额用尽	等待配额重置

发布记录（强制）

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

./skills/published-track/scripts/record.sh \
  --platform tiktok \
  --title "标题" \
  --content-type video \
  --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（幂等，重复执行无副作用）。