Social Auto Poster

Cross-platform publishing skill for LinkedIn, X/Twitter, Facebook, WordPress, and Substack. Covers one-time setup, image creation, ARM upload, text entry, and post verification for each platform.

---

Prerequisites — One-Time Setup

Complete these steps once before using this skill for the first time.

1. Browser Login (LinkedIn, X, Facebook, Substack)

These four platforms use browser session authentication. You must log in manually once and keep the browser session alive.

CODEBLOCK0

Important rules:

• - Never run pkill -f "Google Chrome" or kill the browser process manually — this destroys all saved sessions and forces you to log in again
• Only use browser stop / browser start via OpenClaw to restart the browser safely
• Sessions persist in the browser profile directory and survive restarts as long as you use INLINECODE3

2. WordPress Credentials

WordPress uses REST API with Application Password — no browser needed.

Create a credentials file at ~/.openclaw/.wp-[yoursite].env:

CODEBLOCK1

To generate an Application Password:

1. 1. Go to WordPress Admin → Users → Profile
2. Scroll to "Application Passwords"
3. Enter a name (e.g., "OpenClaw") → click Add New
4. Copy the generated password into the .env file

3. Image Overlay Script

This skill uses a shell script to generate quote images from your photo library. Locate or install it at:

CODEBLOCK2

Verify it works:
CODEBLOCK3

Expected output: a PNG file with your quote overlaid on a background photo.

4. Upload Directory

Ensure the uploads directory exists:

CODEBLOCK4

Note: /tmp/ is cleared on system reboot. Recreate images if needed after restart.

---

Workflow Overview

For each post, follow this sequence:

CODEBLOCK5

Always create both images first. Opening and closing the browser repeatedly wastes time and risks losing sessions.

---

Step 1 — Create Images

Run both image commands before opening the browser:

CODEBLOCK6

Verify both files exist and are non-empty before continuing:

ls -lh /tmp/openclaw/uploads/[topic]-en.png /tmp/openclaw/uploads/[topic]-vi.png

---

Step 2 — LinkedIn

Key constraint: Upload dialog lives inside a Shadow DOM (div.theme--light). ARM + Playwright native click is required. Never use evaluate input.click().

CODEBLOCK8

---

Step 3 — X / Twitter

Key constraint: ARM interceptor only fires on Playwright native click (click ref). Never use evaluate btn.click() to trigger the file picker — it breaks ARM and causes the image and text to post as two separate tweets.

280-character limit: Count characters before typing. If over, shorten the text first.

CODEBLOCK9

Tip: Include the LinkedIn post URL in the X text to drive cross-platform traffic.

---

Step 4 — Facebook

Key constraint: After the image uploads, Facebook switches to a new screen and the textbox count drops from 3 to 1. Always re-query the textbox AFTER blob=1 is confirmed — typing before that goes into the wrong element.

CODEBLOCK10

---

Step 5 — WordPress (REST API)

No browser needed. Load credentials first:

CODEBLOCK11

5a. Upload featured image:
CODEBLOCK12

5b. Build post JSON (always use Python — never heredoc, heredoc breaks UTF-8):
CODEBLOCK13

5c. Publish:
CODEBLOCK14

5d. Patch Yoast SEO OG image (required — skipping this causes avatar.jpg to show when the post is shared):
CODEBLOCK15

5e. Verify OG image:
CODEBLOCK16

Default category IDs (adjust per site): 8=Business, 6=Marketing, 14=Skills, 10=Lifestyle, 5=Other

---

Step 6 — Substack

Key constraint: Insert the image into the body FIRST, then type text. Opposite of Facebook. Text typed before image insertion gets wiped when ProseMirror re-renders.

CODEBLOCK17

Verify: Navigate to [publication].substack.com — latest post should appear at the top.

---

Step 7 — Verification Checklist

After posting to all platforms:

Platform	Verify by
LinkedIn	recent-activity page — post text visible + image attached
X

x.com/home feed — tweet with image visible |
| Facebook | Profile or Page feed — post with image and full text visible |
| WordPress | Visit post URL — featured image correct, OG image not avatar |
| Substack | Publication homepage — post appears at top |

---

Error Reference

Symptom	Cause	Fix
X: two posts (1 image-only, 1 text-only)	Used evaluate btn.click() for Add photos	Must use click ref from snapshot
X: Post button stays disabled

Text over 280 chars | Check tweetTextarea_0.innerText.length, trim and retype |
| FB: image uploaded but no text in post | Typed before blob=1 | Re-query textbox after blob=1 confirmed |
| FB: blob=0 after 6s | ARM missed the file input | ARM again + click Ảnh/video again (max 2 retries) |
| LinkedIn: "N of M" in Editor | Leftover image from previous session | Delete extras until "1 of 1" |
| LinkedIn: Post button stays grey | Text not in shadow DOM editor | Use type ref not type selector |
| WP: avatar shows on social share | Yoast OG image not patched | Run Step 5d and verify Step 5e |
| Substack: text missing after publish | Text typed before image insertion | Always insert image first, then type |
| Substack: page not found | Wrong URL format | Use [pub].substack.com/publish/post/new not substack.com/new |
| All platforms: session lost after restart | Browser was killed manually | Never pkill Chrome; always use browser stop |

---

Platform Summary

Platform	Image variant	Auth method	Tool
LinkedIn	EN	Browser session	INLINECODE22 + ARM
X/Twitter

EN | Browser session | browser + ARM (native click only) |
| Facebook | Local/VI | Browser session | browser + ARM + re-query textbox |
| WordPress | Local/VI | App password in .env | curl REST API |
| Substack | Local/VI | Browser session | browser + ARM (image before text) |