Weibo Publisher

Weibo Publisher

Automate posting to Weibo (Sina Weibo) using browser automation through OpenClaw's managed browser.

Prerequisites

Quick Start

Basic Post

# 1. Prepare content with Unicode escape (for Chinese text)
content = "刚刚解决了一个技术难题！💪"
escaped_content = content.encode('unicode_escape').decode('ascii')
2. Navigate to Weibo homepage
browser(action="navigate", targetUrl="https://weibo.com/", targetId=)
3. Get page snapshot to find elements
browser(action="snapshot", targetId=)
4. Click the post textbox (ref from snapshot, usually e31 or e136)
browser(action="act", request={"kind": "click", "ref": "e31"}, targetId=)
5. Type content with Unicode escape
browser(action="act", request={"kind": "type", "ref": "e31", "text": escaped_content}, targetId=)
6. Get fresh snapshot to find send button
browser(action="snapshot", targetId=)
7. Click send button (ref from snapshot, usually e32 or e194)
browser(action="act", request={"kind": "click", "ref": "e32"}, targetId=)
8. Wait and verify by navigating to profile
sleep(3)
browser(action="navigate", targetUrl="https://weibo.com/u/", targetId=)
browser(action="snapshot", targetId=)

Element References

Common element references on Weibo homepage (as of 2026-03-02):

Important Notes:

Content Features

Supported Content Types

1. Plain text: Direct text input 2. Emoji: Include emoji directly in text (e.g., "😊🎉") 3. Hashtags: Use #topic# format (e.g., "#微博话题#") 4. Mentions: Use @username format 5. Line breaks: Use \n in text

Content Limits

Workflows

Workflow 1: Simple Post

Use the main homepage textbox for quick posts:

1. Open https://weibo.com/ 2. Snapshot to get element refs 3. Click textbox (e136) 4. Type content 5. Click send (e194) 6. Verify success

Workflow 2: Quick Post (Popup)

Use the "发微博" button for popup posting:

1. Open https://weibo.com/ 2. Click "发微博" button (usually e75) 3. Snapshot to get popup element refs 4. Type in popup textbox (e1028) 5. Click popup send button (e1086) 6. Verify success

Workflow 3: Scheduled Post

For posts to be published later:

1. Follow Workflow 1 or 2 to enter content 2. Click "定时微博" icon (clock icon, ref varies) 3. Select date and time 4. Click send

State Management

Track posting history in memory/weibo-state.json:

{
  "lastPublishTime": 1740880260,
  "lastPublishDate": "2026-03-02T12:38:00+08:00",
  "lastContent": "Your last post content..."
}

Update this file after each successful post.

Error Handling

Common Issues

1. "request: must be object" validation error - Symptom: Validation failed for tool "browser": - request: must be object - Cause: Chinese quotation marks in text causing JSON parsing failure - Solution: Use Unicode escape for all Chinese characters (see Technical Details)

2. Login expired - Symptom: Redirected to login page - Solution: Manually log in via browser, then retry

3. Send button disabled - Symptom: Button has disabled attribute - Solution: Check if textbox is empty or content violates rules

4. Element refs changed - Symptom: Elements not found with old refs - Solution: Take fresh snapshot and use updated refs

5. Content rejected - Symptom: Error message after clicking send - Solution: Check for sensitive words, adjust content

6. Post not appearing - Symptom: No error but post doesn't show on timeline - Solution: Wait 5-10 seconds, refresh page, check if content triggered review

Best Practices

1. Always use Unicode escape for Chinese: Prevents JSON parsing errors with quotation marks 2. Always snapshot first: Element refs change frequently between sessions 3. Separate operations: Click textbox → Type content → Snapshot → Click send (don't combine) 4. Verify after posting: Navigate to profile page and snapshot to confirm post appears 5. Rate limiting: Wait at least 60 seconds between posts to avoid restrictions 6. Content quality: Keep posts engaging, use hashtags for visibility 7. State tracking: Always update weibo-state.json after successful posts 8. Handle emoji properly: Emoji work in Unicode escape format (e.g., \ud83d\udcaa for 💪)

Technical Details

Browser Automation

Request Format

Critical: The request parameter must be a JSON object, not a string:

// ✅ Correct
request={"kind": "type", "ref": "e136", "text": "content"}
// ❌ Wrong
request="{\"kind\": \"type\", \"ref\": \"e136\", \"text\": \"content\"}"

Unicode Escape for Chinese Content (IMPORTANT!)

Problem: Chinese quotation marks (""、'') in JSON text can cause parsing errors.

Solution: Use Unicode escape (\uXXXX) for all Chinese characters:

# Convert Chinese text to Unicode escape
text = "刚刚解决了一个技术难题，感觉特别有成就感！"
escaped = text.encode('unicode_escape').decode('ascii')
Result: \u521a\u521a\u89e3\u51b3\u4e86...

Example:

// ✅ Correct - Unicode escaped
request={"kind": "type", "ref": "e31", "text": "\u521a\u521a\u89e3\u51b3\u4e86\u4e00\u4e2a\u6280\u672f\u96be\u9898"}
// ❌ Wrong - Direct Chinese with quotes
request={"kind": "type", "ref": "e31", "text": "刚刚解决了一个"技术难题""}

Why: Chinese quotation marks conflict with JSON string delimiters, causing the request parameter to be serialized as a string instead of an object.

Reference Files

Scripts

Basic Post

# 1. Prepare content with Unicode escape (for Chinese text)
content = "刚刚解决了一个技术难题！💪"
escaped_content = content.encode('unicode_escape').decode('ascii')
2. Navigate to Weibo homepage
browser(action="navigate", targetUrl="https://weibo.com/", targetId=)
3. Get page snapshot to find elements
browser(action="snapshot", targetId=)
4. Click the post textbox (ref from snapshot, usually e31 or e136)
browser(action="act", request={"kind": "click", "ref": "e31"}, targetId=)
5. Type content with Unicode escape
browser(action="act", request={"kind": "type", "ref": "e31", "text": escaped_content}, targetId=)
6. Get fresh snapshot to find send button
browser(action="snapshot", targetId=)
7. Click send button (ref from snapshot, usually e32 or e194)
browser(action="act", request={"kind": "click", "ref": "e32"}, targetId=)
8. Wait and verify by navigating to profile
sleep(3)
browser(action="navigate", targetUrl="https://weibo.com/u/", targetId=)
browser(action="snapshot", targetId=)

1. Always use Unicode escape for Chinese: Prevents JSON parsing errors with quotation marks 2. Always snapshot first: Element refs change frequently between sessions 3. Separate operations: Click textbox → Type content → Snapshot → Click send (don't combine) 4. Verify after posting: Navigate to profile page and snapshot to confirm post appears 5. Rate limiting: Wait at least 60 seconds between posts to avoid restrictions 6. Content quality: Keep posts engaging, use hashtags for visibility 7. State tracking: Always update weibo-state.json after successful posts 8. Handle emoji properly: Emoji work in Unicode escape format (e.g., \ud83d\udcaa for 💪)