postiz

What This Skill Does

The Postiz skill provides a robust, direct API interface for the Postiz social media management platform, enabling users to schedule, manage, and automate cross-platform content publishing directly through OpenClaw. Unlike indirect integrations that rely on middleware like n8n, this skill communicates natively with your Postiz instance, ensuring lower latency and higher reliability. It supports over 28 distinct social channels, including major networks like X (Twitter), LinkedIn, and Bluesky. The skill is designed for programmatic scheduling, handling everything from individual post creation and media uploads to complex, multi-threaded content sequences. It maintains state management for posts (QUEUE, PUBLISHED, DRAFT) and provides features for deduplication and finding optimal posting slots, making it an essential tool for social media managers and developers looking to automate their digital presence.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface:

1. Execute the installation command: clawhub install openclaw/skills/skills/coolmanns/postiz-extended
2. Configure your environment variables to authenticate with your instance:
   • Set POSTIZ_URL, POSTIZ_EMAIL, and POSTIZ_PASSWORD for base connectivity.
   • Retrieve your POSTIZ_X_ID, POSTIZ_LINKEDIN_ID, and POSTIZ_BLUESKY_ID from your Postiz dashboard under the 'Integrations' section.
3. Verify connectivity by running the authentication script to generate the required cookie session file.

Use Cases

• Automated Cross-Posting: Simultaneously publish adapted versions of content to X, LinkedIn, and Bluesky in a single operation.
• Content Pipeline Management: Integrate your AI content generation workflow to automatically queue new social posts without manual browser interaction.
• Threaded Storytelling: Utilize the skill to structure and schedule multi-tweet threads for X, ensuring consistent and timely delivery.
• Calendar Optimization: Use the integrated scheduling slot finder to identify and fill empty gaps in your social media content calendar automatically.

Example Prompts

1. "Schedule a new LinkedIn post with the text 'Our new AI tool is live!' for tomorrow at 9 AM, and create a 3-tweet thread on X covering the key technical features."
2. "Find the next available posting slot for my Bluesky account and draft a post summarizing our weekly development update there."
3. "Upload the image from https://example.com/promo.png and schedule it for posting to my integrated Facebook and Instagram accounts at the earliest available time."

Tips & Limitations

• Platform Limits: Always adhere to the platform-specific character limits (e.g., 280 for X, 3000 for LinkedIn). The skill expects content to be formatted correctly; ensure your input does not exceed these thresholds to avoid API rejection.
• Session Management: The authentication cookie expires periodically. If the skill returns a 401 Unauthorized error, re-trigger the login script to refresh the session file.
• Deduplication: Always enable the deduplication check when running batch imports to ensure you do not accidentally create duplicate content across multiple instances.
• Media Handling: While the API supports URL-based media, ensure your source files are publicly accessible and optimized for the target platforms to ensure fast, error-free uploads.