Douyin Messager

---
name: Douyin Messager | 抖音私信助手
description: "Send Douyin DMs, reply, and check chat history through browser automation. 自动发送抖音私信、回复消息、查看聊天记录。"
---

# Douyin Private Messaging | 抖音私信发送

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

## ⚠️ 执行前必须确认

1. **用户已登录抖音账号**（通常已登录，可目测判断）

**xdg-open 弹窗：只在 Linux 下存在，Windows/macOS 不需要检查。**
- Windows：`shell=powershell` 或 `os=Windows_NT`，**跳过 xdg-open 检查**
- Linux：`shell=bash`，**询问用户是否关闭了弹窗**

---

## 发送私信流程

### 步骤 1：打开抖音

```
browser action=open profile=openclaw targetUrl=https://www.douyin.com/
browser action=act request={"kind": "wait", "timeMs": 2000}
```

### 步骤 2：打开私信面板

**方式 A：置顶联系人（最快）**
1. 获取快照找到私信按钮，点击打开私信面板
2. 在私信列表中找目标用户名（注意：列表只显示最近联系人，不滚动看不到中间部分）
3. 点击目标 → 打开聊天窗口

**方式 B：搜索用户（普适）**
1. 点击顶栏搜索框，输入用户名
2. 在搜索结果中找到目标（优先选有"相互关注"标识的），点击进入主页
3. 点击主页的"私信"按钮 → 私信面板自动打开

> **注意**：私信面板是动态浮层，每次快照后元素 ref 会变化。优先用 JS evaluate 定位元素，少用 ref 点击。

### 步骤 3：用 JS 操作 Draft.js 输入框

**私信输入框是 Draft.js 富文本编辑器（`contenteditable`），不是普通 input，不能用 `type` 指令直接操作。**

**第一步：找到编辑器**

```javascript
browser action=act request={"kind": "evaluate", "fn": "() => { const all = document.querySelectorAll('*'); let panel = null; for (const el of all) { const r = el.getBoundingClientRect(); if (r.width >= 300 && r.width <= 400 && r.height >= 400 && r.height <= 700 && r.left >= 870 && r.left <= 1010) { if (el.textContent.includes('<目标用户名>') && el.textContent.includes('发送消息')) { panel = el; break; } } } if (!panel) return 'panel not found'; const editor = panel.querySelector('.public-DraftEditor-content'); if (!editor) return 'editor not found'; return 'found'; }"}
```

如果返回 `panel not found`，说明私信面板未打开，重新执行步骤 2。

**第二步：用剪贴板粘贴（绕过 Draft.js 事件拦截）**

```javascript
browser action=act request={"kind": "evaluate", "fn": "() => { const editor = document.querySelector('.public-DraftEditor-content'); if (!editor) return 'editor not found'; (editor.parentElement || editor).focus(); navigator.clipboard.writeText('消息内容').then(() => document.execCommand('paste')); return 'ok'; }"}
browser action=act request={"kind": "wait", "timeMs": 300}
```

**第三步：确认已写入**

```javascript
browser action=act request={"kind": "evaluate", "fn": "() => { const editor = document.querySelector('.public-DraftEditor-content'); if (!editor) return 'editor not found'; return editor.textContent.includes('消息内容') ? 'ok' : 'not written'; }"}
```

**第四步：发送（Enter 键）**

```javascript
browser action=act request={"kind": "evaluate", "fn": "() => { const editor = document.querySelector('.public-DraftEditor-content'); if (!editor) return 'editor not found'; editor.dispatchEvent(new KeyboardEvent('keydown', {key: 'Enter', code: 'Enter', keyCode: 13, which: 13, bubbles: true})); return 'sent'; }"}
browser action=act request={"kind": "wait", "timeMs": 1000}
```

### 步骤 4：确认发送成功

获取快照，检查私信列表中是否出现 `消息内容 · 刚刚`。

---

## 获取对方回复

### 滚动到底部

```javascript
browser action=act request={"kind": "evaluate", "fn": "() => { const panel = document.querySelector('[class*=\"w5duGc5Q\"], [class*=\"RoMuFUzT\"]'); if (!panel) return 'panel not found'; panel.scrollTop = panel.scrollHeight; return 'scrolled'; }"}
```

### 截图确认

```
browser action=screenshot
```

新消息气泡在可视区域底部之外，先滚动再截图。

---

## 完整示例（方式 A：置顶联系人）

```
# 1. 打开抖音
browser action=open profile=openclaw targetUrl=https://www.douyin.com/
browser action=act request={"kind": "wait", "timeMs": 2000}

# 2. 打开私信面板（JS 点击私信按钮）
browser action=act request={"kind": "evaluate", "fn": "() => { const all = document.querySelectorAll('*'); for (const el of all) { if ((el.textContent || '').trim() === '私信' && el.getBoundingClientRect().width < 100) { el.click(); return 'clicked'; } } return 'not found'; }"}
browser action=act request={"kind": "wait", "timeMs": 800}

# 3. 在私信列表中点击目标
browser action=act request={"kind": "evaluate", "fn": "() => { const all = document.querySelectorAll('[class*=\"w5duGc5Q\"], [class*=\"RoMuFUzT\"]'); for (const p of all) { const r = p.getBoundingClientRect(); if (r.width === 500 && Math.abs(r.left - 1006) < 50) { const items = p.querySelectorAll('[class*=\"cursor-pointer\"]'); for (const item of items) { if ((item.textContent || '').includes('<目标用户名>')) { item.click(); return 'clicked target'; } } } } return 'not found'; }"}
browser action=act request={"kind": "wait", "timeMs": 800}

# 4. 粘贴消息
browser action=act request={"kind": "evaluate", "fn": "() => { const editor = document.querySelector('.public-DraftEditor-content'); if (!editor) return 'editor not found'; (editor.parentElement || editor).focus(); navigator.clipboard.writeText('你好').then(() => document.execCommand('paste')); return 'ok'; }"}
browser action=act request={"kind": "wait", "timeMs": 300}

# 5. 发送
browser action=act request={"kind": "evaluate", "fn": "() => { const editor = document.querySelector('.public-DraftEditor-content'); editor.dispatchEvent(new KeyboardEvent('keydown', {key: 'Enter', code: 'Enter', keyCode: 13, which: 13, bubbles: true})); return 'sent'; }"}
browser action=act request={"kind": "wait", "timeMs": 1000}

# 6. 确认
browser action=snapshot
```

---

## 完整示例（方式 B：搜索用户）

```
# 1. 打开抖音
browser action=open profile=openclaw targetUrl=https://www.douyin.com/
browser action=act request={"kind": "wait", "timeMs": 2000}

# 2. 搜索目标用户名
browser action=act request={"kind": "evaluate", "fn": "() => { const input = document.querySelector('input[type=\"text\"]'); if (!input) return 'input not found'; input.focus(); input.value = '<目标用户名>'; input.dispatchEvent(new Event('input', {bubbles: true})); return 'typed'; }"}
browser action=act request={"kind": "evaluate", "fn": "() => { const btns = document.querySelectorAll('button'); for (const b of btns) { if ((b.textContent || '').includes('搜索')) { b.click(); return 'search clicked'; } } return 'not found'; }"}
browser action=act request={"kind": "wait", "timeMs": 2000}

# 3. 在结果中点击目标主页（选有"相互关注"标识的条目）
browser action=snapshot
# 找到目标条目后点击进入主页

# 4. 点击主页"私信"按钮
browser action=act request={"kind": "evaluate", "fn": "() => { const btns = document.querySelectorAll('button'); for (const b of btns) { if ((b.textContent || '').trim() === '私信') { b.click(); return 'clicked'; } } return 'not found'; }"}
browser action=act request={"kind": "wait", "timeMs": 800}

# 5. 粘贴 + 发送（与方式 A 相同）
browser action=act request={"kind": "evaluate", "fn": "() => { const editor = document.querySelector('.public-DraftEditor-content'); if (!editor) return 'editor not found'; (editor.parentElement || editor).focus(); navigator.clipboard.writeText('你好').then(() => document.execCommand('paste')); return 'ok'; }"}
browser action=act request={"kind": "wait", "timeMs": 300}
browser action=act request={"kind": "evaluate", "fn": "() => { const editor = document.querySelector('.public-DraftEditor-content'); editor.dispatchEvent(new KeyboardEvent('keydown', {key: 'Enter', code: 'Enter', keyCode: 13, which: 13, bubbles: true})); return 'sent'; }"}
browser action=act request={"kind": "wait", "timeMs": 1000}
```