/install douyin-toolkit
douyin-publisher
自动将视频发布到抖音创作者平台。
前置要求
pip install playwright
python -m playwright install chromium
首次使用(登录)
python3 publish.py --start-browser
浏览器启动后,在 VNC 或浏览器窗口中打开抖音创作者中心,扫码登录。
登录态会自动保存在 chrome_profile/,下次无需再登录。
发布视频
基本用法:
python3 publish.py --video /path/to/video.mp4 --title "视频标题"
连续发布多条(保持浏览器不关)
python3 publish.py --video video1.mp4 --title "第一条" --keep-alive
python3 publish.py --video video2.mp4 --title "第二条" --keep-alive
--keep-alive 让发布完不关浏览器,后续发布无需重新打开。
输入验证码(如需)
脚本发验证码后,在另一个终端执行:
python3 publish.py --code 验证码
默认等待 120 秒,超时可调:
python3 publish.py --video xxx.mp4 --title "标题" --code-timeout 300
参数
| 参数 | 说明 | 默认 |
|---|---|---|
--video |
视频文件路径(必填) | - |
--title |
视频标题 | 空 |
--description |
视频描述 | 空 |
--start-browser |
启动Chrome(首次登录用) | - |
--code |
短信验证码 | - |
--keep-alive |
发布后保留Chrome不关 | off |
--code-timeout |
验证码等待超时(秒) | 120 |
常见问题
登录态过期怎么办?
运行 python3 publish.py --start-browser 重新扫码登录。
提示"找不到文件上传入口"?
可能原因:
- 登录态过期 → 重新登录
- 页面加载异常 → 稍后重试
想发布多条但不想每次都扫码?
用 --keep-alive 参数,发布完浏览器不关,下一条直接跑。
说明
- 登录态保存在本地
chrome_profile/,不会上传到别处 - 不是每次发布都需要短信验证
- 首次登录用
--start-browser,日常发布不用 - 脚本自动截图保存到
screenshots/目录,方便排查
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install douyin-toolkit - After installation, invoke the skill by name or use
/douyin-toolkit - Provide required inputs per the skill's parameter spec and get structured output
What is Douyin Clean?
自动发布视频到抖音(支持短信验证)。上传视频、填写标题、处理验证码,一条龙完成。 It is an AI Agent Skill for Claude Code / OpenClaw, with 74 downloads so far.
How do I install Douyin Clean?
Run "/install douyin-toolkit" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Douyin Clean free?
Yes, Douyin Clean is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Douyin Clean support?
Douyin Clean is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Douyin Clean?
It is built and maintained by Mr-J-J (@mr-j-j); the current version is v3.0.0.