An AI-agent skill that enables automated command-line control of the Douyin web interface, including playback, navigation, interactions, and media recording.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install douyin-web-control
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 douyin-web-control 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 Web Control?
The Douyin Web Control skill is a highly structured wrapper designed for AI agents to control the Douyin (TikTok China) web application through a robust command-line interface. Built to run alongside other Openclaw Skills, this utility replaces fragile direct-browser DOM-clicking strategies with structured CLI actions, enabling reliable task execution. It manages the underlying browser sessions, handles page state retrieval via JSON, and coordinates human-in-the-loop triggers for account-impacting events.
This skill focuses purely on the mechanical execution layer of browser automation. It does not dictate recommendation strategies, video content generation, or account personas; rather, it provides developers and agents with a clean API to launch, control, interact, and record Douyin media feeds programmatically with built-in sandbox isolation and validation capabilities.
Douyin Web Control Use Cases
- Automated Feed Navigation and Playback: Programmatically launch Douyin feeds, navigate recommendations, switch between videos, adjust speeds, control volumes, or toggle fullscreen modes.
- Structured Content Scraping and Search: Execute high-precision keyword queries on the Douyin web client and capture structured JSON descriptions of the active video.
- Interaction Management with Human Safeguards: Draft comments, interact with creators (likes, follows, favorites), or send danmaku safely with explicit human-in-the-loop verification policies before final execution.
- Audio-Visual Media Recording: Execute multi-channel audio/video recording workflows directly from web feeds using isolated macOS virtual devices (such as BlackHole 2ch) to safely sample media without ambient mic contamination.
How Douyin Web Control Works
- Execution Entrypoint: The AI agent processes a command from the user and invokes the skill's wrapper script using specific action flags (e.g.,
--json COMMAND). - Session Target & Profile Matching: The tool checks for global profile arguments (using
--profile NAME) to cleanly isolate cookies, session tokens, and local cache directories from other automation workflows. - Playwright Navigation: Under the hood, the script utilizes Playwright Chromium via the
douyin-web-clibinary, directly carrying out standard actions such as navigation, scroll triggers, and video control. - Visual State Validation: After completing visual page updates, the browser takes an automated screenshot and updates
data.screenshot.pathwithin the structured JSON output so the agent can visually confirm state changes. - HITL Interruption for Captchas: If the underlying runner encounters logins, account blocks, slider captchas, or SMS prompts, it pauses automatic flows instantly, prompting human operator intervention.
Douyin Web Control Setup
To deploy this skill to your automation environment, install the core CLI dependencies and browser drivers using your terminal:
# Install the underlying douyin-web-cli from GitHub
python3 -m pip install "git+https://github.com/billwang233/douyin-web-cli.git"
# Install the Chromium browser engine for Playwright
python3 -m playwright install chromium
# Test the installation locally
douyin-web --help
Ensure that the wrapper script has access to your executable path. The skill automatically checks environment properties such as $DOUYIN_WEB_CLI or standard search directories within your current workspace (bin/douyin-web).
Douyin Web Control Data Schema & Taxonomy
The Douyin Web Control skill structures profiles and automates state handling using specific directory patterns and strict JSON response configurations.
Profile and Isolation Directory Layout
| Location Target | Description |
|---|---|
~/.douyin-web-cli/profiles/{NAME}/ |
Automatically isolates browser cache, state files, cookies, and screenshots per active profile name. |
${DOUYIN_WEB_HOME} |
Absolute directory path targeted when manually specifying isolated home directories. |
Command-Line JSON Schema Response
Using this automation in tandem with Openclaw Skills guarantees standard JSON schemas to make scripting straightforward:
| Property | Type | Description |
|---|---|---|
ok |
boolean | Indicates if the CLI automation successfully navigated or modified the browser state. |
message |
string | Informative log data or execution trace messages returned directly by the runner. |
data |
object | The output envelope carrying dynamic command telemetry. |
data.screenshot.path |
string | Target file path containing the automated validation frame captured post-operation. |
Douyin Web Control Advanced Features
- Isolated Multi-Account Workflows: Run multiple profiles parallelly using simple CLI switches (
--profile project-aand--profile project-b) to keep browser profiles completely sandboxed. - Verification Safeguards: Real-time integration of automated login waiting strategies (
wait-login --timeout 300) to let developer operations pause gracefully during MFA or slider prompts. - Isolated Virtual Device Recording: Seamless integration with AVFoundation targets and virtual soundboards (such as BlackHole 2ch) to capture perfect video and browser audio clips without microphone bleed.
- Agent Verification Harness: Built-in testing capabilities run through
pytestin the core harness directory to perform validation on CLI configurations without modifying production accounts.
SKILL.md
Loading
Related Openclaw Skills
Jack CAD Drawing Generator
An automated AI agent skill that guides users through generating custom mechanical jack CAD blueprints via incremental API calculations without requiring login credentials.
Early Setup Finder
An AI-driven pre-pump fingerprint scanner that identifies crypto assets showing accumulation signals before a major price move using an 8-signal validation framework.
Confession Generator
An anonymous first-person crypto confession engine that generates raw, high-impact trading loss stories to teach risk management and psychology through visceral experience.
Community Quick Scan
The Community Quick Scan skill performs rapid audits of Telegram and Discord communities to identify engagement bottlenecks and deliver a single actionable fix.
Unified Search
A powerful two-layer search and deep research suite combining multi-engine web search, content extraction, and thread tracing for AI agents.
Skill Refactor Method
A highly structured, eleven-step methodology designed to evaluate whether an AI agent skill is truly necessary and refactor its internal workflows if it is.
Featured*
