xpoz-setup

What This Skill Does

The xpoz-setup skill serves as the foundational gateway for integrating social media intelligence into the OpenClaw ecosystem. It automates the complex configuration of the Xpoz MCP (Model Context Protocol) server, which acts as the bridge between your agent and major social platforms like Twitter, Instagram, TikTok, and Reddit. The skill handles the entire lifecycle of server registration, environment detection, and OAuth authentication, ensuring that your agent is securely authorized to retrieve public social data without manual configuration by the user.

Installation

To integrate this skill into your OpenClaw environment, use the CLI command: clawhub install openclaw/skills/skills/atyachin/xpoz-setup. This command fetches the necessary scripts and dependencies from the source repository. Once installed, the skill acts as a prerequisite dependency; any subsequent Xpoz-related skills will automatically trigger the setup logic if authentication has not yet been verified.

Use Cases

This skill is essential for users performing market research, trend tracking, or sentiment analysis across social platforms. Use it when you need your agent to monitor brand mentions, track hashtag performance, or analyze audience engagement metrics. It is particularly useful for AI agents tasked with generating social media reports or automating data gathering from external social APIs.

Example Prompts

1. "OpenClaw, I need to track sentiment on Twitter for the latest product launch, please set up my Xpoz connection."
2. "Please connect my Xpoz account so you can start monitoring Reddit threads related to AI developments."
3. "I want to analyze TikTok engagement trends; can you run the xpoz-setup to ensure you have the necessary permissions?"

Tips & Limitations

When running this skill on remote or headless servers, ensure you have access to the command line to complete the manual PKCE-based OAuth flow, as browser-based redirects will not function. Always check your internet connectivity before initiating the setup, as the skill requires active communication with the Xpoz MCP endpoints to verify tokens. Note that the skill stores limited authentication metadata locally to prevent redundant logins, adhering to standard security best practices for local agent environments.