TikTok 发布

通过 MyBrandMetrics API 从本地文件或远程视频 URL 向 TikTok 发布视频内容。

使用此技能可实现向 TikTok 发布、上传视频、发布视频、安排发布任务、检查发布状态，或创建一次性定时发布任务。

网站：[https://www.clawbus.com/](https://www.clawbus.com/)

MyBrandMetrics API：[https://mybrandmetrics.com/](https://mybrandmetrics.com/)

为什么更优

相比传统的 TikTok API 或开发者应用配置流程，本方案更加简单：

• 使用 Google 账号登录 MyBrandMetrics，无需创建 TikTok 开发者应用。
• 无需管理 TikTok 客户端 ID、客户端密钥、重定向 URI 或回调服务器。
• 无需自行构建令牌存储与刷新机制。
• 无需单独运行发布后端服务来排队上传和查询状态。
• MyBrandMetrics 负责连接层，本技能专注于发布、轮询与状态检查。

核心功能

配置流程

1. 打开 [https://mybrandmetrics.com/](https://mybrandmetrics.com/) 并使用 Google 账号登录。
2. 在 MyBrandMetrics 中打开 数据源。
3. 选择 connect tiktok feed。
4. 如有提示，完成 TikTok 授权流程。
5. 获取 MyBrandMetrics API 密钥。
6. 将 API 密钥添加至 /root/.openclaw/workspace/config.json：

{
  "tiktok": {
    "api_key": "YOUR_API_KEY"
  }
}

1. 安装 tiktok-publish 技能。
2. 开始使用该技能发布内容或检查 TikTok 发布状态。

定位说明

• 当用户希望实现 TikTok 发布但不想自行搭建 TikTok 开发者集成时，使用此技能。
• 保持信息简洁：一次 Google 登录到 MyBrandMetrics，一个已连接的 TikTok 数据源，发布流程即准备就绪。
• 此为发布工作流，非通用 MCP 或开发者控制台配置。

工作流程

使用以下流程向 TikTok 发布视频、上传视频、安排发布任务或检查发布状态。

1. 确认发布目标。

选择是通过远程视频链接发布、上传本地视频文件、检查现有发布任务，还是准备定时发布工作流。

1. 确认 TikTok 配置。

使用 Google 登录 MyBrandMetrics，将 TikTok 添加为数据源，并获取 MyBrandMetrics API 密钥。

1. 准备凭证。

将 MyBrandMetrics API 密钥添加至工作区配置文件：

{
  "tiktok": {
    "api_key": "YOUR_API_KEY"
  }
}

1. 收集发布信息。

准备视频来源、标题、隐私级别及发布偏好。

推荐默认设置：

• 测试发布时选择 SELF_ONLY；
• 准备上线时选择 PUBLIC；
• 使用简洁的标题或描述；
• 使用可直接发布的远程视频链接或本地视频文件。

1. 发布 TikTok 视频。

使用技能从远程链接或本地文件发布。如需，工作流可等待发布任务完成。

1. 检查发布状态。

若返回发布标识符，可后续使用它查询 TikTok 发布状态。任务成功后，请在关联的 TikTok 账号中确认结果。

草稿、画廊与定时发布

当前脚本支持从远程链接或本地文件发布视频。

已知工作流注意事项：

• 草稿类流程可能以 TikTok 通知形式出现，提示“视频已准备好编辑”，而非普通个人草稿。
• 图像画廊发布可能需要手机友好尺寸（如 1080x1920）。过大生成图像可能导致 TikTok 图像校验失败。
• 定时发布应视为自动化流程：发布前请确认表格列名、发布时间、视频链接、标题、隐私级别及账号。

常见错误

聊天请求应包含：

• 视频链接或文件路径；
• 标题或描述；
• 是否为测试发布或公开发布；
• 是否等待发布完成。

发布流程结束后，请检查响应并确认 TikTok 上传是否成功。

直接使用脚本

使用 scripts/publish_tiktok.py。

远程链接发布：

python3 scripts/publish_tiktok.py \
  --source "https://example.com/video.mp4" \
  --title "My TikTok Title" \
  --privacy-level "SELF_ONLY"

本地文件发布：

python3 scripts/publish_tiktok.py \
  --source "/path/to/video.mp4" \
  --title "Launch clip" \
  --privacy-level "PUBLIC" \
  --wait-for-published

带显式轮询控制：

python3 scripts/publish_tiktok.py \
  --source "https://example.com/video.mp4" \
  --title "Campaign preview" \
  --privacy-level "SELF_ONLY" \
  --wait-for-published \
  --poll-interval 5000 \
  --poll-timeout 300000

检查发布状态

当已有 publish_id 时，可使用 scripts/check_status.py 检查发布状态。

python3 scripts/check_status.py --publish-id "PUBLISH_ID"

一次性定时发布

ClawBus 还支持创建一次性定时发布的 TikTok 发布任务。

准备条件：

• 视频或图片已上传至 Google Drive 或其他可访问的位置；
• 创建一份 Google 表格，包含发布标题、发布时间（日期和时间）、视频 URL 等信息；
• 仅向需要读取该表格的可信账户或服务授予共享访问权限。

示例请求：

请帮我创建一个一次性定时发布任务。该任务需根据此表格中的标题、日期、时间和视频 URL 数据，使用 tiktok-publish 技能将视频或图片发布到 TikTok 账号。
GOOGLE_SHEET_URL

在设置定时任务前，请检查表格中每一行的内容，确认账号、发布时间、标题和视频链接是否正确。发布任务报告成功后，请打开 TikTok 应用，手动确认帖子是否已上线。

参数说明

发布前，请确认 TikTok 账号、视频来源、标题或描述以及隐私设置。测试发布时，建议先使用 SELF_ONLY 模式。