Agent-Skills.md

Agent Skills: 抖音发布 v2.0 — OpenClaw Browser 自动化

抖音图文/视频发布（OpenClaw Browser 自动化）：登录检测→内容校验→上传页导航→填标题/正文→上传封面+素材→暂存离开。

UncategorizedID: aaaaqwq/claude-code-skills/douyin-publisher

Repository

aaaaqwq/claude-code-skills
aAAaqwqLicense: MIT
7317

Install this agent skill to your local

pnpm dlx add-skill https://github.com/aAAaqwq/AGI-Super-Team/tree/HEAD/skills/douyin-publisher

Skill Files

Browse the full folder contents for douyin-publisher.

Download Skill

Loading file tree…

skills/douyin-publisher/SKILL.md

Skill Metadata

Name
douyin-publisher
Description
"抖音图文/视频发布（OpenClaw Browser 自动化）：登录检测→内容校验→上传页导航→填标题/正文→上传封面+素材→暂存离开。"

description: "抖音图文/视频发布（OpenClaw Browser 自动化）：登录检测→内容校验→上传页导航→填标题/正文→上传封面+素材→暂存离开。默认只存草稿，Daniel确认后才发布。触发：'发抖音'、'抖音发布'、'douyin publish'、'抖音图文'、'抖音视频'、'发布短视频'。" author: Daniel Li version: 2.0.0

抖音发布 v2.0 — OpenClaw Browser 自动化

核心技术栈：OpenClaw browser 工具（不依赖独立 Playwright 脚本） 安全原则：默认只存草稿，只在 Daniel 明确确认后才允许点击发布

⚠️ 安全铁律

  1. 默认 mode=draft — 每次发布流程终点是「暂存离开」，不是「发布」
  2. 发布确认门 — 收到 Daniel 明确回复"可以发/发布/ok"后，才允许切换到发布
  3. 每步截图 — 关键节点截图留证，失败时有据可查
  4. 3次失败即停 — 任何步骤连续失败3次，截图+报告+转"待 Daniel 接管"
  5. 遇到验证码/滑块/频率限制 — 立刻停止，截图，等 Daniel 处理

📋 发布前合规检查

发布前参考 references/platform-rules.md 确认内容合规：

  • 社区公约11大类违规内容
  • AIGC 标识要求（"内容由AI生成"）
  • 账号健康分要求
  • 禁止搬运/水印/低质内容

🔄 完整 Workflow（6步）

Step 1: 登录检测 ──→ Step 2: 内容检测 ──→ Step 3: 进入发布页
                                                      │
Step 6: 暂存离开 ←── Step 5: 上传素材 ←── Step 4: 填写内容
     │
     ▼
 确认回传给 Daniel

Step 1: 登录检测

目标：确认浏览器已登录抖音创作者平台，未登录则发送二维码给 Daniel

1.1 打开浏览器

browser(action="open", url="https://creator.douyin.com/creator-micro/home", profile="user")

profile="user" 使用 Daniel 的本地浏览器（已有登录态概率最高） 如果 user profile 不可用，使用默认 profile（OpenClaw 托管浏览器）

1.2 等待页面加载 & 检测登录状态

browser(action="snapshot")

判断是否已登录：

  • ✅ 已登录：URL 包含 creator-micro，页面出现创作者后台内容
  • ❌ 未登录：URL 包含 login/passport，或页面出现「扫码登录」「验证码登录」

1.3 未登录处理：发二维码

如果未登录：

# 截取二维码区域
browser(action="screenshot", path="/tmp/douyin_qr_login.png")

然后发消息给 Daniel：

message(action="send", message="⚠️ 抖音未登录，请扫描二维码登录。登录完成后回复"ok"",
        media="/tmp/douyin_qr_login.png")

等待 Daniel 回复后，重新检测：

browser(action="navigate", url="https://creator.douyin.com/creator-micro/home")
# 等待 5 秒让页面加载
browser(action="snapshot")
# 确认已进入创作者后台

1.4 成功标志

截图确认并记录：

browser(action="screenshot", path="/tmp/douyin_step1_logged_in.png")

Step 2: 内容及素材检测

目标：在动手前确认所有文件就绪、格式正确、内容合规

2.1 检查素材文件

# 确认文件存在、格式、大小
ls -lh /path/to/images/*.jpg /path/to/cover.png
file /path/to/images/*.jpg

图文要求： | 项目 | 要求 | |------|------| | 图片数量 | 2-35 张 | | 格式 | JPG, PNG, WebP（不支持 GIF） | | 单张大小 | ≤50MB | | 推荐比例 | 3:4（1080×1440）或 4:3 |

视频要求： | 项目 | 要求 | |------|------| | 格式 | MP4 (H.264) | | 分辨率 | ≥720×1280，推荐 1080×1920 | | 大小 | ≤16GB | | 时长 | 15秒-60分钟 |

2.2 检查文本内容

# 确认标题和描述文件
cat /path/to/content.md

校验规则：

  • 标题 ≤20字（实测图文页标题框限制20字）
  • 描述 ≤200 字（含话题标签）
  • 话题 3-5 个，格式 #话题名（无空格）
  • AI 内容已标注"内容由AI生成"

2.3 输出检测报告

向 Daniel 确认：

📋 内容检测报告
━━━━━━━━━━━━━━
📌 标题：{title}（{len}字）
📝 描述：{desc[:50]}...（{len}字）
🏷️ 话题：{tags}
🖼️ 素材：{count} 张图片 / {video} 视频
📐 格式：{formats}
📦 大小：{total_size}

✅ 全部就绪，开始发布流程

Step 3: 进入抖音图文发布页面

目标：导航到正确的发布页面，处理好可能的弹窗

3.1 导航

图文发布：

browser(action="navigate", url="https://creator.douyin.com/creator-micro/content/upload?default-tab=3")

视频发布：

browser(action="navigate", url="https://creator.douyin.com/creator-micro/content/upload")

3.2 等待页面就绪

# 等待文件上传控件出现（证明页面已完全加载）
browser(action="snapshot")

检查 snapshot 中是否有 input[type="file"]。如果没有：

  • 等待 5 秒再试
  • 如果 30 秒内仍未出现，可能被弹窗遮挡 → 处理弹窗

3.3 处理干扰弹窗

抖音经常弹出"上次未发布内容"提示。检测并关闭：

browser(action="act", kind="evaluate", fn="""() => {
    const els = document.querySelectorAll('*');
    for (const el of els) {
        const t = el.textContent.trim();
        if ((t === '放弃' || t === '不再提醒' || t === '新建图文')
            && el.offsetParent !== null && el.children.length === 0) {
            el.click();
            return 'dismissed: ' + t;
        }
    }
    return 'no popup';
}""")

3.4 截图确认

browser(action="screenshot", path="/tmp/douyin_step3_publish_page.png")

Step 4: 填写标题和正文

目标：在发布页面填入标题和描述（含话题标签）

4.1 填写标题

找到标题输入区（优先使用 snapshot 中的 ref）：

# 方法1：通过 placeholder 定位（推荐）
browser(action="act", kind="fill", ref="{title_input_ref}", text="{标题文字}")

# 方法2：通过 evaluate 直接操作
browser(action="act", kind="evaluate", fn="""() => {
    const sel = 'input[placeholder*="标题"]';
    const el = document.querySelector(sel);
    if (el) {
        el.focus();
        el.select();
        el.value = '';
        // 触发 React 的 onChange
        const nativeInputValueSetter = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'value').set;
        nativeInputValueSetter.call(el, arguments[0]);
        el.dispatchEvent(new Event('input', { bubbles: true }));
        el.dispatchEvent(new Event('change', { bubbles: true }));
        return 'title filled';
    }
    return 'title input not found';
}""")

注意：抖音是 React SPA，直接 .value = xxx 不会触发状态更新。必须用 nativeInputValueSetter 或 type 动作。

4.2 填写描述（正文）⚠️ 关键步骤

2026-04-17 实战验证结论： 抖音描述区使用 Slate.js (data-slate-editor="true")，不是普通 textarea。

  • ❌ innerText = xxx → 视觉显示但 Slate 状态不更新，暂存后丢失
  • ❌ document.execCommand('insertText') 多次调用 → 文本叠加，无法清空已有内容
  • ❌ ClipboardEvent('paste') → 浏览器安全策略阻止，Slate 读不到数据
  • ❌ new InputEvent('beforeinput') → Slate preventDefault() 后不执行实际插入
  • ❌ browser act kind=type → contenteditable div 无 Playwright ref，超时
  • ❌ browser act kind=fill → 不支持 contenteditable
  • ✅ 唯一可靠方法：从全新页面一次性 execCommand('insertText')，且只能调用一次

正确流程（必须在全新空白编辑器上执行）：

# Step 1: 聚焦描述区
browser(action="act", kind="evaluate", fn="""() => {
    const desc = document.querySelector('[data-slate-editor="true"]');
    if (!desc) return 'not found';
    desc.focus();
    return 'focused';
}""")

# Step 2: 一次性插入文本（只能执行一次！）
browser(action="act", kind="evaluate", fn="""() => {
    const desc = document.querySelector('[data-slate-editor="true"]');
    if (!desc) return 'not found';
    
    const text = '你的描述文字（建议≤200字，含#话题标签）';
    document.execCommand('insertText', false, text);
    
    // 触发 blur 确保 Slate 最终提交状态
    desc.blur();
    
    return 'inserted: ' + desc.innerText.length + ' chars';
}""")

# Step 3: 验证字数计数器已更新（从 0/N 变为实际字数/N）
browser(action="snapshot")
# 检查描述区域文本中是否显示 "实际字数 / 1000"

验证要点：

  • 描述区字数计数器从 0 / 1000 变为 实际字数 / 1000 → ✅ React 状态已更新
  • 如果计数器仍是 0 / 1000 → ❌ 文本未写入 Slate 状态，暂存后会丢失

注意事项：

  • 描述中包含 # 时抖音可能弹出话题搜索面板，此时需先点击面板外部关闭
  • execCommand('insertText') 在已有内容的 Slate 编辑器上无法正确清空（selectAll+delete 无效）
  • 如果描述填错，必须清空重新上传（点「清空并重新上传」按钮），重新走整个流程
  • 不要尝试多次调用 execCommand，每次都会在现有文本基础上追加

4.3 话题标签

直接在描述文本中包含 #话题1 #话题2 即可，Slate 会自动识别。 不要单独追加话题，会导致文本叠加问题。

4.4 截图确认

browser(action="screenshot", path="/tmp/douyin_step4_content_filled.png")

Step 5: 上传封面及素材图片

目标：上传图片素材到发布页面

5.1 定位文件上传控件

# 通过 snapshot 获取 file input 的 ref
browser(action="snapshot")

找到 input[type="file"][accept*="image"] 的 ref。

5.2 上传素材图片

2026-04-17 实战验证：

  • file:// fetch 被浏览器安全策略阻止
  • evaluate 中的 DataTransfer + File 构造同样被阻止
  • 文件必须放在 /tmp/openclaw/uploads/ 目录下

正确方法（已验证）：

# Step 1: 复制文件到 uploads 目录
# cp /path/to/images/*.jpg /tmp/openclaw/uploads/

# Step 2: 点击上传按钮触发 file chooser
browser(action="snapshot")  # 获取上传按钮 ref
browser(action="act", kind="click", ref="{upload_btn_ref}")  # e.g. ref=e8 "上传图文"

# Step 3: 通过 browser upload 上传文件
browser(action="upload", paths=[
    "/tmp/openclaw/uploads/img1.jpg",
    "/tmp/openclaw/uploads/img2.jpg",
    "/tmp/openclaw/uploads/img3.jpg"
])

# Step 4: 等待上传处理完成（页面显示"加载中"→编辑器就绪）
browser(action="act", kind="wait", timeMs=10000)

# Step 5: 验证 — snapshot 应显示"已添加N张图片"和编辑区按钮
browser(action="snapshot")

⚠️ 失败方法（不要使用）：

方法 B（已废弃）：通过 evaluate 直接设置 file input

browser(action="act", kind="evaluate", fn="""async () => {
    const input = document.querySelector('input[type="file"][accept*="image"]');
    if (!input) return 'file input not found';

    const files = [
        '/path/to/img1.jpg',
        '/path/to/img2.jpg',
        '/path/to/img3.jpg',
    ];

    // 通过 Playwright 的 setInputFiles（如果可用）
    // 或通过 DataTransfer API
    const dt = new DataTransfer();
    for (const path of files) {
        const resp = await fetch('file://' + path);
        const blob = await resp.blob();
        const file = new File([blob], path.split('/').pop());
        dt.items.add(file);
    }
    input.files = dt.files;
    input.dispatchEvent(new Event('change', { bubbles: true }));
    return 'files set: ' + files.length;
}""")

注意：方法 B 在某些浏览器安全策略下可能被阻止。如果方法 B 失败，使用方法 A。

5.3 等待上传完成

图片上传后，抖音需要处理（压缩、生成缩略图等）。等待信号：

# 等待编辑器按钮出现（表示上传处理完成）
browser(action="act", kind="wait", timeMs=5000)

# 检查是否出现了"暂存离开"/"发布"按钮
browser(action="snapshot")

上传完成标志：

  • 页面底部出现「暂存离开」「发布」按钮
  • 图片预览区域显示已上传的图片缩略图
  • 无"上传中"或进度条

5.4 调整封面

如果需要指定封面（从已上传图片中选择）：

# 点击封面设置区域
browser(action="act", kind="click", ref="{cover_area_ref}")

# 等待封面选择弹窗
browser(action="act", kind="wait", timeMs=2000)

# 选择指定图片作为封面（通常点击图片缩略图即可）
browser(action="act", kind="click", ref="{target_image_ref}")

# 确认选择
browser(action="act", kind="click", ref="{confirm_btn_ref}")

5.5 重试机制

如果上传失败：

  • 第1次失败：等待 10 秒后重试
  • 第2次失败：等待 30 秒后重试
  • 第3次失败：停止，截图，报告，转"待 Daniel 接管"

5.6 截图确认

browser(action="screenshot", path="/tmp/douyin_step5_assets_uploaded.png")

Step 6: 暂存离开（默认终点）

目标：点击「暂存离开」将内容保存到草稿箱

6.1 关闭遮挡弹窗

提交前先处理可能的弹窗（共创中心推广等）：

browser(action="act", kind="evaluate", fn="""() => {
    const els = document.querySelectorAll('*');
    for (const el of els) {
        const t = el.textContent.trim();
        // 只关闭"我知道了"类提示，不要误关"确认"类弹窗
        if (t === '我知道了' && el.offsetParent !== null && el.children.length === 0) {
            el.click();
            return 'closed: ' + t;
        }
    }
    return 'no popup';
}""")

⚠️ 安全原则：只关闭明确无害的提示弹窗（"我知道了"）。 绝对不要关闭包含"确认""放弃"等有歧义文案的弹窗——先截图发给 Daniel 确认。

6.2 找到暂存按钮

browser(action="snapshot")

在 snapshot 中查找以下任一按钮： | 文案 | selector | |------|----------| | 暂存离开 | 图文页最常见 | | 存草稿 | 视频页常见 | | 草稿 | 部分版本 |

6.3 点击暂存

# 使用 snapshot 中获取的 ref
browser(action="act", kind="click", ref="{draft_button_ref}")

6.4 处理提交后弹窗

点击后可能出现确认弹窗：

browser(action="act", kind="wait", timeMs=3000)

# 检查是否有"暂存"确认按钮
browser(action="act", kind="evaluate", fn="""() => {
    const els = document.querySelectorAll('*');
    for (const el of els) {
        const t = el.textContent.trim();
        if ((t === '暂存' || t === '确认' || t === '我知道了')
            && el.offsetParent !== null && el.children.length === 0) {
            el.click();
            return 'clicked: ' + t;
        }
    }
    return 'no post-submit popup';
}""")

6.5 等待成功信号

browser(action="act", kind="wait", timeMs=5000)

成功标志：

  • URL 跳转到草稿管理页 content/manage
  • 页面出现"保存成功""草稿已保存"等文字
  • 上传页面关闭

6.6 重试机制

如果暂存失败：

  • 检查是否按钮被禁用 → 可能内容未填完整
  • 检查是否有报错弹窗 → 截图发给 Daniel
  • 第1次失败：等待 5 秒重试
  • 第2次失败：等待 10 秒重试
  • 第3次失败：停止，截图，报告

6.7 最终截图确认

browser(action="screenshot", path="/tmp/douyin_step6_draft_saved.png")

📤 确认回传（Step 7: 汇报）

发布流程结束后，向 Daniel 发送标准报告：

📋 抖音发布报告
━━━━━━━━━━━━━━
📌 标题：{title}
📝 描述：{desc[:80]}...
🏷️ 话题：{tags}
🖼️ 素材：{count} 张图片 / 视频
📐 封面：{cover_status}
✅ 状态：已存草稿 / 待确认发布 / 待接管
📸 截图：{screenshot_path}
🔗 草稿管理：https://creator.douyin.com/creator-micro/content/manage

附上最终截图作为确认凭证。

🚀 发布流程（仅在 Daniel 确认后执行）

如果 Daniel 确认要发布（而非只存草稿），替换 Step 6：

6-Alt: 点击发布

# 找到发布按钮
browser(action="snapshot")
# 查找 "button:has-text('发布')" 的 ref

# 点击发布
browser(action="act", kind="click", ref="{publish_button_ref}")

发布后等待成功信号（同 6.5），截图确认。

🔧 错误处理总表

| 失败点 | 重试策略 | 停止条件 | |--------|---------|---------| | 登录检测 | 重新打开页面 | 转人工扫码 | | 二维码登录 | 等待 Daniel | 超时120秒 | | 文件不存在 | 报告缺失文件 | 立即停止 | | 格式不支持 | 报告并建议转换 | 立即停止 | | 页面加载超时 | 刷新重试 | 3次失败 | | 弹窗干扰 | 关闭提示弹窗 | 误关严重弹窗则停止 | | 标题填写失败 | 重试 | 3次失败 | | 描述填写失败 | 重试 | 3次失败 | | 图片上传失败 | 指数退避重试 | 3次失败 | | 封面设置失败 | 跳过（非阻塞） | — | | 暂存按钮未找到 | 检查文案变体 | 3次失败 | | 暂存后无成功信号 | 检查草稿箱 | 3次失败 | | 验证码/滑块 | 立即停止 | 等 Daniel 处理 | | 频率限制 | 立即停止 | 等30分钟 |

🔗 平台入口速查

| 页面 | URL | |------|-----| | 创作者首页 | https://creator.douyin.com/creator-micro/home | | 图文发布 | https://creator.douyin.com/creator-micro/content/upload?default-tab=3 | | 视频发布 | https://creator.douyin.com/creator-micro/content/upload | | 草稿管理 | https://creator.douyin.com/creator-micro/content/manage |

📝 发布时间建议

| 时段 | 推荐度 | |------|--------| | 7:00-9:00 | ⭐⭐⭐ | | 11:30-13:00 | ⭐⭐⭐ | | 17:30-19:00 | ⭐⭐⭐ | | 20:00-22:00 | ⭐⭐⭐⭐⭐ | | 22:00-00:00 | ⭐⭐⭐⭐ |

📁 文件结构

douyin-publish/
├── SKILL.md                          ← 本文件（workflow 主文件）
├── references/
│   ├── platform-rules.md             ← 完整平台规则
│   ├── handoff-and-human-trace.md    ← 接管规则与人类痕迹规范
│   └── content-style-guide.md        ← 内容风格指南
└── templates/
    ├── desc-template.md              ← 描述排版模板
    └── video-script-template.md      ← 视频脚本模板

📝 "人类痕迹"最小规范

避免"机器人味"

  • 描述不要全是同一种句式：允许1句短钩子 + 1-2句解释 + 1句CTA
  • emoji 适度：每2-3句1个
  • 话题不要固定模板：1-2精准 + 1-2场景 + 0-1泛
  • 避免堆"上热门/涨粉"等低质话题

v2.0.0 (2026-04-17): 全面重构 — 从 Playwright 脚本迁移到 OpenClaw Browser 自动化 v2.0.1 (2026-04-17): Step 4 描述填写修复 — Slate.js 只能 execCommand 单次插入；Step 5 上传路径修复 v1.0.0 (2026-03-27): 初始版本，Playwright 脚本实现