social-post

What This Skill Does

The social-post skill is a comprehensive tool for OpenClaw users to manage their presence on X (Twitter) and Farcaster. It acts as an automated interface for content distribution, providing sophisticated handling of character limits, image attachments, and threading logic. By leveraging dynamic API tier detection, the skill intelligently switches between standard posting and long-form posting capabilities for X Premium users. It supports multi-account management, draft previews, and automatic content variation to bypass duplicate filters, ensuring your social activity remains professional and effective. Whether you need to publish a quick update, start a complex discussion thread, or reply to existing conversations, this skill handles the heavy lifting of platform-specific constraints.

Installation

To install this skill, use the ClawHub CLI inside your terminal. Ensure your OpenClaw environment is active and run the following command:

clawhub install openclaw/skills/skills/teeclaw/openclaw-social-post

After installation, you must configure your credentials. Locate your environment file at /home/phan_harry/.openclaw/.env and ensure the X_CONSUMER_KEY, X_CONSUMER_SECRET, X_ACCESS_TOKEN, X_ACCESS_TOKEN_SECRET, X_USERNAME, and X_USER_ID variables are populated with your valid developer API credentials.

Use Cases

This skill is ideal for community managers, content creators, and developers. Use it to automate daily updates across multiple accounts, synchronize content between Twitter and Farcaster to maximize reach, or create sophisticated long-form threads from raw markdown notes. Because it includes automatic link shortening and image support, it is perfectly suited for high-frequency posting workflows that require consistency and platform compliance.

Example Prompts

1. "Post this update to X and Farcaster: [insert text here]. Use the image located at ./assets/launch.png and make sure to shorten any links."
2. "I need to start a thread on X about our new API updates. Here is the draft: [insert long text]. Please split it into a thread and show me a preview before posting."
3. "Reply to the latest tweet from @OpenClaw with 'Great insights on the new agents!' and include the chart image in my downloads folder."

Tips & Limitations

• Tier Detection: The skill caches your Twitter subscription status for 24 hours. If you just upgraded to Premium, use the --refresh-tier flag to ensure the skill detects your new limits immediately.
• Duplicate Content: When posting similar content across accounts, always include the --vary flag to ensure the AI modifies the text slightly to avoid Twitter's spam detection.
• Farcaster Limits: Remember that Farcaster is strictly byte-limited. If you attempt to post near the 288-byte limit, consider enabling auto-truncation to prevent request failure.
• Drafts: Always utilize the draft preview mode before confirming any complex threads to ensure the formatting matches your expectations.