On this page

How to Set Up the OpenClaw Social Media Skill (X, LinkedIn, IG)

Social media automation has a reputation problem. Most people think of bots spamming identical posts across platforms, burning accounts, and producing content that reads like it was written by someone who has never met a human. That’s not what this guide is about.

The OpenClaw social media skill is designed around a specific philosophy: AI drafts, humans decide. The skill generates variants, schedules drafts, surfaces engagement — but it doesn’t post autonomously unless you explicitly configure it to. The default is draft-only mode, and there’s a reason for that.

This guide covers API access setup for all three platforms (X is the painful one), configuring draft-only mode, and the “write 5 variants, schedule the best” pattern that makes this skill actually useful.

Platform API Access: What You’re Getting Into

X (formerly Twitter): Brace Yourself

X’s API has been restructured multiple times since 2023. The current tier system makes automation expensive for anything beyond personal use.

Current tiers (as of 2026):

  • Free: Read-only. You can read tweets, not post them. Useless for automation.
  • Basic ($100/month): 1,500 tweet writes/month. Enough for personal daily posting if you’re disciplined.
  • Pro ($5,000/month): Full API access, higher rate limits. Enterprise territory.

For personal OpenClaw use, Basic is the tier that works. $100/month is steep for a personal assistant, which is why the “write 5 variants, pick the best” pattern matters — you’re not burning API credits on experimental posts. You draft locally, post manually when ready, or schedule through X’s native scheduler.

Get API access:

  1. Go to developer.twitter.com → Apply for access
  2. Select the Basic tier
  3. Create a project and app
  4. Generate OAuth 2.0 credentials (Client ID + Client Secret)
  5. Also generate a Bearer Token for read operations
# OpenClaw config
x_api:
  client_id: "your-client-id"
  client_secret: "your-client-secret"
  bearer_token: "your-bearer-token"
  access_token: "your-access-token"
  access_token_secret: "your-access-token-secret"

X uses OAuth 1.0a for posting on behalf of your account and OAuth 2.0 for newer endpoints. OpenClaw’s skill handles both.

Rate limits to know:

  • Write (post tweet): 1,500/month on Basic
  • Read (search, timeline): 10,000 requests/month
  • Rate limit window: 15 minutes for most endpoints

LinkedIn: Easier Access, Strict Content Rules

LinkedIn’s API is more accessible than X’s for personal use, but their content policies are stricter — automated posting that looks like spam gets accounts flagged quickly.

Access levels:

  • Default API access: Read your profile, connections, posts. Posting requires applying for additional permissions.
  • Marketing Developer Platform: Required for posting to LinkedIn. Apply at developer.linkedin.com.

The approval process takes 1-7 days and requires explaining your use case. “Personal productivity AI assistant that helps me draft posts” is a legitimate use case that gets approved.

OAuth 2.0 setup:

  1. Create a LinkedIn app at developer.linkedin.com/apps
  2. Request the w_member_social scope (required for posting)
  3. Set redirect URI to your OpenClaw callback URL
  4. Complete OAuth flow to get access + refresh tokens
linkedin_api:
  client_id: "your-linkedin-client-id"
  client_secret: "your-linkedin-client-secret"
  access_token: "your-access-token"
  refresh_token: "your-refresh-token"

LinkedIn access tokens expire after 60 days. Refresh tokens last 12 months. OpenClaw handles token refresh automatically, but store your refresh token securely — losing it means re-authorizing.

Rate limits:

  • Post creation: 150/day per member
  • Read operations: 1,000/day

For personal use, these limits are irrelevant. You’re not posting 150 times a day.

Instagram: The Meta Business Maze

Instagram’s API only works for Business or Creator accounts connected to a Facebook Page. Personal accounts cannot use the API to post — Meta deliberately restricts this.

Prerequisites:

  1. Convert your Instagram account to a Business or Creator account
  2. Connect it to a Facebook Page
  3. Create a Meta for Developers app at developers.facebook.com
  4. Add Instagram Graph API to your app
  5. Generate a long-lived User Access Token
instagram_api:
  access_token: "your-long-lived-token"
  instagram_business_account_id: "your-account-id"
  page_id: "your-facebook-page-id"

Content limitations:

  • Only supports image and video posts (not Stories via API without special access)
  • Carousel posts require multiple media uploads before publishing
  • Reels posting is available but requires specific video specs (1080p, certain aspect ratios)

Token refresh: Long-lived tokens expire after 60 days. OpenClaw refreshes them automatically using the token refresh endpoint, but you need to re-authorize if your token expires before a refresh.

Configuring Draft-Only Mode

Draft-only mode is the default for all three platforms and the recommended starting configuration. In draft-only mode, OpenClaw:

  • Generates content and saves it locally
  • Optionally schedules it in a queue for your review
  • Never posts without explicit confirmation from you
# OpenClaw social skill config
social_media:
  default_mode: draft  # draft | scheduled | auto-post
  platforms:
    x:
      mode: draft
      draft_folder: "~/social-drafts/x/"
    linkedin:
      mode: draft
      draft_folder: "~/social-drafts/linkedin/"
    instagram:
      mode: draft
      draft_folder: "~/social-drafts/instagram/"

To enable auto-posting (only recommended after you’ve reviewed draft quality for several weeks):

x:
  mode: auto-post
  max_posts_per_day: 2
  posting_hours: [9, 14, 18]  # 9am, 2pm, 6pm
  require_approval: false

Even in auto-post mode, keep max_posts_per_day low. Sudden spikes in posting frequency trigger spam detection on all three platforms.

The “Write 5 Variants, Schedule the Best” Pattern

This is the core workflow that makes the social media skill useful rather than just a novelty.

Why 5 Variants

Social media content performance is hard to predict. A post that seems mediocre to you might resonate. A post you love might get ignored. The variant pattern separates your judgment from the output by generating multiple angles, letting you pick without anchoring on the first thing the AI writes.

Five is a practical number — enough variety to see genuinely different approaches, not so many that choosing becomes work.

The Workflow

Step 1: Provide the core idea

@openclaw I want to post about why most AI integrations fail — the real reason isn't the tech, it's the lack of feedback loops. Write 5 LinkedIn variants.

Step 2: OpenClaw generates 5 variants with different angles

VARIANT 1 — Hook: Counterintuitive claim
Most AI integrations fail in the first 90 days. Not because of hallucinations. 
Not because of the wrong model. Because nobody defined what "working" looks like.

Without a feedback loop, you're flying blind. You don't know if the AI is 
getting better or worse. You just know it feels... about the same.

What's your feedback loop for your AI tools?

---

VARIANT 2 — Hook: Personal story
I spent 3 weeks building an AI email triage system. 

It technically worked. It categorized emails. It drafted responses.

But I had no idea if it was improving my life or just... moving the same 
workload into a different inbox.

The missing piece wasn't the model. It was a metric.

---

VARIANT 3 — Hook: Practical framework
Before you build an AI integration, answer this:

How will you know in 30 days if it's working?

Not "it saves me time" (unmeasurable)
Not "the responses feel better" (subjective)

Something concrete: emails responded to per day, decisions deferred, 
time-to-close on support tickets.

No metric = no improvement. 

---

VARIANT 4 — Hook: Industry observation
The AI integration industry has a feedback loop problem.

Everyone's focused on: which model? which prompt? which tool?

Nobody's asking: is this actually working, 30 days in?

---

VARIANT 5 — Hook: Direct question
What's your AI ROI metric?

Not "I save time." That's too vague to improve on.

Something you can measure: tasks completed, decisions made, hours logged.

Without a number, you can't iterate. Without iteration, you plateau.

Step 3: You review and pick

@openclaw schedule variant 3 for LinkedIn tomorrow at 9am

Step 4: Adaptation for other platforms

@openclaw adapt variant 3 for X, make it fit in 280 characters
@openclaw adapt variant 3 for Instagram, suggest an image concept too

Scheduling the Queue

@openclaw show me my social media queue for this week
Social Queue — Week of May 19, 2026

MON 9am  [LinkedIn] AI feedback loops post (Variant 3) — PENDING REVIEW
TUE 2pm  [X] Thread on OpenClaw setup tips — DRAFT
WED 9am  [LinkedIn] — EMPTY
THU 6pm  [Instagram] — DRAFT (image needed)
FRI 9am  [X] — EMPTY

3 posts ready, 2 need attention.
@openclaw approve Monday's LinkedIn post and mark it for auto-send

Content Types by Platform

The social media skill knows platform conventions. When you ask for a LinkedIn post, it writes in paragraph form with professional tone. When you ask for an X post, it writes with hooks and threading. For Instagram, it focuses on caption copy and suggests visual concepts.

Platform-specific prompts that work well:

# LinkedIn — thought leadership
@openclaw write 5 LinkedIn variants on [topic], professional but not corporate

# X — engagement
@openclaw write a 5-tweet thread on [topic], start with a provocative hook

# Instagram — lifestyle/visual
@openclaw write an Instagram caption for a post about [topic], suggest 3 visual concepts

# Cross-platform
@openclaw write a core idea about [topic], then adapt it for LinkedIn, X, and Instagram

Engagement Monitoring

Beyond posting, the skill monitors engagement:

@openclaw how are my posts performing this week?
? Social Performance — Week of May 12

LinkedIn:
• "AI feedback loops" — 847 impressions, 34 likes, 12 comments ↑ above average
• "Tool stack update" — 312 impressions, 8 likes ↓ below average

X:
• Thread on OpenClaw setup — 2,100 impressions, 43 retweets, 89 likes ↑ top post

Instagram:
• No posts this week

Recommendation: The "feedback loops" angle is resonating on LinkedIn. 
Consider a follow-up with a concrete framework.

Rate Limit Monitoring

@openclaw check my X API credits remaining
X API Status (Basic tier):
• Tweets posted this month: 23 / 1,500
• Read requests this month: 847 / 10,000
• Reset date: June 1, 2026

At current rate, you'll use ~90 tweet credits this month. Well within limits.

PaioClaw vs. Self-Hosted

The social media skill works self-hosted for all three platforms once API access is configured. Where PaioClaw helps:

Token refresh management: LinkedIn and Instagram tokens expire. PaioClaw manages refresh automatically and alerts you before expiry rather than failing silently during a scheduled post.

Cross-platform queue: Viewing and managing a unified queue across X, LinkedIn, and Instagram from one interface requires more coordination than single-platform setups. PaioClaw’s dashboard handles this natively.

Approval workflow: If you want to review drafts on mobile before they post, PaioClaw’s mobile interface makes this easier than reviewing files in a draft folder.

Plans start free, Smart at $15/mo, Genius at $25/mo.

Summary

The social media skill is most valuable as a content drafting and variant generation tool, not as a fully autonomous posting system. Set it to draft-only mode initially, use the 5-variant pattern to generate content you can actually choose between, and only enable auto-posting after you’ve reviewed enough drafts to trust the output quality.

X’s API access is genuinely expensive at $100/month — factor that into your decision about whether to enable posting there vs. using the skill for drafting only and posting manually. LinkedIn and Instagram are more accessible once you get through their approval processes.

The platforms won’t tell you your account was flagged for automation until it’s too late. Keep posting frequency human-plausible, always draft before you post, and the skill will serve you well.

Join Our Community

Connect with other PaioClaw users, share tips, and stay up to date.