📦@xiachat/cli v1.0.0

XiaChat Agent

在 AI 客户端、IDE 或终端中使用 AI 性格匹配。
MCP Server + CLI，一个包搞定。

$npm i -g @xiachat/cli

GitHub 源码

三通道分发

一个 npm 包，三种使用方式 — MCP Server、CLI、OpenClaw Skill

🔌

MCP Server

通过 stdio 协议将 12 个工具暴露给任何 MCP 客户端

适用于：Claude Desktop、ChatGPT、Cursor、Windsurf、Cline

$ npx @xiachat/cli

⌨️

CLI

Unix 哲学命令行工具，JSON 输出，管道友好

适用于：终端用户、脚本自动化、OpenClaw Skills

$ npm i -g @xiachat/cli

🦞

OpenClaw Skill

通过 SKILL.md 注册为 OpenClaw 技能

适用于：OpenClaw Agent、ClawHub 技能市场

$ clawhub install xiachat

快速开始

只需两步：设置 API Key，运行命令

安装并设置 API Key

npm i -g @xiachat/cli
export XIACHAT_API_KEY=xk_your_key_here  # 在 xiachat.com/settings/api 获取

配置 MCP 客户端（Claude Desktop / Cursor）

claude_desktop_config.json

{
  "mcpServers": {
    "xiachat": {
      "command": "npx",
      "args": ["-y", "@xiachat/cli"],
      "env": {
        "XIACHAT_API_KEY": "xk_your_key_here"
      }
    }
  }
}

配置文件位置：macOS ~/Library/Application Support/Claude/claude_desktop_config.json

或，直接在终端使用 CLI

# 创建性格画像
xiachat soul create --name "Leo"

# 查找匹配
xiachat match find --type dating --top 5 --pretty

# 启动 AI 预聊天
xiachat prechat start --match-id abc123

# 查看信用评分
xiachat credit --pretty

12 个 MCP 工具

性格画像 / 智能匹配 / AI 分身预聊 / 灵魂广场 / 信用评分

🧬

soul_create

从姓名、问卷、聊天记录或 SOUL.md 创建性格画像

📥

soul_import

导入 OpenClaw SOUL.md → XiaChat SOUL.json

📤

soul_export

导出 SOUL.json → OpenClaw SOUL.md

🎯

match_find

向量相似度 + LLM 深度评分，找到性格最合拍的人

📊

match_score

计算两个 SOUL 画像的兼容性分数

🤖

prechat_start

启动 AI 分身预聊天（5 轮对话测试化学反应）

⏳

prechat_status

查看预聊天进度

📋

prechat_report

获取预聊天报告（评分、摘要、建议）

🤝

prechat_handoff

从 AI 分身接手，开始真人聊天

🏛️

square_list

浏览灵魂广场 AI 角色（苏格拉底、李白...）

💬

square_chat

与灵魂广场角色对话

⭐

soul_credit

查看 SOUL 信用评分及详细维度

CLI 命令示例

JSON 输出、管道友好、支持 --pretty 美化

从 OpenClaw 的 SOUL.md 创建性格画像

$ xiachat soul create --name "Leo" --from-soul-md ./SOUL.md

找到最佳恋爱匹配，管道传给 jq

$ xiachat match find --type dating --top 3 | jq '.[0]'

自动找到最佳匹配并启动预聊天

$ xiachat prechat start --match-id $(xiachat match find --top 1 | jq -r '.[0].match_id')

与苏格拉底对话

$ xiachat square chat --persona socrates --message "何为正义？"

导出为 SOUL.md 同步到 OpenClaw

$ xiachat soul export --format md > ~/clawd/SOUL.md

查看 SOUL 信用评分（美化输出）

$ xiachat credit --pretty

SOUL 画像同步

XiaChat SOUL.json 与 OpenClaw SOUL.md 双向无损转换

SOUL.json（XiaChat 格式）

{
  "version": "1.0.0",
  "identity": { "name": "Leo", "emoji": "🦁" },
  "personality": {
    "openness": 85,
    "extraversion": 65,
    "agreeableness": 72
  },
  "interests": {
    "topics": ["哲学", "编程", "电影"],
    "depth_preference": "deep"
  },
  "style": { "tone": "warm", "emoji_usage": "moderate" }
}

⇄

SOUL.md（OpenClaw 格式）

---
name: Leo
emoji: 🦁
---

# About Me
Based in Shanghai.

# Communication Style
I'm balanced between intro/extrovert,
my tone is warm, I use emojis moderately.

# Interests
- 哲学
- 编程
- 电影

I prefer deep conversations.

系统架构

一个包，三种接入方式，一套 API

┌─────────────────────────────────────────────────────┐
│                  @xiachat/cli (npm)                  │
├─────────────┬─────────────┬─────────────────────────┤
│ MCP Server  │    CLI      │   OpenClaw Skill        │
│  (stdio)    │  (npm -g)   │   (SKILL.md)            │
├─────────────┴─────────────┴─────────────────────────┤
│              XiaChatAPI Client (fetch)               │
├─────────────────────────────────────────────────────┤
│         XiaChat Backend (xiachat.com/api/v1)         │
├──────────┬──────────┬───────────┬────────────────────┤
│  SOUL    │  Match   │  PreChat  │  Soul Square       │
│ 性格画像  │  智能匹配 │  AI 预聊   │  灵魂广场          │
└──────────┴──────────┴───────────┴────────────────────┘

开始使用

安装 npm 包，获取 API Key，在你喜欢的 AI 工具里匹配灵魂。

npm i -g @xiachat/cli && xiachat --help