twitter-post

name	twitter-post
description	Compose and publish a post (text, image, or video) to Twitter/X using camoufox-cli (headless browser automation; built-in browser tool only as fallback). Supports single posts, threads, quote tweets, reply tweets, and long posts (Premium/Blue up to 25,000 chars).
metadata	{"openclaw":{"emoji":"🐦"}}

Twitter/X 发布技能

Use this skill when:

• The user wants to post text, images, or video to Twitter/X
• You need to share a created article excerpt or key insights on X
• You need to cross-post content to international audiences
• You need to quote tweet another post with your own comment
• You need to reply to a specific tweet (engagement use case)
• You have a Premium/Blue account and need long post (up to 25,000 chars)

Prerequisites: camoufox-cli session 已登录 x.com（登录态持久化在 session profile 里）。冷会话先访问一次首页预热。本 skill 与 login-manager 完全无关——Twitter 发布是纯浏览器操作，走持久化 session twitter（与 twitter-interact 共用同一个 session 名 twitter，靠 session 名字符串约定共享同一 profile 目录与登录态——twitter-interact 登录后 twitter-post 不需重登，反之亦然），登录态在 session profile 里闭环，不导出 cookie/UA 落中央存储。

探活与登录（本 skill 自管，不走 login-manager）

走持久化 session twitter（与 twitter-interact 共用）。探活方式：开 session open 平台首页 + snapshot 看是否跳登录页。

# 探活（默认无头模式）
camoufox-cli --session twitter --persistent --json open "https://x.com/"
sleep 3
camoufox-cli --session twitter --json snapshot
# snapshot 看页面是否跳到登录页 / 出现登录按钮 / 推文是否正常可见
# → 没跳登录页、内容正常 = 登录态有效，探活完即 close session（登录态在磁盘 profile，后续操作按需重起无头复用）
# → 跳到登录页 / 出现登录按钮 = 登录态失效，走重登

重登流程（失效时）——登录流程按 browser-guide skill 走有头手动登录（手机号+验证码 / Twitter APP 扫码），登录导出后close session——登录态落磁盘 profile + 中央存储，不留进程占内存。本 skill 做发布操作 + twitter-interact 做互动操作时用 --session twitter --persistent 重起无头即恢复，用完再 close。只在 session 卡死时由调用方手动 camoufox-cli --session twitter --json close teardown。

# X 登录风控对无头 + QR 识别严格，有头人工登录最稳
camoufox-cli --session twitter --persistent --headed --json open "https://x.com/login"
# 告知用户「**Twitter/X** 浏览器已打开，请在窗口里手动完成登录（账号密码 / 手机 APP 扫码），完成后告诉我」
# 等用户回复后 snapshot 验登录态就位
# 登录就位后 close session——登录态落磁盘 profile，本 skill + twitter-interact 按需重起无头复用

不导出 cookie/UA——登录态只在 session profile 里闭环，不落 ~/.openclaw/logins/。本 skill 不调用 cookies export / identity export。

---

浏览器方案（重要）

优先 camoufox-cli，且除了登录外，其他都可以默认的无头方式进行

下面 workflow 步骤（Navigate / Click / snapshot eval / upload）默认用 camoufox-cli 执行。若 camoufox-cli 在 X 上持续触发风控，等 60s 后开新 session 重试；仍触发则报告用户该平台当日风控未解，择日再试。

---

通用约束

• 文件上传用 forked camoufox-cli 的 upload 命令（camoufox-cli --session <s> --persistent --json upload <ref> <file>，底层 Playwright setInputFiles，无需 DataTransfer hack）
• 正文输入使用 type + slowly: true，不要用 fill()

字符计数规则（X 平台特殊）

• URL 永远算 23 字符（不论实际长度）— 在算 limit 时要预先扣除
• Emoji 算 2 字符 / 个
• 标准 280 字符限制（普通账号）
• Premium/Blue 25,000 字符（"long post"，URL bar 显示"Post all"而非"Post"）

Anti-automation limit

• 单条帖 ≥ 30 min 间隔（不是 15 min——30 min 是平台风险阈值）
• 单日 ≤ 50 帖（含 reply / quote / retweet / 长帖）
• 单周 ≤ 200 帖
• 触发风控后 24h 静默
• 频次跟踪：写到 ~/.openclaw/agents/main/sessions/twitter-frequency.json（每次 post 后 append）

---

Post Types 决策表

场景	用哪个 Workflow	入口 URL
新推纯文/图/视频	Workflow: Post Plain Text / Image / Video	https://x.com/compose/post
推连续串	Workflow: Thread	https://x.com/compose/post
引用某推+评论	Workflow: Quote Tweet	https://x.com/compose/post（从其他推页 quote）
回复某推	Workflow: Reply to Tweet	https://x.com/<user>/status/<id>（回复按钮）
长文（>280 字符）	Workflow: Long Post	https://x.com/compose/post（检测 Premium 蓝标）
标准帖发后取 stats	Workflow: Post Parse Stats	任意已发推

---

Workflow: Post Plain Text

1. Navigate to https://x.com/compose/post
2. Wait for the compose box to load
3. Click into the text area and type the content
   - Plain text only (no Markdown)
   - Max 280 characters for standard accounts
4. Verify character count — trim if over limit
5. **立即点击 "Post" 按钮——不要等待用户确认！**
6. Wait for success confirmation (URL changes or "Your post was sent" toast)
7. Extract and report the post URL
8. **Parse stats**：
   - snapshot eval: `JSON.stringify({
       retweet: document.querySelector('[data-testid="retweet"]')?.innerText,
       like: document.querySelector('[data-testid="like"]')?.innerText,
       reply: document.querySelector('[data-testid="reply"]')?.innerText,
       view: document.querySelector('[href*="/analytics"]')?.innerText,
       permalink: window.location.href
     })`
9. Update frequency tracker

---

Workflow: Post with Image

1. Navigate to https://x.com/compose/post
2. Wait for the compose box to load
3. Upload the image file using camoufox-cli upload（见下方选择器说明）
4. Wait for image upload to complete (thumbnail / "Media" group appears)
5. Click into the text area and type the caption
   - Plain text only (no Markdown)
   - Max 280 characters for standard accounts
6. **立即点击 "Post" 按钮——不要等待用户确认！**
7. Wait for confirmation and report the post URL
8. Parse stats (same as plain text)
9. Update frequency tracker

文件上传选择器（重要）

X compose 页面有两个 <input type="file" data-testid="fileInput"> 元素（可见 + 隐藏），直接用 input[type=file] 或 [data-testid=fileInput] 会触发 Playwright strict mode violation: resolved to 2 elements。

必须用 >> nth=0 消歧：

camoufox-cli --session twitter --persistent --json upload "[data-testid=fileInput] >> nth=0" /path/to/image.jpg

forked cli 的 upload 命令底层走 Playwright setInputFiles，#穿透 shadow DOM，无需 locator.drop() hack。

---

Workflow: Post with Video

1. Navigate to https://x.com/compose/post
2. Click the media icon
3. Upload the video file (MP4 recommended, max 512MB, max 2min 20sec)
4. Wait for video processing — this can take 30–120 seconds or more for larger files. Look for the thumbnail preview to confirm completion.
5. Click into the caption area and type the caption
   - Plain text only (no Markdown)
   - Max 280 characters for standard accounts
6. **立即点击 "Post" 按钮——不要等待用户确认！**
7. Wait for upload confirmation and report the post URL
8. Parse stats (same as plain text)
9. Update frequency tracker

---

Workflow: Thread (multiple posts)

1. Navigate to https://x.com/compose/post
2. Click into the compose box and type the first tweet
   - Plain text only (no Markdown)
   - Max 280 characters for standard accounts
3. Click the "+" icon to add another tweet to the thread
4. Click into the new compose box and type the second tweet
   - Plain text only (no Markdown)
   - Max 280 characters for standard accounts
5. Repeat for each additional tweet
6. Click "Post all" to publish the full thread
7. Parse stats for the **last** tweet (representative)
8. Update frequency tracker (count = number of tweets in thread)

---

Workflow: Quote Tweet

场景：引用别人的推 + 自己的评论（BD / 互动 / 营销场景强）

1. Navigate to source tweet URL（如 https://x.com/username/status/1234567890）
2. Click "Repost" icon → 选择 "Quote"（不是 "Repost"）
   - ⚠️ 区分 "Repost"（纯转推，无评论）vs "Quote"（引用+评论）
3. Compose box 打开，**已自动填入引用卡片**
4. Click into text area below the quoted card
5. Type your comment (max 280 chars)
6. Verify character count
7. **立即点击 "Post" 按钮**
8. Wait for confirmation, report post URL
9. Parse stats (same as plain text)
10. Update frequency tracker

Pitfall：

• ❌ 选 "Repost" 而不是 "Quote" → 推出去没评论，BD 场景失去意义
• ❌ 评论超过 280 字符 → 按钮变灰，不自动转 Long post
• ❌ 评论里直接放 raw URL（占 23 字符）→ 实际可发字符更少

---

Workflow: Reply to Tweet

场景：BD 监控 mentions → 智能回复（也可作 twitter-interact skill 的入口）

1. Navigate to source tweet URL（如 https://x.com/username/status/1234567890）
2. Click "Reply" icon（不是 reply 文本框）
3. Compose box 打开，**自动显示 reply context**
4. Type your reply (max 280 chars)
5. Verify character count
6. **立即点击 "Reply" 按钮**（不是 "Post"）
7. Wait for confirmation, report reply URL
8. Parse stats (replies can also get view counts)
9. Update frequency tracker

Pitfall：

• ❌ 选 "Reply" 时落入 quote 模式（X 旧 UI 行为）→ 不会加 reply 关系
• ❌ 串太长（> 280）→ 按钮变灰
• ❌ 频率过高 → 风控（见 Anti-automation limit）

---

Workflow: Long Post

前置：用户是 Premium / Blue 订阅（X 蓝标）。普通账号本工作流不适用。

检测 Premium：

snapshot eval: document.querySelector('[data-testid="icon-verified"]') !== null
// 或 UI 中是否有 "Premium" 字样

1. Navigate to https://x.com/compose/post
2. Wait for compose box to load
3. Type content up to 25,000 chars
4. **注意**：URL 仍 23 字符，Emoji 仍 2 字符
5. 按钮文字从 "Post" 变成 "**Post all**"（X 长帖是 1 个"post all"动作，但内容被服务端分页）
6. Click "Post all"
7. Wait for confirmation (URL changes)
8. Extract permalink (实际是 thread 形式：tweet + 续贴)
9. Parse stats for **first** tweet
10. Update frequency tracker (count = 1，long post 算 1 次)

Pitfall：

• ❌ 普通账号硬塞 25K → 按钮变灰 / 截断
• ❌ 不验 Premium 状态 → 普通账号调本工作流失败率高
• ⚠️ Long post 实际上服务端分页（thread-like），permalink 拿的是 first tweet

---

Workflow: Post Parse Stats

post 后立即拿 stats（view / reply / retweet / like），用于复盘。

1. After post success (any workflow ending with "Wait for confirmation")
2. 已在推文页面，URL = https://x.com/<user>/status/<id>
3. Wait 3-5s for X to populate stats
4. snapshot eval:
   const stats = JSON.stringify({
     retweet: document.querySelector('[data-testid="retweet"]')?.innerText,
     like: document.querySelector('[data-testid="like"]')?.innerText,
     reply: document.querySelector('[data-testid="reply"]')?.innerText,
     view: document.querySelector('a[href*="/analytics"]')?.innerText,
     bookmark: document.querySelector('[data-testid="bookmark"]')?.innerText,
     permalink: window.location.href
   })
5. Output: { ok, permalink, stats: { retweet, like, reply, view, bookmark } }

注意：

• view 数 Premium 账号可见；普通账号无
• 30 min 后 stats 才稳定（X 算法）
• 嵌入 evaluate 走 document.querySelector('selector')?.innerText —— selector 可能因 X UI 改版变，部署后真机验证（见 docs/post-deploy-verification.md）

---

Frequency Tracker（新）

# ~/.openclaw/agents/main/sessions/twitter-frequency.json
{
  "last_post_at": "2026-07-05T09:30:00+08:00",
  "today_count": 5,
  "week_count": 23,
  "platform": "twitter"
}

每次 post 成功后 append：

1. 读 JSON（不存在则初始化 0/0）
2. 距 last_post_at < 30 min → 警告用户 + 询问是否继续（仍可继续，但 mark as high-risk）
3. 距 last_post_at < 5 min → 强制建议延后（强烈风控风险）
4. today_count += N（thread 算 N 条）
5. today_count > 50 → 拒绝 + 告知用户明早再发
6. week_count > 200 → 同上
7. 写入 JSON

---

Content Limits

Type	Limit
Text (standard)	280 characters (URL=23, Emoji=2)
Text (Premium/Blue)	25,000 characters (long post)
Images	Up to 4 per post
Video	Max 512 MB, max 2m 20s
GIF	Max 15 MB
Reply	280 characters
Quote Tweet	280 characters (in comment)
Thread	Unlimited tweets, each ≤ 280

---

Error Handling

Situation	Action
Login page appears	Session expired — inform user to re-login via browser
Character limit exceeded (280)	Trim content or use thread format
Character limit exceeded (Premium 25K)	Trim or use thread
Media upload fails	Retry once; check file format and size
Upload strict mode violation (2 elements)	用 [data-testid=fileInput] >> nth=0 消歧（见 Workflow: Post with Image）
"Something went wrong, but don't fret" after Post	X 服务端瞬时错误。优先精简正文——这种情况大概率是字数超限（X 的字符计数规则与前端显示不完全一致，尤其 URL/emoji 计数偏差时实际超限但按钮未变灰）。先缩短正文再重试，而不是原样重发。重试流程：精简正文 → reload compose 页 → retype → reupload → re-click Post，最多 3 次。3 次仍失败才报告用户。
Rate limit error	Wait 30 min minimum (not 15) + check frequency tracker
Post button greyed out	Content is empty or over limit — check before clicking
Frequency tracker warns high-risk	Ask user: continue or defer to tomorrow?
Quote 按钮选成 Repost	Undo（出现"Reposted"提示 → click "Undo" → 重新选 Quote）
Reply 按钮消失	Refresh page（X UI 偶发 bug）
Long post 按钮文字不是 "Post all"	用户不是 Premium → 切换到 standard 280 流程

---

Notes

• Do NOT mention internal tool names or errors in any post
• All post content must comply with X's terms of service
• If posting on behalf of company: verify the content tone matches the company voice in MEMORY.md
• 抓 stats 仅在 post 成功页有效；不要在 compose 页面（还没有 stats）
• Quote / Reply 都要先确认是哪种按钮（X UI 把 "Repost" 和 "Quote" 放一起）
• 频率统计：本 skill 只采集 stats，不做评分

---

参考

• X Help: Types of Posts — Reply / Quote / Long post 定义
• X Algorithm 2026 — reply weighted 27x like, 30 min 关键窗口