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:
{ "tikhub_api_token": "your-token-here" }
Free tokens: https://user.tikhub.io/register
Workflow
- Detect input — identify a Douyin link or modal_id from the user's message
- Run the script — call
python3 {baseDir}/scripts/douyin_download.py - Show result — report the modal_id and either the video URL or the saved file path
Commands
Get video info (no download)
python3 {baseDir}/scripts/douyin_download.py "https://v.douyin.com/xxxxx/"
Download to default location (~/Downloads/douyin/)
python3 {baseDir}/scripts/douyin_download.py "https://v.douyin.com/xxxxx/" --download
Download to a custom directory
python3 {baseDir}/scripts/douyin_download.py "https://v.douyin.com/xxxxx/" --download --output-dir /path/to/dir
Use a bare modal_id
python3 {baseDir}/scripts/douyin_download.py "7615599455526585067" --download
Accepted Input Formats
| Format | Example |
|---|---|
| Short link | https://v.douyin.com/iABCxyz/ |
| Full URL with modal_id | https://www.douyin.com/video/7615599455526585067 |
| URL query param | https://www.douyin.com/jingxuan?modal_id=7615599455526585067 |
| Bare modal_id | 7615599455526585067 |
Output
- Without
--download: prints modal_id + direct video URL - With
--download: downloads to~/Downloads/douyin/douyin_<modal_id>.mp4(or custom dir)