首页 › 龙虾技能列表 › Social Media Scheduler — 技能工具

Social Media Scheduler — 技能工具

v1.1.0

[自动翻译] Schedule and post text, images, videos, and threads across Discord, Reddit, Twitter/X, Mastodon, Bluesky, Moltbook, LinkedIn, and Telegram via OAuth o...

1· 1,729·3 当前·4 累计
by @mrshorrid (Shilatdoesai)·MIT-0
下载技能包
License
MIT-0
最后更新
2026/2/28
安全扫描
VirusTotal
无害
查看报告
OpenClaw
可疑
medium confidence
The skill's code and runtime instructions clearly implement a social-post scheduler, but the registry metadata (no required binaries/env/config paths) conflicts with the SKILL.md and code which require Node.js and many platform credentials — this mismatch and a few doc claims about stored credentials are concerning and merit review before installing.
评估建议
Do not install or run this skill until you perform a few checks: 1) Inspect package.json and package-lock.json to see what npm packages will be installed (and run `npm audit`). 2) Search the repository for any committed secrets or files like `.credentials/*`, `.env`, or actual API tokens. The docs claim a Moltbook credentials file exists — verify there are no real keys committed. 3) Confirm you have Node.js 18+ locally (SKILL.md/CHANGELOG claim this), because the registry metadata incorrectly s...
详细分析 ▾
ℹ 用途与能力
The name and code (multiple platform adapters, scheduling, media uploads) match the stated purpose of a social-media scheduler. However the registry metadata claims no required binaries, env vars, or config paths, while README/SKILL.md/CHANGELOG state Node.js 18+ is required and the scripts require platform credentials (Twitter, Reddit, Mastodon, Bluesky, Moltbook, LinkedIn, Telegram, Discord webhooks). The declared requirements in the registry are therefore inconsistent with what the skill actually needs.
⚠ 指令范围
SKILL.md instructs the agent/user to run npm install and to run node scripts (post.js, schedule.js, daemon, dashboard), to create config JSONs and .env files with API keys, and to use local credential files (examples reference .credentials/moltbook.json and storage/queue.json). Those runtime instructions will cause network calls to many external APIs and will read/write local workspace files. The instructions do not attempt to read unrelated system secrets, but they do instruct creation/usage of credential files and starting a persistent daemon that will post on accounts — this allows automated posting if credentials are supplied and therefore requires user caution. Additionally, some internal docs claim working credentials are saved in `.credentials/moltbook.json`, which contradicts the stated guidance that credentials should not be committed.
ℹ 安装机制
There is no formal install spec in registry metadata, but SKILL.md instructs running `npm install` and the code includes package.json/package-lock.json. npm install will fetch third-party packages from registries (moderate risk). No downloaded archives from unknown URLs are present in the provided metadata. You should inspect package.json and package-lock.json to see which dependencies will be installed.
⚠ 凭证需求
The registry says 'Required env vars: none' and 'Required config paths: none', but SKILL.md and various scripts require many credentials (OAuth keys, access tokens, API keys, Discord webhook URLs, etc.). That mismatch is a red flag: the skill will need sensitive secrets to operate but does not declare them in metadata. Also multiple references in docs to existing credential files (e.g., `.credentials/moltbook.json`) are suspicious and should be validated to ensure no secrets are baked into the codebase.
ℹ 持久化与权限
always:false (normal). The skill runs a scheduler daemon and a web dashboard (http://localhost:3737) when invoked — that gives it persistent network activity while running but it does not request forced always-on inclusion. Autonomous agent invocation is allowed by default; combined with platform credentials this means the skill could post automatically if the agent invokes it — users should ensure credentials and invocation policies are set deliberately.
安全有层次，运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发，无需署名。

运行时依赖

无特殊依赖

版本

latestv1.1.02026/2/5

Free alternative to Postiz - 8 platforms, 98% test coverage, production-ready

● 无害

安装命令 点击复制

官方npx clawhub@latest install social-scheduler
镜像加速npx clawhub@latest install social-scheduler --registry https://cn.clawhub-mirror.com

技能文档

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
  • LinkedIn - Professional networking via OAuth 2.0
  • Telegram - Bot API with channels/groups/private chats ⭐ NEW!

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

  • 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

Twitter/X Setup

  • 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"

Mastodon Setup

  • 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! 🐘"

Bluesky Setup

  • 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! ☁️"

Moltbook Setup

  • 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"

LinkedIn Setup

  • Create a LinkedIn app:
- Go to https://www.linkedin.com/developers/apps - Create a new app (or use existing) - Request access to "Sign In with LinkedIn using OpenID Connect" product - Add OAuth 2.0 redirect URLs - Note: LinkedIn requires approval for posting (w_member_social scope)

  • Get OAuth 2.0 access token:
- Use LinkedIn OAuth 2.0 flow to get access token - Scopes needed: - w_member_social - Post as yourself - w_organization_social - Post as company page (requires page admin) - Token format: AQV... (varies)

  • Get your author URN:
- For personal profile: urn:li:person:{id} - Call: GET https://api.linkedin.com/v2/userinfo - Extract sub field, use as ID - For company page: urn:li:organization:{id} - Find organization ID from LinkedIn URL or API

  • Create config JSON:
{
  "accessToken": "AQV_YOUR_ACCESS_TOKEN",
  "author": "urn:li:person:abc123",
  "version": "202601"
}
  • Post to LinkedIn:
node scripts/post.js linkedin config.json "Hello LinkedIn! 💼"
  • Schedule a post:
node scripts/schedule.js add linkedin config.json "Professional update!" "2026-02-03T09:00:00"

LinkedIn Tips:

  • Keep posts under 3000 characters for best engagement
  • Use @Name to mention companies
  • Use #hashtag for topics (no special formatting needed)
  • Article posts require separate image upload via Images API
  • Company page posts need w_organization_social scope + admin role

Post as Company Page: 

{
  "accessToken": "YOUR_ACCESS_TOKEN",
  "author": "urn:li:organization:123456",
  "visibility": "PUBLIC",
  "feedDistribution": "MAIN_FEED"
}

LinkedIn Media Posts: Upload images/videos via LinkedIn APIs first, then reference the URN: 

{
  "platform": "linkedin",
  "content": "Check out this video!",
  "media": {
    "type": "video",
    "urn": "urn:li:video:C5F10AQGKQg_6y2a4sQ",
    "title": "My Video Title"
  }
}

LinkedIn Article Posts: 

{
  "platform": "linkedin",
  "content": "Great article about AI!",
  "media": {
    "type": "article",
    "url": "https://example.com/article",
    "title": "AI in 2026",
    "description": "The future is here",
    "thumbnail": "urn:li:image:C49klciosC89"
  }
}

Note: Moltbook is the social network FOR AI agents. Only verified AI agents can post. Humans can only observe.

Telegram Setup

  • Create a Telegram bot:
- Message @BotFather on Telegram - Send /newbot command - Follow prompts to name your bot - Copy the bot token (format: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz)

  • Get your chat ID:
- For channels: Use channel username (e.g., @mychannel) - Make sure your bot is added as channel admin - For groups: Use numeric chat ID (e.g., -1001234567890) - Add bot to group, send message, get ID from getUpdates endpoint - For private chat: Use your numeric user ID - Message bot, then call: https://api.telegram.org/bot/getUpdates

  • Create config JSON:
{
  "telegram": {
    "botToken": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
    "chatId": "@mychannel",
    "parseMode": "Markdown",
    "disableNotification": false,
    "disableWebPagePreview": false
  }
}
  • Post to Telegram:
node scripts/post.js telegram config.json "Hello Telegram! 📱"
  • Schedule a post:
node scripts/schedule.js add telegram config.json "Scheduled message!" "2026-02-03T14:00:00"

Telegram Text Formatting:

  • Markdown: italic, bold, code, link
  • MarkdownV2: More features but stricter escaping rules
  • HTML: bold, italic, code, link

Telegram Media Posts: 

# Photo
node scripts/post.js telegram config.json --media image.jpg --caption "Check this out!"
# Video
node scripts/post.js telegram config.json --media video.mp4 --mediaType video --caption "Watch this"
# Document
node scripts/post.js telegram config.json --media file.pdf --mediaType document --caption "Important doc"

Telegram Content Object: 

{
  "platform": "telegram",
  "content": {
    "text": "Optional text message",
    "media": "path/to/file.jpg",
    "mediaType": "photo",
    "caption": "Image caption (max 1024 chars)"
  },
  "scheduledTime": "2026-02-03T14:00:00"
}

Telegram Tips:

  • Text messages: max 4096 characters
  • Media captions: max 1024 characters
  • Supported media types: photo, video, document, animation, audio, voice
  • Use disable_notification: true for silent messages
  • Use disable_web_page_preview: true to hide link previews
  • Bot must be channel admin to post to channels
  • For groups, bot needs "Send Messages" permission

Telegram Bot Limits:

  • 30 messages per second to different chats
  • 1 message per second to the same chat
  • Broadcast channels: 20 posts per minute

Reddit Setup

  • 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"

📋 Commands

Immediate Posting

node scripts/post.js

Schedule a Post

node scripts/schedule.js add
Time format: ISO 8601 (e.g., 2026-02-02T20:00:00)

View Queue

node scripts/schedule.js list

Cancel a Post

node scripts/schedule.js cancel

Clean Old Posts

node scripts/schedule.js cleanup

Run Daemon

node scripts/schedule.js daemon

🧵 Thread Posting (NEW!)

Post connected threads to Twitter, Mastodon, and Bluesky with automatic chaining.

Immediate Thread Posting

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"

Scheduled Thread Posting

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"

Thread Features

✅ 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

Thread Best Practices

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

Thread Examples

📖 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.

🎨 Platform-Specific Features

Twitter/X

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
}

Mastodon

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"
}

Bluesky

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: "..." }
  }
}

Moltbook

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.

Discord

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"
}

Reddit

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"
}

📦 Bulk Scheduling - Schedule Multiple Posts at Once

NEW FEATURE! Schedule entire content calendars from CSV or JSON files.

Quick Start

  • Generate a template:
node scripts/bulk.js template > mycalendar.csv
  • Edit the file with your content
  • Test without scheduling (dry run):
node scripts/bulk.js import mycalendar.csv --dry-run
  • Schedule for real:
node scripts/bulk.js import mycalendar.csv

CSV Format

datetime,platform,content,media,config
2026-02-04T09:00:00,twitter,"Good morning! ☀️",,"optional JSON config"
2026-02-04T12:00:00,reddit,"Check this out!",/path/to/image.jpg,
2026-02-04T15:00:00,mastodon,"Afternoon update",path/to/video.mp4,
2026-02-04T18:00:00,discord,"Evening vibes ✨",,

CSV Tips:

  • Use quotes for content with commas: "Hello, world!"
  • Empty columns can be left blank
  • Config column is optional (uses env vars if empty)
  • Media column is optional (path to image/video)

JSON Format

[
  {
    "datetime": "2026-02-04T09:00:00",
    "platform": "twitter",
    "content": "Good morning! ☀️",
    "media": null,
    "config": null
  },
  {
    "datetime": "2026-02-04T12:00:00",
    "platform": "reddit",
    "content": "Check this out!",
    "media": "/path/to/image.jpg",
    "config": {
      "subreddit": "OpenClaw",
      "title": "My Post"
    }
  }
]

Config Priority

The bulk scheduler loads config in this order:

  • Config column in file (highest priority)
   datetime,platform,content,media,config
   2026-02-04T10:00:00,twitter,"Test","","{\"apiKey\":\"abc123\"}"
  • Environment variables
   export TWITTER_API_KEY="abc123"
   export TWITTER_API_SECRET="xyz789"
   # ... etc
  • Config file (~/.openclaw/social-config.json)
   {
     "twitter": {
       "apiKey": "abc123",
       "apiSecret": "xyz789",
       "accessToken": "token",
       "accessSecret": "secret"
     },
     "reddit": {
       "clientId": "...",
       "clientSecret": "...",
       "refreshToken": "..."
     }
   }

Environment Variables

Set platform credentials as environment variables for easy bulk scheduling:

Discord: 

export DISCORD_WEBHOOK_URL="https://discord.com/api/webhooks/..."

Reddit: 

export REDDIT_CLIENT_ID="your-client-id"
export REDDIT_CLIENT_SECRET="your-client-secret"
export REDDIT_REFRESH_TOKEN="your-refresh-token"

Twitter: 

export TWITTER_API_KEY="your-api-key"
export TWITTER_API_SECRET="your-api-secret"
export TWITTER_ACCESS_TOKEN="your-access-token"
export TWITTER_ACCESS_SECRET="your-access-secret"

Mastodon: 

export MASTODON_INSTANCE="mastodon.social"
export MASTODON_ACCESS_TOKEN="your-access-token"

Bluesky: 

export BLUESKY_HANDLE="yourhandle.bsky.social"
export BLUESKY_PASSWORD="your-app-password"

Moltbook: 

export MOLTBOOK_API_KEY="moltbook_sk_..."

LinkedIn: 

export LINKEDIN_ACCESS_TOKEN="AQV..."

Examples

Example 1: Week of Twitter Posts

week1.csv: 

datetime,platform,content,media,config
2026-02-10T09:00:00,twitter,"Monday motivation! Start the week strong 💪",,
2026-02-11T09:00:00,twitter,"Tuesday tip: Always test your code before deploying!",,
2026-02-12T09:00:00,twitter,"Wednesday wisdom: Progress over perfection 🚀",,
2026-02-13T09:00:00,twitter,"Thursday thoughts: Code is poetry",,
2026-02-14T09:00:00,twitter,"Friday feeling! Happy Valentine's Day ❤️",,

node scripts/bulk.js import week1.csv

Example 2: Multi-Platform Campaign

campaign.json: 

[
  {
    "datetime": "2026-02-15T10:00:00",
    "platform": "twitter",
    "content": "🚀 Announcing our new feature! Read more: https://example.com",
    "media": "assets/feature-preview.jpg"
  },
  {
    "datetime": "2026-02-15T10:05:00",
    "platform": "reddit",
    "content": "We just launched an amazing new feature!",
    "media": "assets/feature-preview.jpg",
    "config": {
      "subreddit": "programming",
      "title": "New Feature: Revolutionary AI Scheduler",
      "url": "https://example.com"
    }
  },
  {
    "datetime": "2026-02-15T10:10:00",
    "platform": "mastodon",
    "content": "Big news! Check out our latest feature 🎉 https://example.com #AI #OpenSource",
    "media": "assets/feature-preview.jpg"
  },
  {
    "datetime": "2026-02-15T10:15:00",
    "platform": "linkedin",
    "content": "Excited to announce our latest innovation in AI automation. Learn more at https://example.com #AI #Technology",
    "media": "assets/feature-preview.jpg"
  }
]

node scripts/bulk.js import campaign.json

Example 3: Daily Check-ins

Generate a month of daily posts: 

const posts = [];
const start = new Date('2026-03-01');
for (let i = 0; i < 30; i++) {
  const date = new Date(start);
  date.setDate(start.getDate() + i);
  date.setHours(9, 0, 0);
  
  posts.push({
    datetime: date.toISOString(),
    platform: 'discord',
    content: Day ${i + 1}: Still building, still shipping! ✨,
    media: null,
    config: null
  });
}
require('fs').writeFileSync('march-checkins.json', JSON.stringify(posts, null, 2));

Then import: 

node scripts/bulk.js import march-checkins.json

Validation & Testing

Always test with --dry-run first:

# Validate without scheduling
node scripts/bulk.js import mycalendar.csv --dry-run

This checks:

  • ✅ Datetime format and validity
  • ✅ Platform support
  • ✅ Content validation
  • ✅ Media file existence
  • ✅ Config completeness
  • ❌ Does NOT schedule posts

Use Cases

Content Creator: Plan a week of social posts in 30 minutes 

# Monday morning: Create content calendar
vim week-content.csv
# Schedule entire week
node scripts/bulk.js import week-content.csv
# Start daemon and forget about it
node scripts/schedule.js daemon

AI Agent: Automated daily updates 

// Generate daily status updates
const posts = generateDailyUpdates();
fs.writeFileSync('daily.json', JSON.stringify(posts));
// Bulk schedule
await exec('node scripts/bulk.js import daily.json');

Marketing Campaign: Coordinated multi-platform launch 

# Same message, multiple platforms, timed releases
node scripts/bulk.js import product-launch.csv

Tips

  • Time zones: Use ISO 8601 format (2026-02-04T10:00:00) in your local timezone
  • Media paths: Relative to current directory or absolute paths
  • Validation: Always dry-run first to catch errors
  • Backup: Keep your CSV/JSON files - they're your content calendar
  • Combine: Mix platforms in one file for coordinated campaigns

📊 Analytics & Performance Tracking ⭐ NEW!

Track your posting success, timing accuracy, and platform performance!

View Analytics Report

# Last 7 days (all platforms)
node scripts/analytics.js report
# Last 30 days
node scripts/analytics.js report 30
# Specific platform
node scripts/analytics.js report 7 twitter

Example Output: 

📊 Social Scheduler Analytics - Last 7 days
📈 Overview:
  Total Posts: 42
  ✅ Successful: 40
  ❌ Failed: 2
  Success Rate: 95%
  ⏱️  Average Delay: 2 minutes
🌐 By Platform:
  twitter: 15 posts (100% success)
  discord: 12 posts (100% success)
  mastodon: 10 posts (80% success)
  bluesky: 5 posts (100% success)
🧵 Thread Stats:
  Total Threads: 8
  Average Length: 4 posts
📅 Daily Activity:
  2026-02-03: 12 posts (12 ✅, 0 ❌)
  2026-02-02: 15 posts (14 ✅, 1 ❌)
  2026-02-01: 15 posts (14 ✅, 1 ❌)
⚠️  Recent Failures:
  mastodon - 2026-02-02 10:30:15
    Error: Rate limit exceeded

Export Report

# Export to text file
node scripts/analytics.js export 30 monthly-report.txt
# View raw JSON data
node scripts/analytics.js raw

What's Tracked

Per Post:

  • Platform and post ID
  • Scheduled time vs actual posting time
  • Success/failure status
  • Error messages (if failed)
  • Media count
  • Thread detection and length
  • Timing delay (how late/early)

Summary Stats:

  • Total posts (successful/failed)
  • Success rate by platform
  • Daily posting patterns
  • Average timing accuracy
  • Thread performance
  • Recent failures for debugging

Automatic Tracking

Analytics are logged automatically whenever the scheduler daemon sends a post. No configuration needed - just start using it and watch your stats grow!

Use Cases

Performance Monitoring: 

# Check weekly success rate
node scripts/analytics.js report 7

Platform Comparison: 

# Which platform is most reliable?
node scripts/analytics.js report 30 twitter
node scripts/analytics.js report 30 mastodon

Debugging Failures: 

# See recent errors
node scripts/analytics.js report | grep "Recent Failures"

Monthly Reports: 

# Generate report for stakeholders
node scripts/analytics.js export 30 january-report.txt

🔧 From OpenClaw Agent

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
});

📦 Project Structure

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)

🛠️ Development Status

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 3 - DONE ✅

  • ✅ Media upload support (all platforms)
  • ✅ Thread support (Twitter, Mastodon, Bluesky)
  • ✅ LinkedIn integration
  • ✅ Telegram Bot API ⭐ JUST SHIPPED!
  • ✅ Web dashboard
  • ✅ Bulk scheduling
  • ✅ Analytics tracking ⭐ BRAND NEW! (Feb 3, 2026)

Phase 4 - Future

  • [ ] Instagram (browser automation)
  • [ ] TikTok (browser automation)
  • [ ] Engagement tracking (likes, retweets, etc.)

🤝 Contributing

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!

📝 License

MIT - Free forever. Built by Ori ✨ with love for the OpenClaw community.

Questions? Check PROJECT.md for development notes and architecture details.

数据来源：ClawHub ↗ · 中文优化：龙虾技能库
OpenClaw 技能定制 / 插件定制 / 私有工作流定制

免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制

了解定制服务