twitter-post

name	twitter-post
description	Compose and publish a post (text, image, or video) to Twitter/X using the browser. Supports single and thread posts.
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

Prerequisites: The browser session must be logged in to x.com. Warm up with a homepage visit if session is cold.

---

通用约束

• 文件上传前必须先复制到 /tmp/openclaw/uploads/（browser 工具沙箱限制）
• browser upload 工具可能返回「超时错误」，但这不代表上传失败！上传后用 snapshot 检查页面状态（缩略图是否出现）
• 不要通过检查 input.files.length 是否为 0 判定上传是否失败！ input.files.length == 0 不代表上传失败。
• 遇到 browser failed: timed out. Restart the OpenClaw gateway ... 错误时，不需要重启、不需要报错！等待 30 秒后在原页面继续操作即可。若仍无法操作，再等 30 秒；若还不行，尝试关闭浏览器后重开；只有关闭重开后仍报错才是真的出错，需停止并反馈用户。
• 正文输入使用 type + slowly: true，不要用 fill()

---

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

---

Workflow: Post with Image

1. Navigate to https://x.com/compose/post
2. Wait for the compose box to load
3. Click the media icon (camera/photo button below compose box)
4. Upload the image file using the file picker
5. Wait for image upload to complete (thumbnail appears)
6. Click into the caption area and type the caption
   - Plain text only (no Markdown)
   - Max 280 characters for standard accounts
7. **立即点击 "Post" 按钮——不要等待用户确认！**
8. Wait for confirmation and report the post URL

---

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

---

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

---

Content Limits

Type	Limit
Text	280 characters (standard)
Images	Up to 4 per post
Video	Max 512 MB, max 2m 20s
GIF	Max 15 MB

---

Error Handling

Situation	Action
Login page appears	Session expired — inform user to re-login via browser
Character limit exceeded	Trim content or use thread format
Media upload fails	Retry once; check file format and size
Rate limit error	Wait 15 minutes before retrying
Post button greyed out	Content is empty or over limit — check before clicking

---

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

发布记录（强制）

发布成功后，必须立即调用 published-track 技能记录发布信息：

./skills/published-track/scripts/record.sh \
  --platform twitter \
  --title "标题" \
  --content-type post \
  --source-folder "<原始文件夹路径>" \
  --publish-url "<发布URL>" \
  --publish-date "$(date +%Y-%m-%d)"

--source-folder 为原始内容所在的相对路径（如 output_articles/xxx 或 output_videos/xxx）。 --publish-url 为发布后获得的 URL，若发布失败则留空并在 --notes 中注明原因。

执行 ./skills/published-track/scripts/init-db.sh（幂等，重复执行无副作用）。