TikTok 上传

安装指南

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

什么是

TikTok Upload 让 AI 代理通过 PostWire 获准使用的 TikTok Content Posting API，将视频和照片轮播贴文发布或排程至 TikTok。它可处理账号连接、媒体上传或文字转视频、说明文字准备、必要的隐私选项选择，以及贴文状态检查，直到取得上线链接。
此工具专为 OpenClaw Skills 以及其他能够调用 MCP 工具或发送 HTTPS 请求的代理设计，可避免使用非官方端点、浏览器自动化和会话 Cookie。用户须在发布前批准贴文；也支持选择将内容同步发布至 Instagram Reels 和 YouTube Shorts。

应用场景

将已完成的 MP4 或 MOV 视频发布到已连接的 TikTok 账号。
将 TikTok 贴文排程至指定时间或下一个可用时段。
根据文字制作简短的直式视频，审核后再发布。
分享最多包含 35 张图片的照片轮播贴文。
为 TikTok、Instagram Reels 和 YouTube Shorts 制作适合各平台的说明文字，并重复利用视频内容。
自动化社交媒体发布，同时保留账号所有者对隐私设置和最终批准的控制权。

工作原理

检查连接： 使用 PostWire MCP 工具或 REST API 验证账号和 TikTok 连接。如有需要，创建 TikTok 连接链接，并让账号所有者登录。
准备媒体： 提供公开的 HTTPS MP4 或 MOV 网址，为本地文件创建上传链接，根据文字生成 10 秒直式视频，或提供最多 35 个照片网址。
拟定说明文字： 准备最多 2,200 个字符的说明文字，最好简洁且切合内容，并使用少量具体的主题标签。
发布或排程： 调用 post_to_social 立即发布，或使用 run_at 值和时区调用 schedule_post 进行排程。若用户要求同步发布至 Instagram 或 YouTube，请根据方案限制添加平台。
返回结果： 使用返回的贴文 ID 轮询 get_post_status，直到 TikTok 提供上线链接。如果 TikTok 拒绝贴文，请说明返回的错误并修正问题，不要盲目重发。

配置指南

创建免费的 PostWire 账号；此技能需要连接 TikTok 账号。
按照 https://postwire.io/SKILL.md 中的原始设置指南，将 PostWire MCP 工具添加到代理，或直接使用 REST API。
连接 TikTok。如果尚未连接，请使用 platform: "tiktok" 创建连接链接，并让账号所有者授权访问。
使用 REST 时，请将 POSTWIRE_API_KEY 安全地设为环境变量。切勿打印或暴露此密钥。
export POSTWIRE_API_KEY="your_postwire_api_key"
curl https://postwire.io/api/me \ -H "Authorization: Bearer $POSTWIRE_API_KEY" \ -H "X-PostWire-Source: mcp-sk-tiktok" JSON 请求请使用 Content-Type: application/json。若要使用本地视频，请创建上传链接，让用户在其设备上选择文件；聊天附件不会自动提供给 PostWire。为获得最佳效果，请使用 9:16、1080×1920 的直式视频，时长约 15–60 秒，并在前两秒呈现吸引观众的重点。

数据架构

数据或字段 用途和要求
platforms 目标平台，例如 tiktok；可选的同步发布平台包括 instagram 和 youtube。
per_platform 各平台专属的说明文字；YouTube 还需要标题。
video_url 指向 MP4 或 MOV 文件的公开 HTTPS 网址，不可使用 TikTok 或 YouTube 页面网址。
media_url 用户选择本地文件且上传处理完成后返回的已上传媒体网址。
photo_url / media 照片贴文输入；支持最多 35 张图片的轮播。
privacy 由账号所有者选择的 TikTok 可见范围：public、friends 或 private。
brand_id 当 TikTok 账号连接至多个品牌时，用于识别品牌。
run_at、timezone 排程详情；run_at 接受带时区偏移的 ISO 时间戳或 next_slot。
贴文 ID 和状态 用于通过 get_post_status 轮询 TikTok 处理进度，并取得最终上线链接。
错误响应 拒绝详情包含 code、what 和 fix；再次尝试发布前，应告知用户建议的修正方法。
PostWire 管理连接和发布流程。此技能未指定本地生成文件目录或单独的元数据分类体系。

高级特性

通过 PostWire 整合官方 TikTok Content Posting API；无需自建开发者应用、审核、Cookie 或浏览器自动化。
同时支持 MCP 工具和直接 HTTPS REST 调用，兼容不同代理。
根据文字生成 10 秒直式视频，并在发布前提供审核步骤。
支持使用带时区偏移的 ISO 时间戳或
next_slot
排程贴文，并指定时区。
支持同步发布至 TikTok、Instagram Reels 和 YouTube Shorts，并为各平台设置不同的说明文字；YouTube 贴文还需标题。
处理 TikTok 要求的隐私选项和发布前明确确认；若未回答隐私选项，PostWire 会将贴文设为私人。
轮询 TikTok 的异步处理状态，以取得贴文上线链接，并提供可执行的拒绝详情。
遵守方案限制：Free 方案会发布至列表中的前两个网络，而 Starter 会一次发布至所有网络。请报告任何暂缓发布的目标平台，不要规避方案限制。

name: tiktok-upload description: "Upload and publish a video (or a photo carousel of up to 35 images) to TikTok from your AI agent, now or scheduled, through TikTok's official Content Posting API: no developer app, no audit, no browser automation or cookies. Writes the caption, asks the account owner who can see the post as TikTok requires, then returns the live TikTok link. Optionally sends the same video to Instagram Reels and YouTube Shorts. Use when the user wants to post, upload or schedule a TikTok, automate TikTok posting, or turn text into a TikTok video." 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 the TikTok account connected.