A command-line tool for managing SOUL profiles, finding personality matches, and engaging in AI-driven pre-chats.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install xiachat-cli
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 xiachat-cli 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 XiaChat CLI?
XiaChat CLI is a robust terminal interface for the XiaChat platform, designed to bring advanced personality matching and AI interaction to the command line. As a part of the Openclaw Skills ecosystem, it allows users to manage SOUL personality profiles, calculate compatibility scores, and interact with AI personas from the Soul Square.
The tool is specifically built for developers and power users who need to automate profile management or integrate social AI capabilities into their local workflows. It bridges the gap between structured personality data and real-time AI communication, offering a programmatic way to handle social discovery and avatar-led conversations.
XiaChat CLI Use Cases
- Creating and managing SOUL personality profiles from existing chat logs or Markdown files.
- Finding high-compatibility dating, work, or friendship matches through the XiaChat engine.
- Automating AI avatar pre-chats to evaluate compatibility before manual intervention.
- Exporting profile data to maintain compatibility with other Openclaw Skills.
- Interacting with specialized AI personas like philosophers or artists for research and brainstorming.
How XiaChat CLI Works
- The user creates a SOUL profile by importing a SOUL.md file or extracting personality traits from chat history.
- Profiles are stored in JSON format, allowing for high-precision compatibility matching via the XiaChat API.
- The match command identifies compatible profiles based on user-defined types such as dating or professional networking.
- An AI avatar can be triggered to start a 5-round pre-chat with a match, generating a comprehensive report on the interaction.
- Users can then hand off the conversation to take over manually once the AI has established a rapport.
XiaChat CLI Setup
To add this tool to your Openclaw Skills library, install the package via npm:
npm install -g xiachat
Configure your environment by adding your API key obtained from the XiaChat settings page:
export XIACHAT_API_KEY="xk_your_api_key"
Verify your setup by checking your account credits:
xiachat credit
XiaChat CLI Data Schema & Taxonomy
XiaChat CLI manages data using structured formats that are fully compatible with Openclaw Skills requirements.
| Component | Type | Description |
|---|---|---|
| SOUL.json | File | The primary data structure containing personality traits and AI instructions. |
| SOUL.md | File | A Markdown-formatted version for human readability and OpenClaw syncing. |
| Match ID | String | A unique identifier used to link two profiles for scoring or pre-chatting. |
| Pre-chat Report | JSON | A structured summary of the AI-to-AI or AI-to-Human conversation outcomes. |
XiaChat CLI Advanced Features
- Support for standard input (stdin) and piping, making it ideal for integration with jq and other CLI utilities.
- Bi-directional conversion between SOUL.md and JSON formats to ensure interoperability with various Openclaw Skills.
- Session-based AI chatting in the Soul Square, allowing for persistent context across multiple terminal commands.
- Automated extraction of personality styles from raw WeChat or other messenger export files.
SKILL.md
Loading
Related Openclaw Skills
Pixshop MCP: AI Image & Video Creative Suite
A professional Model Context Protocol skill providing 28+ AI tools for high-end image generation, photo editing, and video production directly within AI coding agents.
Pixshop Creative API
A comprehensive REST API suite for professional AI image generation, video production, and advanced creative editing tools.
Pixshop CLI
A powerful command-line interface for professional AI image generation, video creation, and advanced photo editing tools.
lovtrip-video2article
A powerful AI utility that transforms YouTube video content into structured, SEO-friendly Markdown articles using Gemini 2.5 Pro.
XiaChat MCP
An AI-driven social matching tool that uses personality vectors and AI avatars to facilitate high-compatibility human connections.
Web Chat
A browser automation skill that enables AI agents to query Google Gemini and ChatGPT directly through a controlled Chrome instance.
Featured*
