Social Media Scheduler

Queue Posts Across X and LinkedIn With AI-Generated Captions and Optimal Timing

Building a consistent social media presence requires showing up every day at the right times with content that's actually good. The Social Media Scheduler handles the mechanical parts: generating platform-specific captions from your content, queuing posts at optimal times, routing through approval if you want it, and publishing automatically.

What It Does

This workflow runs at 8 AM daily to build the day's posting queue, and checks every 30 minutes to publish posts at their scheduled times.

1. Content Queue Check (8 AM): Reviews the current queue status — what's pending, what's scheduled for today, what's been posted. Calculates how many posts are needed to hit the day's target for each platform.

2. Content Fetching: If a content source is provided (URL or topic), fetches and reads the content. For URLs, extracts the key ideas. For topics, generates fresh content ideas based on your brand voice guide.

3. Platform-Specific Caption Generation: For each piece of content, Claude generates:

• Twitter/X: captions that match your daily max (default 3/day), written in your configured brand voice — short sentences, specific numbers, no buzzwords, no engagement bait questions. Thread-aware: longer ideas become threads, punchy ideas stay as single tweets.
• LinkedIn: a different treatment of the same content — slightly longer, more professional framing, structured for LinkedIn's algorithm (short first line, value in the body, no hashtag spam)

4. Optimal Time Scheduling: Posts are queued at your configured optimal times (default: X at 9:00, 12:30, 5:00 PM; LinkedIn at 10:30 AM). Times are based on the best-performing windows for each platform, adjustable to your audience's timezone and engagement patterns.

5. Approval Routing (configurable): If require_approval is true, posts are sent to Telegram with approve/reject buttons before being scheduled. If false, they're scheduled automatically. You can set this per-platform.

6. Publishing (every 30 minutes): The workflow checks the queue for posts scheduled in the next 35-minute window and publishes them via the X API or LinkedIn API. Marks them as posted and updates the queue.

7. Performance Tracking: Post engagement is checked 24 hours after publishing. Engagement data is stored and used to refine future timing and content recommendations.

Who This Is For

Founders, marketers, and content creators who want consistent social presence without manually logging into platforms to post. Works best when you have a content pipeline feeding it (blog posts, ideas, repurposed content) rather than generating content from scratch.

What's Included

• social-media-scheduler.yml — complete workflow with 8 AM daily setup cron, 30-minute publishing cron, X and LinkedIn API integration, AI caption generation, approval routing, and engagement tracking
• Configurable optimal posting times per platform
• Daily max posts per platform
• Brand voice guide for caption generation
• Approval routing via Telegram
• Queue persistence in ~/.openclaw/social-queue.json

Setup Steps

1. Install the workflow — copy social-media-scheduler.yml into your OpenClaw workspace
2. Connect X API — add API keys to ~/.openclaw/secrets/x-api.json
3. Connect LinkedIn API — authorize via LinkedIn skill in OpenClaw settings
4. Customize brand voice — edit the brand_voice_guide section with your actual voice guidelines and examples
5. Set optimal times — adjust posting times to your audience's timezone
6. Configure approval — set require_approval: true if you want to review posts before they go live
7. Register both crons — register the 8 AM daily setup and 30-minute publisher: openclaw cron add social-media-scheduler.yml

Brand Voice Configuration

The most important configuration is the brand_voice_guide. Vague instructions produce generic captions. Specific instructions produce content that sounds like you:

Vague (bad): "Be professional and engaging"
Specific (good): "Tone: conversational and direct. No corporate speak. Short sentences. One idea per tweet. Avoid buzzwords, hashtag spam, and engagement bait questions. Do use specific numbers, contrarian takes, and personal observations."

Include 3–5 example posts that represent your voice — the model will match the pattern.

Why This Beats Manual Scheduling

Manual social media posting requires logging in at the right time, writing (or retrieving) the post, formatting it for the platform, and hitting publish — repeated 3–5 times per day across two platforms. That's 15–30 minutes of interrupted work daily.

With this workflow, posting happens automatically. You spend that time creating content (which only you can do) rather than managing distribution (which a system can do).

The consistency compound effect: Showing up every day at optimal times with quality content builds audience faster than sporadic posting of better content. The scheduler makes consistency effortless.**