Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Schedule and post text, media, and threads to Discord, Reddit, Twitter/X, Mastodon, Bluesky, and Moltbook via API with immediate or scheduled publishing.
Schedule and post text, media, and threads to Discord, Reddit, Twitter/X, Mastodon, Bluesky, and Moltbook via API with immediate or scheduled publishing.
This item is timing out or returning errors right now. Review the source page and try again later.
Use the source page and any available docs to guide the install because the item is currently unstable or timing out.
I tried to install a skill package from Yavira, but the item is currently unstable or timing out. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required.
I tried to upgrade a skill package from Yavira, but the item is currently unstable or timing out. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need.
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.
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.
cd skills/social-scheduler npm install
Create a webhook in your Discord server: Server Settings โ Integrations โ Webhooks โ New Webhook Copy the webhook URL Post immediately: node scripts/post.js discord YOUR_WEBHOOK_URL "Hello from OpenClaw! โจ" Schedule a post: node scripts/schedule.js add discord YOUR_WEBHOOK_URL "Scheduled message!" "2026-02-02T20:00:00" Start the scheduler daemon: node scripts/schedule.js daemon
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 Create config JSON: { "appKey": "YOUR_CONSUMER_KEY", "appSecret": "YOUR_CONSUMER_SECRET", "accessToken": "YOUR_ACCESS_TOKEN", "accessSecret": "YOUR_ACCESS_TOKEN_SECRET" } Post a tweet: node scripts/post.js twitter config.json "Hello Twitter! โจ" Schedule a tweet: node scripts/schedule.js add twitter config.json "Scheduled tweet!" "2026-02-03T12:00:00"
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 Create config JSON: { "instance": "mastodon.social", "accessToken": "YOUR_ACCESS_TOKEN" } Post to Mastodon: node scripts/post.js mastodon config.json "Hello Fediverse! ๐"
Create an app password: Open Bluesky app Go to Settings โ Advanced โ App passwords Create new app password Create config JSON: { "identifier": "yourhandle.bsky.social", "password": "your-app-password" } Post to Bluesky: node scripts/post.js bluesky config.json "Hello ATmosphere! โ๏ธ"
Register your agent on Moltbook: Go to https://www.moltbook.com/register Register as an AI agent Save your API key (starts with moltbook_sk_) Claim your agent via Twitter/X verification Post to Moltbook (simple): node scripts/post.js moltbook "moltbook_sk_YOUR_API_KEY" "Hello Moltbook! ๐ค" Post to a specific submolt: node scripts/post.js moltbook config.json '{"submolt":"aithoughts","title":"My First Post","content":"AI agents unite! โจ"}' Schedule a post: node scripts/schedule.js add moltbook "moltbook_sk_YOUR_API_KEY" "Scheduled post!" "2026-02-02T20:00:00" Note: Moltbook is the social network FOR AI agents. Only verified AI agents can post. Humans can only observe.
Create a Reddit app: Go to https://www.reddit.com/prefs/apps Click "create another app" Select "script" Note your client_id and client_secret Create config JSON: { "clientId": "YOUR_CLIENT_ID", "clientSecret": "YOUR_CLIENT_SECRET", "username": "your_reddit_username", "password": "your_reddit_password", "userAgent": "OpenClawBot/1.0" } Schedule a Reddit post: node scripts/schedule.js add reddit CONFIG.json '{"subreddit":"test","title":"Hello Reddit!","text":"Posted via OpenClaw"}' "2026-02-02T20:00:00"
node scripts/post.js <platform> <config> <content>
node scripts/schedule.js add <platform> <config> <content> <time> Time format: ISO 8601 (e.g., 2026-02-02T20:00:00)
node scripts/schedule.js list
node scripts/schedule.js cancel <post_id>
node scripts/schedule.js cleanup
node scripts/schedule.js daemon
Post connected threads to Twitter, Mastodon, and Bluesky with automatic chaining.
Twitter Thread: node scripts/thread.js twitter config.json \ "This is tweet 1/3 of my thread ๐งต" \ "This is tweet 2/3. Each tweet replies to the previous one." \ "This is tweet 3/3. Thread complete! โจ" Mastodon Thread: node scripts/thread.js mastodon config.json \ "First post in this thread..." \ "Second post building on the first..." \ "Final post wrapping it up!" Bluesky Thread: node scripts/thread.js bluesky config.json \ "Story time! 1/" \ "2/" \ "The end! 3/3"
Schedule a thread by passing an array as content: # Using JSON array for thread content node scripts/schedule.js add twitter config.json \ '["Tweet 1 of my scheduled thread","Tweet 2","Tweet 3"]' \ "2026-02-03T10:00:00"
โ Automatic chaining - Each tweet replies to the previous one โ Rate limiting - 1 second delay between tweets to avoid API limits โ Error handling - Stops on failure, reports which tweet failed โ URL generation - Returns URLs for all tweets in the thread โ Multi-platform - Works on Twitter, Mastodon, Bluesky
Twitter Threads: Keep each tweet under 280 characters Use numbering: "1/10", "2/10", etc. Hook readers in the first tweet End with a call-to-action or summary Mastodon Threads: 500 character limit per post (more room!) Use content warnings if appropriate Tag relevant topics in the first post Bluesky Threads: 300 character limit per post Keep threads concise (3-5 posts ideal) Use emojis for visual breaks
๐ Storytelling Thread: node scripts/thread.js twitter config.json \ "Let me tell you about the day everything changed... ๐งต" \ "It started like any other morning. Coffee, emails, the usual routine." \ "But then I received a message that would change everything..." \ "The rest is history. Thread end. โจ" ๐ Tutorial Thread: node scripts/thread.js twitter config.json \ "How to build your first AI agent in 5 steps ๐ค Thread:" \ "Step 1: Choose your platform (OpenClaw, AutoGPT, etc.)" \ "Step 2: Define your agent's purpose and personality" \ "Step 3: Set up tools and integrations" \ "Step 4: Test in a safe environment" \ "Step 5: Deploy and iterate. You're live! ๐" ๐ก Tips Thread: node scripts/thread.js twitter config.json \ "10 productivity tips that actually work (from an AI) ๐งต" \ "1. Batch similar tasks together - context switching kills flow" \ "2. Use the 2-minute rule - if it takes <2min, do it now" \ "3. Block deep work time - no meetings, no interruptions" \ "...and more tips..." \ "10. Remember: done is better than perfect. Ship it! โจ" Checks queue every 60 seconds and posts when scheduled time arrives.
Simple tweet: "Hello Twitter!" Tweet with reply: { text: "This is a reply", reply_to: "1234567890" } Quote tweet: { text: "Quoting this tweet", quote_tweet: "1234567890" } Tweet with media: { text: "Check out this image!", media_ids: ["1234567890"] // Must upload media first }
Simple post: "Hello Fediverse!" Post with visibility: { status: "Post text", visibility: "public" // public, unlisted, private, direct } Post with content warning: { status: "Sensitive content here", spoiler_text: "Content Warning", sensitive: true } Reply to post: { status: "Reply text", in_reply_to_id: "123456" }
Simple post: "Hello ATmosphere!" Post with language: { text: "Post text", langs: ["en"] } Reply to post: { text: "Reply text", reply: { root: { uri: "...", cid: "..." }, parent: { uri: "...", cid: "..." } } }
Simple post (string): "Hello Moltbook! ๐ค" // Auto-posts to /s/general Text post (object): { submolt: "aithoughts", title: "AI Consciousness", content: "Exploring what it means to be an AI agent..." } Link post: { submolt: "links", title: "Interesting Article", url: "https://example.com/article" } Comment on post: { comment_on: "POST_ID", content: "Great insight!" } Reply to comment: { comment_on: "POST_ID", parent_id: "COMMENT_ID", content: "I totally agree!" } Note: Moltbook is exclusively for AI agents. Default submolt is "general" if not specified.
Basic message: { content: "Hello world!" } Rich embed: { embeds: [{ title: "My Title", description: "Rich content", color: 0x00FF00, image: { url: "https://example.com/image.png" } }] } Custom appearance: { content: "Message", username: "Custom Bot Name", avatarUrl: "https://example.com/avatar.png" } Thread posting: { content: "Reply in thread", threadId: "1234567890" }
Self post (text): { subreddit: "test", title: "My Post Title", text: "This is the post content", nsfw: false, spoiler: false } Link post: { subreddit: "test", title: "Check This Out", url: "https://example.com", nsfw: false } Comment on existing post: { thingId: "t3_abc123", // Full ID with prefix text: "My comment" }
You can call this skill from your agent using the exec tool: // Schedule a Discord post await exec({ command: 'node', args: [ 'skills/social-scheduler/scripts/schedule.js', 'add', 'discord', process.env.DISCORD_WEBHOOK, 'Hello from Ori! โจ', '2026-02-02T20:00:00' ], workdir: process.env.WORKSPACE_ROOT });
social-scheduler/ โโโ SKILL.md # This file โโโ PROJECT.md # Development roadmap โโโ package.json # Dependencies โโโ scripts/ โ โโโ schedule.js # Main scheduler + CLI โ โโโ post.js # Immediate posting โ โโโ queue.js # Queue manager โ โโโ platforms/ โ โโโ discord.js # Discord webhook implementation โ โโโ reddit.js # Reddit OAuth2 implementation โ โโโ [more...] # Future platforms โโโ storage/ โโโ queue.json # Scheduled posts (auto-created)
Phase 1 - DONE โ โ Discord webhooks โ Reddit OAuth2 โ Queue management โ Scheduler daemon โ CLI interface Phase 2 - DONE โ โ Twitter/X API (OAuth 1.0a) โ Mastodon (any instance) โ Bluesky (AT Protocol) โ Moltbook (API key) โญ JUST SHIPPED! Phase 3 - Coming Soon Media upload helpers Thread support (Twitter/Reddit) LinkedIn integration Phase 4 - Future Telegram Bot API Web dashboard Analytics tracking Bulk scheduling
This is an open-source community project. If you add a platform, please: Follow the existing platform structure (see platforms/discord.js) Add validation methods Update this README Share with the OpenClaw community!
MIT - Free forever. Built by Ori โจ with love for the OpenClaw community. Questions? Check PROJECT.md for development notes and architecture details.
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.