A comprehensive PowerShell-based skill for managing TikTok video uploads, account statistics, and comment interaction via the official API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tiktok-page
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-page 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-page?
The tiktok-page skill is a powerful integration for Openclaw Skills that enables AI agents to interact directly with the TikTok Marketing API. It allows for seamless management of TikTok profiles, including video publishing from URLs or local files, retrieving account-level metadata, and monitoring video performance metrics. By utilizing this skill, developers can automate social media workflows directly through their AI-driven environments.
This tool focuses on security and direct communication, ensuring all API calls are made straight to TikTok's official endpoints without intermediary servers. It provides a robust framework for handling OAuth2 flows, token refreshes, and granular error handling, making it a reliable choice for professional social media automation and data collection.
tiktok-page Use Cases
- Automated video publishing from cloud storage URLs using PULL_FROM_URL.
- Bulk uploading local video content to a TikTok account using multi-chunk file uploads.
- Real-time monitoring of video views, likes, and comment counts for performance tracking.
- Retrieving and managing comments on published TikTok content to improve engagement.
- Syncing TikTok account statistics for data-driven marketing reports and analytics dashboards.
How tiktok-page Works
- The agent initializes by loading credentials from the local configuration directory located at ~/.config/tiktok-page/credentials.json.
- If the access token has expired (typically after 24 hours), the skill automatically performs a refresh using the stored refresh token and client secrets.
- The skill identifies the specific TikTok API endpoint required for the user's request, such as /video/list/ or /post/publish/video/init/.
- It constructs a PowerShell-based REST request with the appropriate Authorization headers and JSON body parameters.
- The skill executes the call to open.tiktokapis.com and parses the response to return actionable data or status updates to the user.
tiktok-page Setup
To use this skill, ensure you have PowerShell (Windows) or pwsh (macOS/Linux) installed. You must also have a developer account at developers.tiktok.com.
- Create an app in the TikTok Developer Portal and obtain your Client Key and Client Secret.
- Run the one-time OAuth2 authorization flow to generate your initial tokens.
- Create the configuration directory:
mkdir -p ~/.config/tiktok-page
- Save your credentials to
~/.config/tiktok-page/credentials.jsonfollowing the schema provided in the documentation. - Secure the file permissions:
# macOS / Linux
chmod 600 ~/.config/tiktok-page/credentials.json
tiktok-page Data Schema & Taxonomy
The skill manages a credentials.json file to maintain state and authentication. Data is organized as follows:
| Field | Description |
|---|---|
| TIKTOK_ACCESS_TOKEN | The active OAuth2 bearer token for all API calls. |
| TIKTOK_REFRESH_TOKEN | Used to acquire new access tokens every 24 hours. |
| TIKTOK_CLIENT_KEY | Your unique TikTok Developer App client key. |
| TIKTOK_CLIENT_SECRET | Your developer secret, used only for token refreshing. |
| TIKTOK_OPEN_ID | The authenticated user's unique TikTok identifier. |
tiktok-page Advanced Features
- Automatic token refresh logic to handle 24-hour expiration cycles without manual intervention.
- Multi-chunk file upload support for large video files up to 4GB and 60 minutes in length.
- Direct Pull from URL publishing, allowing for efficient cloud-to-TikTok transfers.
- Granular error mapping that identifies issues like spam risk, missing scopes, or file size violations.
- Cross-platform support for Windows, macOS, and Linux environments using Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Facebook Inbox Forwarder (fb-inbox-forward)
A real-time bridge that polls your Facebook Page inbox and forwards new messages directly to your OpenClaw channels.
ClawHub Skill Creator
A developer utility for scaffolding, validating, and publishing standards-compliant Openclaw Skills to the ClawHub registry.
Yoinkit
Yoinkit is a comprehensive social media intelligence tool that allows AI agents to search, analyze, and transcribe content across 13 major platforms.
HiveFence
HiveFence is a distributed security layer that provides collective immunity against prompt injection attacks for AI agents.
X/Twitter Manager Skill
A robust PowerShell-based skill for managing X/Twitter interactions, analytics, and content posting through an AI agent.
Grocy Inventory
A powerful automation interface for Grocy to manage pantry stock, batteries, and barcodes through Openclaw Skills.
METADATA
Featured*
