TikTok Publisher

Post to TikTok, upload TikTok videos, and publish TikTok video content through the MyBrandMetrics API from a local file or a remote video URL.

Use this skill to post to TikTok, upload TikTok videos, publish TikTok videos, schedule TikTok posts, check TikTok publishing status, or create a one-time scheduled TikTok posting task.

Website: https://www.clawbus.com/
MyBrandMetrics API: https://mybrandmetrics.com/

Core Capabilities

| Capability | Details | | --- | --- | | Remote URL publishing | Submit a direct https:// video URL to TikTok through MyBrandMetrics. | | Local file publishing | Upload a local video file with multipart form data. | | Post metadata | Set the TikTok post title and privacy level. | | Chat-based posting | Use natural-language prompts in chat after the skill is installed. | | One-time scheduled tasks | Create a scheduled publishing task from a Google Sheet containing title, date, time, and video URL rows. |

Setup Flow

Open https://mybrandmetrics.com/ and sign in with Google.
In MyBrandMetrics, open Data sources.
Choose connect tiktok feed.
Complete the TikTok authorization flow if prompted.
Get the MyBrandMetrics API key.

Add the API key to /root/.openclaw/workspace/config.json:

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

Install the tiktok-publish skill.
Start publishing or checking TikTok publish status with this skill.

Workflow

Use this workflow to post to TikTok, upload a TikTok video, publish a TikTok video, schedule TikTok posts, or check a TikTok publishing job.

Confirm the publishing goal. Choose whether to publish from a remote video URL, upload a local video file, check an existing publish job, or prepare a scheduled posting workflow.
Confirm the TikTok setup. Sign in to MyBrandMetrics with Google, connect TikTok as a data source, and get a MyBrandMetrics API key.
Prepare credentials. Add the MyBrandMetrics API key to the workspace config:
```
{
  "tiktok": {
    "api_key": "YOUR_API_KEY"
  }
}
```
Collect post details. Prepare the TikTok video source, post title, privacy level, and publishing preference.

Useful defaults:
- choose SELF_ONLY for test posts;
- choose PUBLIC when the post is ready to go live;
- use a concise title or caption;
- use a remote video URL or local video file that is ready to publish.
Publish the TikTok video. Use the skill to publish from a remote URL or local file. The workflow can also wait for the publishing job to finish when needed.
Check publish status. If a publish identifier is returned, use it to check the TikTok publish status later. After the job succeeds, confirm the result in the connected TikTok account.

Drafts, Carousels, And Scheduling

The current script supports video publishing from a remote URL or local file.

Known workflow notes:

Draft-style flows may appear as a TikTok notification that the video is ready to edit, rather than as a normal profile draft.
Image carousel publishing may require phone-friendly image dimensions such as 1080x1920. Oversized generated images can fail TikTok image checks.
Scheduled posting should be treated as an automation workflow: confirm the sheet columns, publish date, publish time, video URL, title, privacy level, and account before creating the task.

Common Errors

| Error | Likely cause | Fix | | --- | --- | --- | | 401 invalid token format | API key was sent in the wrong auth format or the key is invalid. | Use the MyBrandMetrics API key configuration supported by this skill. Do not use a bearer-token format. | | picture_size_check_failed | Image dimensions do not meet TikTok requirements. | Resize images to a phone-friendly format such as 1080x1920 and retry. | | duration_check | Video is too short. | Use a video that is at least 3 seconds long. | | invalid_params | Title, caption, media, or request parameters are invalid. | Simplify the title, reduce hashtags, and recheck the source URL or local path. |

The chat request should include:

the video URL or file reference;
the caption or title;
whether the post should be a test or public post;
whether to wait for publish completion.

After the posting flow finishes, check the response and confirm the TikTok upload succeeded.

Use The Scripts Directly

Use scripts/publish_tiktok.py.

Remote URL:

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

Local file:

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

With explicit polling controls:

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

Check Publish Status

Use scripts/check_status.py when you already have a publish_id.

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

One-Time Scheduled Posting

ClawBus can also create a one-time scheduled TikTok posting task.

Prepare:

videos or images uploaded to Google Drive or another reachable location;
a Google Sheet with post title, publish date, publish time, and video URL;
sharing access granted only to the trusted account or service that needs to read the table.

Example request:

Please help me create a one-time scheduled task. The task involves publishing videos or images to a TikTok account using the tiktok-publish skill, based on the title, date, time, and video URL data found in this table: GOOGLE_SHEET_URL

Before scheduling, review every row in the sheet and confirm the account, publish time, title, and video URL. When the publishing task reports success, open TikTok and confirm the post is live.

Parameters

| Parameter | Required | Purpose | | --- | --- | --- | | --source | Yes | Direct video URL or local video file path. | | --title | Yes | TikTok post title. | | --privacy-level | No | SELF_ONLY by default; use PUBLIC only when ready to post live. | | --wait-for-published | No | Poll until the publish job completes. | | --poll-interval | No | Polling interval in milliseconds. | | --poll-timeout | No | Polling timeout in milliseconds. | | --config | No | Path to workspace config.json. |

Before publishing, confirm the TikTok account, video source, title or caption, and privacy setting. For test posts, use SELF_ONLY first.