A browser-automation skill that allows users to upload, schedule, and batch-manage TikTok videos programmatically.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tiktok-uploader
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install tiktok-uploader using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is TikTok Video Uploader?
The TikTok Video Uploader is a robust automation skill built to streamline content management for social media creators and developers. By utilizing the tiktok-uploader library and Playwright browser automation, it wraps the TikTok web interface to perform actions that typically require manual interaction. This makes it an essential tool within the Openclaw Skills ecosystem for anyone looking to programmatically handle video distribution without the overhead of the official API.
This skill is designed for high-efficiency workflows, allowing for the precise placement of hashtags, mentions, and privacy settings. Whether you are a solo creator or managing a fleet of accounts, this skill provides a developer-friendly bridge to TikTok's platform, ensuring your content reaches your audience on time and at scale.
TikTok Video Uploader Use Cases
- Automating the upload of a single video with custom descriptions and hashtags.
- Scheduling posts up to 10 days in advance to maintain a consistent posting cadence.
- Performing batch uploads of multiple videos from a local directory to save time.
- Managing video interactions like enabling or disabling duets, stitches, and comments.
- Scanning specific folders for new media files to be queued for upload.
How TikTok Video Uploader Works
- The skill launches a Playwright-controlled browser instance to interact with the TikTok web upload page.
- It authenticates the user session by injecting provided cookies or a session ID, avoiding the need for manual login.
- The system processes the input video file, ensuring it meets supported format requirements like .mp4 or .mov.
- It populates the metadata fields including the description (with support for hashtags) and interaction permissions.
- Depending on the command, it either triggers an immediate publish event or interacts with the scheduling UI to set a future post time.
- Finally, it provides feedback on the success or failure of the upload operation.
TikTok Video Uploader Setup
To use this skill, you must first install the necessary Python dependencies and the Playwright browser binaries:
pip install tiktok-uploader
playwright install
Additionally, authentication is required. You must export a cookies.txt file from your browser (using an extension like 'Get cookies.txt LOCALLY') or retrieve your sessionid from the TikTok website's cookie storage in DevTools.
TikTok Video Uploader Data Schema & Taxonomy
The skill organizes upload data and metadata using the following structures:
| Property | Description | Format |
|---|---|---|
filename |
Path to the source video file | String (Path) |
description |
Video caption, hashtags, and mentions | String (Max 150 chars) |
schedule |
Post timing (20 mins to 10 days in future) | ISO 8601 Datetime |
visibility |
Post privacy setting | everyone, friends, or only_you |
cookies |
Authentication session data | .txt file or list of dicts |
proxy |
Optional network configuration | JSON object with host/port |
TikTok Video Uploader Advanced Features
- Supports batch upload operations to process entire content libraries in a single command.
- Includes a directory scanner that recursively finds uploadable video files in local storage.
- Features adjustable headless mode, allowing users to watch the automation in real-time for debugging.
- Automated scheduling logic that rounds minutes to the nearest 5-minute interval as required by TikTok.
- Built-in support for multiple video formats including .mp4, .mov, .avi, and even .gif files.
SKILL.md
Loading
Related Openclaw Skills
TikTok Text Overlay
A versatile tool for adding authentic TikTok-style text overlays, backgrounds, and timed animations to images and videos.
Polymarket Monitor
Automate Polymarket tracking by monitoring prediction odds and receiving real-time alerts when specific probability thresholds are met.
Voice Message
A specialized skill for converting text into native voice bubbles across various chat platforms using edge-tts and ffmpeg.
Pixel Office
An interactive pixel-art dashboard that visualizes your AI agents as animated characters in a virtual office environment.
post-to-xhs
A specialized automation skill for publishing validated image and video notes directly to Xiaohongshu from local or web sources.
Xiaohongshu (XHS) Login Manager
A specialized skill for AI agents to handle Xiaohongshu authentication, status monitoring, and secure account switching via QR codes.
METADATA
Featured*
