Douyin Messager | 抖音私信

Douyin private messaging via browser automation. 抖音私信发送，通过浏览器自动化发送私信、获取聊天记录。Use when user needs to send 抖音私信、回复消息、查看聊天记录。Requires browser login. Triggers: 抖音...

Security Scan

The skill's instructions, required resources, and behavior are coherent with its stated purpose (browser-automated Douyin private messaging); it requests no extra credentials or installs, but it will capture screenshots/snapshots of private chats which is a privacy consideration the user should accept explicitly.

Purpose & Capability

Name/description (Douyin private messaging via browser automation) match the SKILL.md instructions: open douyin.com, find message UI, type+submit, scroll to read replies. No unrelated credentials, binaries, or installs are requested.

Instruction Scope

Instructions remain within the messaging scope (click, snapshot, type/submit, evaluate for scrolling). They explicitly require the user to be logged in and to close an xdg-open system dialog. The skill instructs the agent to take snapshots/screenshots of conversation content — necessary for confirming message delivery or reading replies, but this means private message contents will be captured and processed by the agent/image tools.

Install Mechanism

No install spec and no code files — instruction-only. No downloads, packages, or executable changes are requested, which minimizes supply-chain risk.

Credentials

The skill declares no environment variables, credentials, or config paths and the runtime instructions do not reference external secrets. Required access (browser automation and screenshots) is proportionate to the described functionality.

Persistence & Privilege

The skill is not always-enabled and does not request elevated or persistent system privileges, nor does it modify other skills or global agent config. Autonomous invocation is allowed by default but is not combined with other concerning privileges.

Assessment

This skill appears to do what it claims, but before installing consider: 1) it requires you to be logged into Douyin in the browser and to manually dismiss a Linux xdg-open dialog if it appears; 2) it will take snapshots/screenshots of private chats — those images and any extracted text will be visible to the agent and any image-processing tool it uses, so only use on accounts/conversations you are authorized to access; 3) follow Douyin/TikTok terms and avoid high-frequency automated messaging to prevent account action; and 4) test carefully in a safe environment first (not a primary account) to verify the agent's browser actions behave as you expect.

抖音私信发送 | Douyin Private Messaging

通过浏览器自动化发送抖音私信、获取聊天记录。

⚠️ 最大前提（必须满足）

在执行任何操作之前，必须确认以下两点：

1. 用户已登录抖音账号
2. 用户已关闭 xdg-open 弹窗（如果有）

标准执行流程

1. 打开抖音
2. 等待 2-3 秒
3. 【必须】询问用户："请确认：1) 已登录抖音账号  2) 已关闭 xdg-open 弹窗"
4. 用户确认后，继续后续操作

---

⚠️ xdg-open 系统弹窗

问题描述

打开抖音主页时，会触发 Linux 系统级的 xdg-open 弹窗：

Open xdg-open?
https://www.douyin.com wants to open this application.
[✓] Always allow www.douyin.com to open links of this type in the associated app
[Cancel] [Open]

关键点

特性	说明
弹窗类型	Linux 系统级，非浏览器内
AI 可见性	❌ 截图看不到
AI 可操作性	❌ 无法操作
阻塞性	✅ 阻止所有浏览器操作
永久关闭	❌ 目前无方法

解决方案

必须由用户手动关闭：点击 Cancel（不要点 Open）

AI 检测方法

如果出现以下情况，询问用户是否有弹窗：

• 操作突然无响应
• 截图显示页面正常但操作不执行
• 点击后没有反应

---

核心要点

1. 发送方式：必须用 type + submit，不要用 JavaScript 操作 DOM
2. 减少快照：快照数据量大，容易超时或断网
3. 输入框 ref：每次页面加载都会变化，需要重新获取快照
4. 连续执行：不要中途停止

---

发送私信流程

步骤 1：打开抖音首页

browser action=open profile=openclaw targetUrl=https://www.douyin.com/

步骤 2：等待页面加载

browser action=act request={"kind": "wait", "timeMs": 2000}

步骤 3：【必须】确认用户状态

询问用户："请确认：1) 已登录抖音账号 2) 已关闭 xdg-open 弹窗"

用户确认后继续。

步骤 4：获取快照，找到私信按钮和目标用户

browser action=snapshot

私信按钮特征：

- generic [cursor=pointer]:
    - img
    - paragraph: "私信"

用户列表特征：

- generic [cursor=pointer]:  <- 用户项
    - generic: "井媛"
    - generic: "置顶"

步骤 5：点击私信按钮

browser action=act request={"kind": "click", "ref": "<私信按钮ref>"}

步骤 6：点击目标用户

browser action=act request={"kind": "click", "ref": "<用户项ref>"}

步骤 7：等待 + 获取快照

browser action=act request={"kind": "wait", "timeMs": 500}
browser action=snapshot

输入框特征：

textbox [active] [ref=e3963]

步骤 8：发送消息

✅ 正确方法：

browser action=act request={"kind": "type", "ref": "<输入框ref>", "text": "消息内容", "submit": true}

❌ 错误方法（会导致乱码）：

browser action=act request={"kind": "evaluate", "fn": "() => { document.querySelector('...')... }"}

步骤 9：确认发送成功

browser action=screenshot

用 image 工具分析截图，确认消息出现在聊天记录中（蓝色气泡）。

---

获取对方回复

步骤 1：滚动聊天区域到底部

browser action=act request={"kind": "evaluate", "fn": "() => {
  const containers = document.querySelectorAll('[class*=\"scroll\"]');
  containers.forEach(c => { c.scrollTop = c.scrollHeight; });
  return 'Scrolled';
}"}

步骤 2：截图或快照

browser action=screenshot

或

browser action=snapshot

消息特征

类型	特征
自己发送	蓝色气泡，右侧，显示时间
对方发送	白色/灰色气泡，左侧，显示头像和名字

---

完整示例

# 1. 打开抖音
browser action=open profile=openclaw targetUrl=https://www.douyin.com/

# 2. 等待加载
browser action=act request={"kind": "wait", "timeMs": 2000}

# 3. 【必须】询问用户确认登录状态和弹窗

# 4. 获取快照
browser action=snapshot

# 5. 点击私信按钮
browser action=act request={"kind": "click", "ref": "e255"}

# 6. 点击目标用户
browser action=act request={"kind": "click", "ref": "e2215"}

# 7. 等待 + 获取快照
browser action=act request={"kind": "wait", "timeMs": 500}
browser action=snapshot

# 8. 发送消息
browser action=act request={"kind": "type", "ref": "e3963", "text": "你好！", "submit": true}

# 9. 确认
browser action=screenshot

---

常见问题

Q: 消息发送后显示乱码？

A: 不要用 JavaScript 操作 DOM。用 `type + submit`

Q: 看不到对方回复？

A: 新消息可能在可视区域外。先滚动到底部，再截图

Q: 输入框 ref 找不到或超时？

A: 输入框 ref 每次页面加载都会变化。重新获取快照查找 `textbox [active]`

Q: 私信面板找不到？

A: 确保已登录抖音账号。未登录时私信按钮不会显示

Q: 操作无响应？

A: 可能是 xdg-open 弹窗阻挡。询问用户是否有系统弹窗需要关闭

Q: 快照获取失败或断网？

A: 快照数据量大，可能超时。减少快照次数，只在必要时获取

---

注意事项

• 消息长度限制：500字符（超过需分段发送）
• 发送频率限制：避免刷屏
• 私信面板是悬浮窗：不会跳转页面
• 不要硬编码 DOM class 哈希值：它们会变化，用文本内容或相对位置判断

---

经验总结

问题	原因	解决方案
消息乱码	用 JS 操作 DOM	用 type + submit
看不到回复	新消息在可视区域外	先滚动到底部
输入框超时	ref 每次变化	重新获取快照
操作无响应	xdg-open 弹窗	用户手动关闭
快照断网	数据量大	减少快照次数

---

抖音私信自动化 🎵 版本：1.0.0 最后更新：2026-03-02