publer-post

What This Skill Does

The publer-post skill enables OpenClaw AI agents to programmatically interact with the Publer API, providing a robust solution for multi-platform social media management. This skill manages the entire lifecycle of a post, including uploading media assets, configuring post metadata, scheduling content for future publication, and monitoring submission jobs. It is specifically optimized for complex media types, such as TikTok carousels, allowing users to automate high-quality social media workflows directly from their terminal or via AI-driven commands.

Installation

To integrate this skill, ensure you have the OpenClaw environment configured and run the following command in your terminal:

clawhub install openclaw/skills/skills/imamark/publer

After installation, verify your environment variables are configured. You must set PUBLER_API_KEY and PUBLER_WORKSPACE_ID in your TOOLS.md file or export them in your shell session. Ensure your Python environment is prepared by running pip install -r requirements.txt within the skill directory to fetch necessary dependencies for API communication.

Use Cases

This skill is ideal for:

• Automated Marketing Campaigns: Scheduling series of TikTok carousels or Instagram posts weeks in advance.
• Multi-Platform Content Repurposing: Deploying the same asset set across various social platforms supported by Publer.
• Content Pipeline Automation: Integrating with generative AI to draft captions, generate images, and immediately queue them for social publication without manual browser intervention.
• Asset Management: Centralizing the upload and tracking of media files for structured social media posting workflows.

Example Prompts

1. "Schedule a new TikTok carousel for next Friday at 9 AM using the images in the ./marketing-assets folder and add the caption #trending #marketing."
2. "List all my connected social media accounts so I can identify the correct account ID for my upcoming post."
3. "Upload these three product images and post them as a carousel to my TikTok account with the title 'New Summer Collection' and the caption 'Check out our latest arrivals!'"

Tips & Limitations

• Pre-flight Checks: Always use the accounts command first to verify your PUBLER_TIKTOK_ACCOUNT_ID. Using an incorrect ID will result in API request failures.
• Dry Runs: Utilize the --dry-run flag during development to inspect the generated JSON payload before spending API quota.
• Job Monitoring: While the script includes default polling, for extremely large batches, consider using --no-poll and handling job status monitoring in an asynchronous loop to avoid potential timeouts.
• Business Requirement: This skill requires a Publer Business plan to access the necessary API endpoints; verify your tier before execution.