An advanced social media automation skill for AI agents to post text, images, and threads to X and Farcaster simultaneously.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openclaw-social-post
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install openclaw-social-post using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Social Post?
The Social Post skill provides a robust bridge between AI agents and the world's most popular social platforms. It simplifies the process of interacting with the X (Twitter) and Farcaster APIs by handling character limit validation, image hosting, and complex threading logic automatically. Whether you are building an autonomous community manager or a marketing bot, this addition to your library of Openclaw Skills ensures your agent can communicate effectively across both centralized and decentralized networks.
This skill is built for developers who need more than just simple posting. It includes sophisticated features like dynamic tier detection for X Premium accounts, which allows for single long-form posts or automated threading. By integrating this into your workflow, you gain a unified interface for multi-account management and cross-platform replies, all while maintaining strict control over API consumption and costs.
Social Post Use Cases
- Automating daily project updates across X and Farcaster platforms
- Creating and managing long-form educational threads from AI-generated summaries
- Building interactive bots that reply to specific tweet IDs or Farcaster cast hashes
- Managing multiple social identities for different brands using a single agent configuration
- Programmatic sharing of screenshots or data visualizations using integrated image upload support
How Social Post Works
- The skill initializes by loading credentials from environment variables and JSON configuration files.
- It performs a dynamic tier check for X accounts to determine if the user has Basic or Premium limits, caching the result for 24 hours.
- Content is validated against platform-specific byte and character limits (e.g., 288 bytes for Farcaster).
- If an image is provided, the skill handles native X uploads or Imgur hosting for Farcaster embeds.
- The script generates a draft preview for manual confirmation or proceeds automatically if the --yes flag is used.
- For long text, the skill provides an interactive choice to post as a single long tweet or split it into a numbered thread.
Social Post Setup
To integrate this with your existing Openclaw Skills, configure your X API keys in the environment file and ensure your Farcaster credentials are saved in the correct directory.
# Add X credentials to your environment
echo "X_CONSUMER_KEY=your_key" >> ~/.openclaw/.env
echo "X_ACCESS_TOKEN=your_token" >> ~/.openclaw/.env
# Check your Farcaster wallet balance on Base chain
scripts/check-balance.sh
# Test a dry run post
scripts/post.sh --twitter --dry-run "Hello World"
Social Post Data Schema & Taxonomy
| Component | Format | Description |
|---|---|---|
| .env | Shell Script | Stores X_CONSUMER_KEY, X_ACCESS_TOKEN, and custom account prefixes. |
| farcaster-credentials.json | JSON Object | Contains FID, custody address, and private signer keys. |
| Tier Cache | Local File | Stores the 24-hour timestamped X account tier (Basic/Premium). |
| Image Handling | API Metadata | Stores media IDs for X and public URLs for Farcaster/Imgur. |
Social Post Advanced Features
- Multi-Account Support: Use custom prefixes in your environment to switch between different social handles seamlessly.
- Auto-Variation: Utilize the --vary flag to inject subtle differences in text, helping avoid duplicate content detection by platform algorithms.
- Link Shortening: Automatically compress long URLs using TinyURL to maximize available character space.
- Force Threading: Programmatically split long-form content into numbered sequences even when Premium limits allow for single posts.
- Tier Refresh: Force an immediate update of account capabilities with the --refresh-tier flag after upgrading your API status.
SKILL.md
Loading
Related Openclaw Skills
Credential Manager
A mandatory security framework for centralizing, encrypting, and auditing all API credentials within Openclaw Skills.
BaseCred SDK Skill
A neutral, composable reputation skill that fetches onchain credibility data from Ethos Network, Talent Protocol, and Farcaster.
Proxy Auto
An automated proxy management skill that dynamically routes traffic through a SOCKS5 tunnel for external network access.
Gemini Sub-Agent
A cost-effective sub-agent that uses your Google Gemini subscription for high-context coding and text analysis within Openclaw Skills.
OpenClaw CLI Cheatsheet
A high-performance reference tool providing instant access to every OpenClaw CLI command, flag, and usage example.
iCloud Calendar
A bridge for AI agents to programmatically schedule events on iCloud Calendar with native iPhone notification support.
Featured*
