Douyin Downloader#

Download Douyin videos using the TikHub API. Handles short links, full URLs, and bare video IDs.

Configuration#

Requires a TikHub API token in ~/.openclaw/config.json:

json

{ "tikhub_api_token": "your-token-here" }

Free tokens: https://user.tikhub.io/register

Workflow#

1. Detect input — identify a Douyin link or modal_id from the user's message
2. Run the script — call python3 {baseDir}/scripts/douyin_download.py
3. Show result — report the modal_id and either the video URL or the saved file path

Commands#

Get video info (no download)#

bash

python3 {baseDir}/scripts/douyin_download.py "https://v.douyin.com/xxxxx/"

Download to default location (~/Downloads/douyin/)#

bash

python3 {baseDir}/scripts/douyin_download.py "https://v.douyin.com/xxxxx/" --download

Download to a custom directory#

bash

python3 {baseDir}/scripts/douyin_download.py "https://v.douyin.com/xxxxx/" --download --output-dir /path/to/dir

Use a bare modal_id#

bash

python3 {baseDir}/scripts/douyin_download.py "7615599455526585067" --download

Accepted Input Formats#

FormatExampleShort linkhttps://v.douyin.com/iABCxyz/Full URL with modal_idhttps://www.douyin.com/video/7615599455526585067URL query paramhttps://www.douyin.com/jingxuan?modal_id=7615599455526585067Bare modal_id7615599455526585067

Output#

• Without --download: prints modal_id + direct video URL
• With --download: downloads to ~/Downloads/douyin/douyin_<modal_id>.mp4 (or custom dir)