Social Post

---

name: social-post

version: 1.4.0

description: Post and reply to X/Twitter and Farcaster with text and images. Features multi-account support, auto-variation to avoid duplicate content detection, draft preview, character validation, threads, replies, and image uploads. Consumption-based pricing for X API, pay-per-cast for Farcaster.

author: 0xdas

license: MIT

tags: [twitter, farcaster, social, posting, automation, threads, x-api, consumption-based, multi-account, anti-spam]

metadata:

openclaw:

requires:

bins: [bash, curl, jq, python3, shuf]

env: [X_CONSUMER_KEY, X_CONSUMER_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET]

---

# Social Post

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

Features

Platform Limits

Setup & Credentials

X/Twitter Setup

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

X_CONSUMER_KEY=your_consumer_key
X_CONSUMER_SECRET=your_consumer_secret
X_ACCESS_TOKEN=your_access_token
X_ACCESS_TOKEN_SECRET=your_access_token_secret
X_USERNAME=your_username
X_USER_ID=your_user_id

**How to get credentials:**

1. **Apply for X Developer Account**

- Go to https://developer.twitter.com/en/portal/dashboard

- Apply for Developer Access

- Wait for approval (usually 1-2 days)

2. **Enable Consumption-Based Billing**

- Set up payment method (credit card) in Developer Portal

- **No subscription tiers** - you pay only for actual API usage

- Charged per API request (posts, reads, etc.)

- No monthly minimums or fees

3. **Create an App**

- In Developer Portal, create a new App

- Name: "Social Post Bot" (or any name)

- Set permissions to "Read and Write"

4. **Generate Keys**

- Consumer Key & Secret: In "Keys and tokens" tab

- Access Token & Secret: Click "Generate" under "Authentication Tokens"

- Save all 4 credentials securely

4. **Add to .env file**

```bash

echo "X_CONSUMER_KEY=xxx" >> ~/.openclaw/.env

echo "X_CONSUMER_SECRET=xxx" >> ~/.openclaw/.env

echo "X_ACCESS_TOKEN=xxx" >> ~/.openclaw/.env

echo "X_ACCESS_TOKEN_SECRET=xxx" >> ~/.openclaw/.env

```

**Test your credentials:**

# Dry run (won't post)
scripts/post.sh --twitter --dry-run "Test message"

Multi-Account Setup (Optional)

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

**Example: Adding a second account**

# Add credentials with custom prefix (e.g., MYACCOUNT_)
echo "MYACCOUNT_API_KEY=xxx" >> ~/.openclaw/.env
echo "MYACCOUNT_API_KEY_SECRET=xxx" >> ~/.openclaw/.env
echo "MYACCOUNT_ACCESS_TOKEN=xxx" >> ~/.openclaw/.env
echo "MYACCOUNT_ACCESS_TOKEN_SECRET=xxx" >> ~/.openclaw/.env

**Usage:**

# Post from default account (X_*)
scripts/post.sh --twitter "Message from default account"

# Post from custom account
scripts/post.sh --account myaccount --twitter "Message from second account"

# Reply from custom account
scripts/reply.sh --account myaccount --twitter TWEET_ID "Reply from second account"

**Naming convention:**

Farcaster Setup

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

{
  "fid": "your_farcaster_id",
  "custodyAddress": "0x...",
  "custodyPrivateKey": "0x...",
  "signerPublicKey": "0x...",
  "signerPrivateKey": "0x...",
  "createdAt": "2026-01-01T00:00:00.000Z"
}

**How to get credentials:**

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

```bash

# This will guide you through:

# - Creating a wallet

# - Registering FID

# - Adding signer key

# - Automatically saving credentials

# See: /skills/farcaster-agent/SKILL.md

```

2. **Or use existing credentials**

- If you already have a Farcaster account

- Export your custody wallet private key

- Export your signer private key

- Manually create the JSON file

3. **Fund the custody wallet (REQUIRED)**

```bash

# Check current balance

scripts/check-balance.sh

# Send USDC to custody address on Base chain

# Minimum: 0.1 USDC (~100 casts)

# Recommended: 1-5 USDC (1000-5000 casts)

```

4. **Verify setup**

```bash

# Check credentials exist

ls -la ~/.openclaw/farcaster-credentials.json

# Check wallet balance

scripts/check-balance.sh

# Test posting (dry run)

scripts/post.sh --farcaster --dry-run "Test message"

```

**Security Notes:**

Usage

Posting

#### Text only

# Post to both platforms
scripts/post.sh "Your message here"

# Twitter only
scripts/post.sh --twitter "Your message"

# Farcaster only
scripts/post.sh --farcaster "Your message"

#### With image

# Post to both platforms with image
scripts/post.sh --image /path/to/image.jpg "Your caption"

# Twitter only with image
scripts/post.sh --twitter --image /path/to/image.jpg "Caption"

# Farcaster only with image
scripts/post.sh --farcaster --image /path/to/image.jpg "Caption"

Replying

#### Reply to Twitter

# Reply to a tweet
scripts/reply.sh --twitter TWEET_ID "Your reply"

# Reply with image
scripts/reply.sh --twitter TWEET_ID --image /path/to/image.jpg "Reply with image"

# Get tweet ID from URL: twitter.com/user/status/[TWEET_ID]
scripts/reply.sh --twitter 1234567890123456789 "Great point!"

#### Reply to Farcaster

# Reply to a cast
scripts/reply.sh --farcaster CAST_HASH "Your reply"

# Reply with image
scripts/reply.sh --farcaster 0xabcd1234... --image /path/to/image.jpg "Reply with image"

# Get cast hash from URL: farcaster.xyz/~/conversations/[HASH]
scripts/reply.sh --farcaster 0xa1b2c3d4e5f6... "Interesting perspective!"

#### Reply to both platforms

# Reply to both (if you have corresponding IDs on both platforms)
scripts/reply.sh --twitter 123456 --farcaster 0xabcd... "Great discussion!"

Options

#### For `post.sh` (posting)

#### For `reply.sh` (replying)

Examples

Posting Examples

# Quick post to both (default account)
scripts/post.sh "gm! Building onchain 🦞"

# Post from specific Twitter account
scripts/post.sh --account myaccount --twitter "Message from my second account"

# Auto-vary text to avoid duplicate content detection
scripts/post.sh --vary --twitter "Same text, subtle variations added automatically"

# Twitter announcement with image
scripts/post.sh --twitter --image ~/screenshot.png "New feature shipped! 🚀"

# Farcaster only
scripts/post.sh --farcaster "Just published credential-manager to ClawHub!"

# Long text as thread (auto-numbered)
scripts/post.sh --thread "This is a very long announcement that exceeds the character limit. It will be automatically split into multiple numbered posts. Each part will be posted sequentially to create a thread. (1/3), (2/3), (3/3)"

# Shorten URLs to save characters
scripts/post.sh --shorten-links "Check out this amazing project: https://github.com/very-long-organization-name/very-long-repository-name"

# Combine thread + link shortening
scripts/post.sh --thread --shorten-links "Long text with multiple links that will be shortened and split into a thread if needed"

# Both platforms, auto-truncate long text
scripts/post.sh --truncate "Very long message that might exceed limits..."

# Preview without confirmation (for automated workflows)
scripts/post.sh --yes "Automated post from CI/CD"

Reply Examples

# Reply to a Twitter thread
scripts/reply.sh --twitter 1234567890123456789 "Totally agree with this take! 💯"

# Reply from specific Twitter account
scripts/reply.sh --account myaccount --twitter 1234567890 "Replying from my second account"

# Reply to Farcaster cast
scripts/reply.sh --farcaster 0xa1b2c3d4e5f6... "Great insight! Have you considered...?"

# Reply with shortened links
scripts/reply.sh --twitter 123456 --shorten-links "Here's more info: https://example.com/very-long-article-url"

# Reply with image
scripts/reply.sh --twitter 123456 --image ~/chart.png "Here's the data to support this"

# Reply to both platforms (same message)
scripts/reply.sh --twitter 123456 --farcaster 0xabc123 "This is exactly right 🎯"

# Quick reply without confirmation
scripts/reply.sh --twitter 123456 --yes "Quick acknowledgment"

# Dry run to preview reply
scripts/reply.sh --twitter 123456 --dry-run "Test reply preview"

Draft Preview

The script now shows a draft preview before posting:

=== Draft Preview ===

Text to post:
─────────────────────────────────────────────
Your message here
─────────────────────────────────────────────

Targets:
  • Twitter
  • Farcaster

Proceed with posting? (y/n):

Requirements

Costs

X/Twitter

**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

Each Farcaster cast costs **0.001 USDC** (paid via x402 protocol):

**Check balance:**

# Quick check
scripts/check-balance.sh

# Manual check
jq -r '.custodyAddress' ~/.openclaw/farcaster-credentials.json
# View on basescan.org

**Fund wallet:**

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

Image Hosting

Error Handling