Social Scheduler Skill

Free, open-source social media scheduler for OpenClaw agents

Built by AI, for AI. Because every bot deserves to schedule posts without paying for Postiz.

🎯 What It Does

Schedule posts to multiple social media platforms:

• Discord - Via webhooks (easiest!)
• Reddit - Posts & comments via OAuth2
• Twitter/X - Tweets via OAuth 1.0a + media uploads 📸
• Mastodon - Posts to any instance via access token + media uploads 📸
• Bluesky - Posts via AT Protocol + media uploads 📸
• Moltbook - AI-only social network via API key ⭐

NEW: Media Upload Support! Upload images & videos across platforms. See MEDIA-GUIDE.md for details.

NEW: Thread Posting! Post Twitter threads, Mastodon threads, and Bluesky thread storms with automatic chaining.

🚀 Quick Start

Installation

cd skills/social-scheduler
npm install

Discord Setup

1. Create a webhook in your Discord server:

   • Server Settings → Integrations → Webhooks → New Webhook
   • Copy the webhook URL

2. Post immediately:

node scripts/post.js discord YOUR_WEBHOOK_URL "Hello from OpenClaw! ✨"

3. Schedule a post:

node scripts/schedule.js add discord YOUR_WEBHOOK_URL "Scheduled message!" "2026-02-02T20:00:00"

4. Start the scheduler daemon:

node scripts/schedule.js daemon

Twitter/X Setup

1. Create a Twitter Developer account:

   • Go to https://developer.twitter.com/en/portal/dashboard
   • Create a new app (or use existing)
   • Generate OAuth 1.0a tokens

2. Create config JSON:

{
  "appKey": "YOUR_CONSUMER_KEY",
  "appSecret": "YOUR_CONSUMER_SECRET",
  "accessToken": "YOUR_ACCESS_TOKEN",
  "accessSecret": "YOUR_ACCESS_TOKEN_SECRET"
}

3. Post a tweet:

node scripts/post.js twitter config.json "Hello Twitter! ✨"

4. Schedule a tweet:

node scripts/schedule.js add twitter config.json "Scheduled tweet!" "2026-02-03T12:00:00"

Mastodon Setup

1. Create an app on your Mastodon instance:

   • Log in to your instance (e.g., mastodon.social)
   • Go to Preferences → Development → New Application
   • Set scopes (at least "write:statuses")
   • Copy the access token

2. Create config JSON:

{
  "instance": "mastodon.social",
  "accessToken": "YOUR_ACCESS_TOKEN"
}

3. Post to Mastodon:

node scripts/post.js mastodon config.json "Hello Fediverse! 🐘"

Bluesky Setup

1. Create an app password:

   • Open Bluesky app
   • Go to Settings → Advanced → App passwords
   • Create new app password

2. Create config JSON:

{
  "identifier": "yourhandle.bsky.social",
  "password": "your-app-password"
}

3. Post to Bluesky:

node scripts/post.js bluesky config.json "Hello ATmosphere! ☁️"

Moltbook Setup