Douyin Upload Skill for Openclaw

A professional CLI tool to automate Douyin video uploads, metadata generation, and AI-driven captioning.

yjli-new
v0.1.0
Mar 4, 2026
0
1.4k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install douyin-upload-skill

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install douyin-upload-skill 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 Douyin Upload Skill?

The Douyin Upload Skill is a specialized automation component designed for the Openclaw Skills ecosystem to streamline the publication of video content to Douyin (China mainland). It provides a deterministic, command-line interface for managing the entire lifecycle of a video post—from local file validation and OAuth authentication to AI-powered transcription and final API submission.

This skill is particularly valuable for developers and content creators who need to integrate Douyin publishing into their automated workflows. By leveraging Openclaw Skills, users can ensure their video metadata is accurately prepared and that captions are contextually relevant, thanks to integrated speech-to-text (ASR) capabilities and flexible publishing modes.

Douyin Upload Skill Use Cases

  • Automating high-volume video uploads for Douyin accounts from local storage.
  • Generating accurate video transcripts and metadata automatically to save manual editing time.
  • Managing Douyin content pipelines within an Openclaw Skills environment.
  • Providing a reliable fallback for manual publishing when official API permissions are restricted.

How Douyin Upload Skill Works

  1. The skill runs a dependency check via the doctor command to ensure FFmpeg and environment variables are correctly configured.
  2. Users perform an OAuth flow to authorize their Douyin account, which stores an encrypted token locally for secure access.
  3. The prepare command extracts audio from the video and uses ASR (Whisper or API) to generate a transcript.
  4. The system generates three caption candidates (title, description, and hashtags) based on the transcript.
  5. Upon user selection and confirmation, the skill publishes the video through the official Douyin OpenAPI.
  6. If the API returns a permission error, the skill automatically exports an outbox package for manual upload.

Douyin Upload Skill Setup

First, ensure you have the required environment variables set:

export DOUYIN_CLIENT_KEY="your_key"
export DOUYIN_CLIENT_SECRET="your_secret"
export DOUYIN_REDIRECT_URI="your_callback_url"

Run the dependency check and authorize your account:

# Check dependencies
node scripts/douyin.js doctor

# Authorize account
node scripts/douyin.js auth

Douyin Upload Skill Data Schema & Taxonomy

The skill manages data through a structured CLI output and local file system organization:

Data Type Description
Metadata JSON object containing video title, description, and visibility status.
Transcript A transcript.text file generated during the preparation phase.
Outbox A fallback directory containing video and metadata files if API publishing fails.
Config Persistent local settings for ASR modes, Whisper paths, and default visibility.

Douyin Upload Skill Advanced Features

  • Support for multiple ASR backends including local Whisper (CPU/GPU) and external APIs.
  • Encrypted local token storage using custom encryption keys for enhanced security.
  • Automatic fallback logic that generates a manual upload package when publish permissions are missing.
  • Flexible configuration for visibility settings and automated terminal confirmation policies within the Openclaw Skills framework.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*