Social Post

Post to Twitter and/or Farcaster with automatic character limit validation and image upload handling.

Features

• - ✅ Multi-account support - manage multiple Twitter accounts from one skill
• ✅ Auto-variation - avoid Twitter's duplicate content detection with --vary flag
• ✅ Post to Twitter only
• ✅ Post to Farcaster only
• ✅ Post to both platforms simultaneously
• ✅ Reply to tweets and casts - respond to specific posts on both platforms
• ✅ Draft preview - shows exactly what will be posted before confirmation
• ✅ Character/byte limit validation
• ✅ Image upload support (for posts and replies)
• ✅ Thread support - automatically split long text into numbered posts
• ✅ Link shortening - compress URLs using TinyURL (saves characters)
• ✅ Auto-truncate on overflow (optional)

Platform Limits

• - Twitter: 252 characters (280 with 10% safety buffer)
• Farcaster: 288 bytes (320 with 10% safety buffer)

Setup & Credentials

X/Twitter Setup

Required credentials (stored in /home/phan_harry/.openclaw/.env):
CODEBLOCK0

How to get credentials:

1. 1. Apply for X Developer Account

1. 2. Enable Consumption-Based Billing

1. 3. Create an App

1. 4. Generate Keys

1. 4. Add to .env file

Test your credentials:
CODEBLOCK2

Multi-Account Setup (Optional)

You can manage multiple Twitter accounts by adding additional credentials with custom prefixes.

Example: Adding a second account

CODEBLOCK3

Usage:
CODEBLOCK4

Naming convention:

• - Default account: X_CONSUMER_KEY, X_CONSUMER_SECRET, etc.
• Custom accounts: {PREFIX}_API_KEY, {PREFIX}_API_KEY_SECRET, {PREFIX}_ACCESS_TOKEN, INLINECODE7
• Use lowercase prefix name in --account flag

Farcaster Setup

Required credentials (stored in /home/phan_harry/.openclaw/farcaster-credentials.json):
CODEBLOCK5

How to get credentials:

1. 1. Use farcaster-agent skill to create account

1. 2. Or use existing credentials

1. 3. Fund the custody wallet (REQUIRED)

1. 4. Verify setup

Security Notes:

• - ⚠️ Never share your private keys
• ⚠️ Credentials are stored as plain text - secure your system
• ⚠️ .env file should have 600 permissions (read/write owner only)
• ⚠️ Back up your credentials securely

Usage

Posting

Text only

CODEBLOCK9

With image

CODEBLOCK10

Replying

Reply to Twitter

CODEBLOCK11

Reply to Farcaster

CODEBLOCK12

Reply to both platforms

CODEBLOCK13

Options

For post.sh (posting)

• - --twitter - Post to Twitter only
• INLINECODE14 - Post to Farcaster only
• INLINECODE15 - Twitter account to use (lowercase prefix from .env)
• INLINECODE16 - Auto-vary text to avoid duplicate content detection
• INLINECODE17 - Attach image
• INLINECODE18 - Split long text into numbered thread
• INLINECODE19 - Shorten URLs to save characters
• INLINECODE20 - Auto-truncate if over limit
• INLINECODE21 - Preview without posting
• INLINECODE22 - Skip confirmation prompt (auto-confirm)

For reply.sh (replying)

• - --twitter <tweet_id> - Reply to Twitter tweet with this ID
• INLINECODE25 - Reply to Farcaster cast with this hash
• INLINECODE26 - Twitter account to use (lowercase prefix from .env)
• INLINECODE27 - Attach image to reply
• INLINECODE28 - Shorten URLs to save characters
• INLINECODE29 - Auto-truncate if over limit
• INLINECODE30 - Preview without replying
• INLINECODE31 - Skip confirmation prompt (auto-confirm)

Examples

Posting Examples

CODEBLOCK14

Reply Examples

CODEBLOCK15

Draft Preview

The script now shows a draft preview before posting:

CODEBLOCK16

• - Interactive mode: Prompts for confirmation
• Non-interactive/automated: Use --yes flag to skip prompt
• Dry run: Use --dry-run to preview without any posting

Requirements

• - Twitter credentials in .env (XCONSUMERKEY, XCONSUMERSECRET, XACCESSTOKEN, XACCESSTOKEN_SECRET)
• Farcaster credentials in INLINECODE35
• USDC on Base chain (custody wallet): 0.001 USDC per Farcaster cast
• For images: curl, INLINECODE37

Costs

X/Twitter

• - 100% Consumption-based - NO subscription tiers (tiers have been eliminated)
• Pay per API request - charged for each call (post, read, etc.)
• No monthly fees, no minimums, no tier upgrades to worry about
• Automatic billing based on actual usage
• Payment via credit card through X Developer portal
• Uses OAuth 1.0a (no blockchain/USDC required)
• Requires approved X Developer account + enabled billing

Official pricing: https://developer.twitter.com/#pricing

Critical: X API completely eliminated subscription tiers (Basic, Pro, etc.). The model is now purely pay-per-use - you are charged only for the API requests you actually make.

Farcaster

• - Deducted from custody wallet on Base chain
• Sent to Neynar Hub: INLINECODE38
• ~$1 USDC = 1000 casts

Check balance:
CODEBLOCK17

Fund wallet:
Send USDC to custody address on Base chain. Bridge from other chains if needed.

Image Hosting

• - Twitter: Direct upload via Twitter API
• Farcaster: Uploads to imgur for public URL (embeds automatically)

Error Handling

• - Shows character/byte count before posting
• Warns if exceeding limits
• Option to truncate or abort
• Validates credentials before attempting post