前言¶
抖音创作者平台(creator.douyin.com)的发布表单是 React / Semi Design 界面,上传、话题、配乐、声明和定时往往要反复点选。人工操作一种体裁已经够费神,若还要在文章、图文、视频之间切换,流程和选择器都不相同,很难靠一段固定脚本通吃。
下面介绍 SkillHub 上的社区 Skill「抖音全类型自动发布」(@user_f4e1eca6/douyin-publish-article,v4.0.0)。它把三种体裁的发布步骤写进 SKILL.md,文章路径还提供 douyin-publish.cjs 一键脚本;图文、视频则按文档分步用 Playwright 连浏览器操作。技能说明中记载已在 2026-05-14 至 2026-06-01 期间做多轮真实测试。
这是什么¶
一句话定位:面向抖音创作者平台的 Agent Skill,覆盖文章、图文、视频三类作品的自动化发布与常见发布选项(话题、配乐、自主声明、定时等)。
来源与维护:SkillHub 社区来源(source: community),发布者坐标 @user_f4e1eca6/douyin-publish-article,SkillHub 页面展示维护者为「叫我老大哥」。当前版本 4.0.0,分类为 content-creation(子类含自媒体运营、短视频脚本)。平台标签 requires_api_key=false,表示不依赖额外 API Key。
官方入口:
- Skill 安装说明页:
https://api.skillhub.cn/user_f4e1eca6/douyin-publish-article - SkillHub 详情:
https://www.skillhub.cn/skills/user_f4e1eca6/douyin-publish-article
核心功能¶
以下能力均来自 v4.0.0 的 SKILL.md 与包内脚本说明,按体裁区分实现方式。
| 体裁 | 适用场景(文档约定) | 发布方式 | 流程步数 |
|---|---|---|---|
| 文章 | 长文,正文 ≤8000 字 | douyin-publish.cjs 脚本 |
8 步 |
| 图文 | 图片 + 文字,描述 ≤1000 字,1–35 张图 | 浏览器 Playwright 分步 | 10 步 |
| 视频 | 单文件,≤16GB / ≤60 分钟 | 浏览器 Playwright 分步 | 8 步(文档约定跳过手动封面) |
跨体裁能力(文档中「通用操作」与各流程章节):
- 话题:通过创作者页「添加话题」搜索并点选建议项
- 背景音乐:文章、图文支持按关键词(如「纯音乐」)搜索并「使用」;视频流程文档写明跳过配乐
- 自主声明:可在弹窗中选择如「内容由AI生成」等项
- 定时发布:通过「定时发布」与
placeholder="日期和时间"的输入框设置时间 - 文章流程另含头图、封面分开上传;图文含从已传图中选封面;视频依赖平台 AI 封面,流程不手动点封面区域
v4.0.0 更新说明(SkillHub API 与 SKILL.md 一致):三合一完整版,分别固化文章脚本路径、图文 10 步、视频 8 步,并附带前提条件与踩坑记录。
安装与启用¶
1. 安装 SkillHub CLI(若尚未安装)¶
先检查本机是否已有 CLI:
command -v skillhub && skillhub --version
未安装时,可按 SkillHub 官方安装文档执行(仅 CLI):
curl -fsSL https://skillhub.cn/install/install.sh | bash -s -- --cli-only
完整安装(CLI + 默认 Skill)可使用同文档中的完整安装命令。
2. 安装本 Skill¶
SkillHub 详情页给出的安装提示为:根据 https://skillhub.cn/install/skillhub.md,安装 @user_f4e1eca6/douyin-publish-article。
在终端中需用 --dir 指向当前 Agent 识别的 skills 目录(装到错误目录会导致 Agent 读不到,文档要求安装后可能还需重启 Agent)。常用路径如下(摘自 SkillHub 安装文档):
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
示例(Cursor):
skillhub install @user_f4e1eca6/douyin-publish-article --dir ~/.cursor/skills/
安装包内含 SKILL.md 与 douyin-publish.cjs(平台签名接口记录该版本 file_count 为 2,外加元数据)。
3. 运行环境(技能硬性前提)¶
SKILL.md 将 OpenClaw CDP Chrome 列为三类体裁的共用前提:
openclaw browser start
- CDP 地址:
http://127.0.0.1:18800 - 需在
creator.douyin.com完成登录(首次扫码;Cookie 持久化,重启后可能需重新登录)
文章一键发布额外要求:Node.js、Playwright(npm 全局),以及可执行的 douyin-publish.cjs。文档示例工作目录为 ~/.openclaw/workspace,实际路径以你部署脚本的位置为准。
图文、视频不强制该 Node 脚本,由 Agent 按 SKILL.md 通过 Playwright 连接上述 CDP 浏览器逐步操作。
典型用法¶
经过上面的安装与环境准备后,可按体裁选择路径。下列示例字段与命令来自包内 douyin-publish.cjs 与 SKILL.md,仅作结构参考;标题、正文、路径需换成你自己的素材。
文章:改 CONFIG 后脚本发布¶
- 准备头图、封面(文档示例目录
/tmp/openclaw/uploads/)。 - 编辑脚本内
CONFIG(节选):
const CONFIG = {
PUBLISH: true,
TYPE: 'article',
TITLE: '标题(≤30字)',
SUMMARY: '摘要(≤30字)',
BODY: '<p>正文 HTML</p>',
TOPICS: ['话题1', '话题2', '话题3'],
MUSIC_KEYWORD: '纯音乐',
SCHEDULED_TIME: '2026-06-04 19:00',
HEADER_IMAGE: '/tmp/openclaw/uploads/article_header.jpg',
COVER_IMAGE: '/tmp/openclaw/uploads/article_cover.jpg',
};
- 在已启动 OpenClaw 浏览器且已登录创作者平台的前提下运行(
SKILL.md示例):
cd ~/.openclaw/workspace
NODE_PATH=~/.npm-global/lib/node_modules node douyin-publish.cjs --type=article --publish
脚本还支持 --type=image、--type=video 等参数(见文件头部注释);图文、视频在文档中更强调分步浏览器流程,与文章「8 步脚本」并列说明。
图文 / 视频:让 Agent 按 SKILL 分步执行¶
对 Agent 的自然语言需求可围绕体裁说明素材路径与文案,例如:「按 douyin-publish 技能,用已登录的 OpenClaw 浏览器发布一条图文,图片在 /tmp/openclaw/uploads/image_01.jpg…」。Agent 应打开 SKILL.md 中对应章节:
- 图文:新开
https://creator.douyin.com/creator-micro/content/post/image?type=new&_=<时间戳>,上传 1–35 张图,填标题(≤20 字)与 Slate 描述区,再话题、封面、声明、配乐、定时、发布。 - 视频:从
https://creator.douyin.com/creator-micro/content/upload上传文件,等待处理,填标题与描述,添加话题与声明,按文档跳过手动封面与配乐,再定时或立即发布。
连接 CDP 的代码片段在 SKILL.md「连接浏览器」一节,核心为 chromium.connectOverCDP 与 http://127.0.0.1:18800/json/version。
适用场景与注意¶
更适合谁
- 已在用 OpenClaw 管理 headed Chrome、并长期在创作者平台发稿的团队或个人
- 希望把「写稿 + 填表 + 话题/配乐/声明/定时」交给 Agent,且愿意维护 Playwright 与登录态的开发者
限制与坑(摘自技能文档)
- 强依赖 OpenClaw 浏览器与 CDP 端口;CDP 不通时需
openclaw browser stop && openclaw browser start - 图文、视频编辑区为 Slate.js:不宜直接
innerHTML,应使用keyboard.type或execCommand('insertText') - 图文打开编辑器建议 URL 加
&_=时间戳,避免草稿残留;配乐侧栏未关闭会挡住「发布」按钮 - 话题数量有上限(文档记录约 5 个);定时时间只写入
placeholder="日期和时间"的 input,避免误改标题框 - 页面 DOM 类名(如
.toolbar-button-spPS4r)随抖音前端迭代可能变化,需结合SKILL.md踩坑表维护
SkillHub 公开展示该 Skill 下载约 3180 次(统计会变动);腾讯安全扫描等结果为「安全,无风险」可在详情页查看,安装前仍建议自行审阅 SKILL.md 与脚本,必要时用 skillhub verify douyin-publish-article(需 CLI 版本不低于 2026.7.29,见 SkillHub 验签文档)。
结尾¶
「抖音全类型自动发布」把文章脚本化、图文与视频浏览器化三条链路写进同一套 Skill,并覆盖话题、配乐(文章/图文)、自主声明与定时等发布侧选项。若你的栈里已有 OpenClaw + 创作者平台登录态,值得把它装进 Agent 的 skills 目录,按体裁查阅 SKILL.md 执行。
- 安装与说明:
https://api.skillhub.cn/user_f4e1eca6/douyin-publish-article - SkillHub 详情:
https://www.skillhub.cn/skills/user_f4e1eca6/douyin-publish-article