← Back to Skills Marketplace
148
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install grab-douyin
Description
Download Douyin (抖音) videos via the TikHub API — no login required. USE THIS SKILL whenever the user: - Shares a Douyin link (v.douyin.com, douyin.com, or an...
README (SKILL.md)
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_\x3Cmodal_id>.mp4(or custom dir)
Usage Guidance
What to check before installing: (1) The SKILL.md and script expect a TikHub API token stored at ~/.openclaw/config.json — this was not declared in the skill metadata; verify you are comfortable storing a token there and that the file contains only that token. (2) The skill will make outbound HTTP requests to api.tikhub.io and to Douyin video URLs and will save files to your filesystem (default ~/Downloads/douyin). (3) SKILL.md instructs the agent to 'always' use this skill when it detects a Douyin URL, which can cause automatic network activity and file writes; if you prefer explicit consent, disable autonomous invocation or require confirmation. (4) Source is unknown — if you rely on trust, ask the publisher for provenance or audit the code yourself (the included Python script is short and readable). (5) Ensure your environment has Python3 and the requests library or sandbox the skill if you want to limit potential misuse.
Capability Analysis
Type: OpenClaw Skill
Name: grab-douyin
Version: 1.0.0
The skill is a legitimate tool for downloading Douyin videos using the TikHub API. It reads a specific API token from a local configuration file (~/.openclaw/config.json) and interacts with the documented API endpoint (api.tikhub.io) to fetch and download video content to the user's Downloads folder. No evidence of data exfiltration, malicious execution, or obfuscation was found in scripts/douyin_download.py or the SKILL.md instructions.
Capability Assessment
Purpose & Capability
The code and SKILL.md implement a Douyin downloader via the TikHub API (network calls, short-link resolution, and saving to ~/Downloads/douyin). That aligns with the name/description. However, the registry metadata lists no required env vars or config paths, while SKILL.md and the script require a TikHub API token stored at ~/.openclaw/config.json. This metadata/instruction mismatch is inconsistent and should have been declared.
Instruction Scope
SKILL.md instructs the agent to 'Always use this skill when you detect a Douyin URL' — giving the agent broad, automatic discretion to call the included script, perform network requests, and save files without explicit additional user consent. The runtime instructions also require reading ~/.openclaw/config.json for the token and performing HTTP requests to api.tikhub.io and the returned video URL; these actions are within purpose but the automatic-invoke directive is broad.
Install Mechanism
There is no install spec (instruction-only + included Python script), so nothing is downloaded at install time. The script depends on Python and the 'requests' package (not declared in metadata). This approach has low install risk but assumes the runtime has Python and requests available.
Credentials
The script legitimately needs a TikHub API token, but that credential is expected in a config file (~/.openclaw/config.json) rather than an env var; the skill registry metadata did not declare this required config path or credential. Reading a user-home config file is a sensitive action and the missing declaration is an incoherence the user should be aware of.
Persistence & Privilege
The skill does not request 'always: true' and does not modify other skills or system-wide settings. However, because SKILL.md tells the agent to always use this skill when a Douyin URL is seen, the autonomous-invocation default could lead to automatic downloads; consider requiring user confirmation before downloads if you want to limit that behavior.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install grab-douyin - After installation, invoke the skill by name or use
/grab-douyin - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
TikHub API based Douyin video downloader. Short link resolution, streaming download, custom output dir. No login, no watermark.
Metadata
Frequently Asked Questions
What is Grab Douyin - Video Downloader?
Download Douyin (抖音) videos via the TikHub API — no login required. USE THIS SKILL whenever the user: - Shares a Douyin link (v.douyin.com, douyin.com, or an... It is an AI Agent Skill for Claude Code / OpenClaw, with 148 downloads so far.
How do I install Grab Douyin - Video Downloader?
Run "/install grab-douyin" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Grab Douyin - Video Downloader free?
Yes, Grab Douyin - Video Downloader is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Grab Douyin - Video Downloader support?
Grab Douyin - Video Downloader is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Grab Douyin - Video Downloader?
It is built and maintained by mfang0126 (@mfang0126); the current version is v1.0.0.
More Skills