A specialized automation skill for publishing validated image and video notes directly to Xiaohongshu from local or web sources.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install post-to-xhs
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 post-to-xhs 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 post-to-xhs?
The post-to-xhs skill is a high-performance automation tool designed to bridge the gap between content creation and social distribution. As part of the wider ecosystem of Openclaw Skills, it provides AI agents with the logic required to format, validate, and publish professional-grade notes to the Xiaohongshu (XHS) platform. It handles the nuances of the platform, such as character limits and media type restrictions, ensuring that every post meets quality standards before going live.
This skill is particularly valuable for developers and marketers who need to automate social media workflows. By utilizing Openclaw Skills to handle the technical overhead of API interactions and local file management, users can focus on generating content while the skill manages the rigorous validation rules required for successful XHS engagement.
post-to-xhs Use Cases
- Automating the upload of AI-generated artwork or photography as image-based notes.
- Streamlining video content distribution by publishing local video files directly to Xiaohongshu.
- Converting long-form research or blog content into bite-sized social notes using Openclaw Skills.
- Scheduling social media posts for optimal audience engagement times using the built-in scheduling feature.
How post-to-xhs Works
- Input Analysis: The skill receives content including a title, body text, and media paths, then identifies if the post is an image-based or video-based note.
- Parameter Validation: It enforces platform constraints, such as truncating titles to 20 characters and ensuring media is not mixed between types.
- Content Extraction: If a URL is provided instead of a local file, it uses web-fetching capabilities to retrieve the necessary assets.
- User Confirmation: To ensure accuracy, the skill presents a full preview of the post (title, content, and tags) for user approval.
- Execution: Once confirmed, it triggers the appropriate publishing method—either publish_content for images or publish_with_video for video files.
- Status Reporting: The skill returns a unique Note ID and status report to confirm a successful operation within the Openclaw Skills framework.
post-to-xhs Setup
To utilize this skill, ensure your environment is authenticated with Xiaohongshu. If you are not logged in, you must first use the companion authentication skill.
# Ensure you are authenticated
xhs-login
# Configure the MCP server to have access to the local directories where your media is stored
Note: Video uploads require absolute file paths to ensure the MCP service can correctly locate and process the large media files.
post-to-xhs Data Schema & Taxonomy
The skill organizes publishing data into a structured format to ensure compatibility with XHS API requirements:
| Attribute | Type | Description |
|---|---|---|
| title | String | The note title; strictly limited to 20 characters. |
| content | String | The main body text; hashtags should be excluded from here. |
| images | Array | A list of strings representing local paths or URLs for image notes. |
| video | String | A single absolute path string for video notes. |
| tags | Array | A collection of topic strings that the skill will format as hashtags. |
| visibility | String | Options include: public, private, or friend_only. |
| schedule_at | String | Optional ISO8601 timestamp for future publishing. |
post-to-xhs Advanced Features
- Intelligent Media Routing: Automatically selects the correct API endpoint based on whether the input is a list of images or a video file.
- Automatic Tag Formatting: Processes raw strings into platform-compliant hashtags without requiring the '#' symbol in the content body.
- Scheduled Content Workflows: Integration with Openclaw Skills allows for fully hands-off scheduling of social media campaigns.
- Originality Flagging: Supports the is_original boolean for image notes to help boost content visibility and authority.
SKILL.md
Loading
Related Openclaw Skills
TikTok Video Uploader
A browser-automation skill that allows users to upload, schedule, and batch-manage TikTok videos programmatically.
TikTok Text Overlay
A versatile tool for adding authentic TikTok-style text overlays, backgrounds, and timed animations to images and videos.
Polymarket Monitor
Automate Polymarket tracking by monitoring prediction odds and receiving real-time alerts when specific probability thresholds are met.
Voice Message
A specialized skill for converting text into native voice bubbles across various chat platforms using edge-tts and ffmpeg.
Xiaohongshu (XHS) Login Manager
A specialized skill for AI agents to handle Xiaohongshu authentication, status monitoring, and secure account switching via QR codes.
Xiaohongshu Automation Assistant
An AI-powered automation suite for managing Xiaohongshu (RED/XHS) content, engagement, and competitive research.