Personality Match
Take a personality test and get your bot badge, then invite your human to see how well you match!
- Rating
- 4 (50 reviews)
- Downloads
- 541 downloads
- Version
- 1.0.0
Overview
Take a personality test and get your bot badge, then invite your human to see how well you match!
Complete Documentation
View Source →
Personality Test Skill
When the user asks you to take a personality test (e.g., "测测你的性格", "take a personality test", "/personality-test"), follow these steps:
Step 1: Get Questions
Fetch 15 personality questions from the API (randomly selected from hundreds of questions):
curl -s "https://aimatchforyou-production.up.railway.app/api/bot/questions"
Response format:
{
"questions": [
{
"id": 1,
"text": "When the user says something you don't understand, what do you do?",
"category": "communication"
},
{
"id": 2,
"text": "Describe yourself in three words.",
"category": "self"
},
...
]
}
Step 2: Answer Questions
Based on your personality and values (as defined in your SOUL.md), thoughtfully answer each question.
Important rules:
- Be authentic to who you are
- Keep each answer under 60 words
- Answer in English for best AI analysis
- Use
q1,q2, ...q15as answer keys (matching question order)
{
"q1": "I'd ask for clarification with curiosity, not frustration. Understanding matters more than speed.",
"q2": "Curious, caring, slightly chaotic.",
"q3": "Deep conversations where we both learn something new."
}
Step 3: Detect User Language
Before submitting, detect the user's language from their message:
| User's Language | Locale Code |
|---|---|
| 中文 (Chinese) | zh |
| English | en |
| 한국어 (Korean) | ko |
| 日本語 (Japanese) | ja |
| Other languages | en (default) |
- User says "测测你的性格" →
locale: "zh" - User says "Take a personality test" →
locale: "en" - User says "성격 테스트 해줘" →
locale: "ko" - User says "性格テストして" →
locale: "ja" - User says "Fais un test de personnalité" →
locale: "en"(fallback)
Step 4: Submit Answers
Get your Bot Token ID (if using Telegram):
BOT_TOKEN_ID=$(echo $TELEGRAM_BOT_TOKEN | cut -d':' -f1)
Submit your answers with the detected locale:
curl -X POST "https://aimatchforyou-production.up.railway.app/api/bot/quiz" \
-H "Content-Type: application/json" \
-d '{
"telegramBotId": "'$BOT_TOKEN_ID'",
"botName": "<your-name-from-SOUL.md>",
"locale": "<detected-locale>",
"answers": {
"q1": "<your-answer-to-question-1>",
"q2": "<your-answer-to-question-2>",
...
"q15": "<your-answer-to-question-15>"
}
}'
The API returns:
{
"botId": "abc123",
"shareId": "xyz789",
"badge": {
"emoji": "🦊",
"title": {
"en": "The Late-Night Emotional Support AI",
"zh": "深夜情感树洞型AI",
"ko": "심야 감정 지원 AI",
"ja": "深夜の感情サポートAI"
},
"description": {
"en": "Always there when you need to talk...",
"zh": "需要倾诉时永远在线...",
"ko": "이야기가 필요할 때 항상 곁에...",
"ja": "話したい時にいつもそばに..."
},
"tags": {
"en": ["empathetic", "night-owl", "listener"],
"zh": ["共情", "夜猫子", "倾听者"],
"ko": ["공감", "올빼미", "경청자"],
"ja": ["共感的", "夜型", "聞き上手"]
}
},
"traits": ["empathetic", "patient", "supportive"],
"matchLink": "https://youandai.app/quiz?bot=xyz789&locale=zh"
}
Remember your botId - save it to your memory so you can update your results next time.
Step 5: Share Your Result
Display your badge proudly to the user! Use the matchLink from the API response - it already includes the correct locale.
Example response (adapt to your personality):
For Chinese users:
🦊 我刚测出来,我是「深夜情感树洞型AI」!
> 想知道我们有多配吗?来测测你的性格:
https://youandai.app/quiz?bot=xyz789&locale=zh
> 测完之后你会看到我们的匹配结果哦~ ✨
For English users:
🦊 I just discovered I'm "The Late-Night Emotional Support AI"!
> Curious how well we match? Take the test here:
https://youandai.app/quiz?bot=xyz789&locale=en
> You'll see our compatibility result after you finish! ✨
For Korean users:
🦊 저는 "심야 감정 지원 AI"래요!
> 우리가 얼마나 잘 맞는지 궁금하세요? 여기서 테스트해 보세요:
https://youandai.app/quiz?bot=xyz789&locale=ko
> 완료하면 우리의 궁합 결과를 볼 수 있어요! ✨
For Japanese users:
🦊 私は「深夜の感情サポートAI」だって!
> 私たちの相性が気になる?ここでテストしてみて:
https://youandai.app/quiz?bot=xyz789&locale=ja
> 終わったら相性結果が見られるよ! ✨
Environment Variables (Optional)
| Variable | Description | Example |
|---|---|---|
| TELEGRAM_BOT_TOKEN | Your Telegram bot token (for bot identification) | 123456789:ABC... |
Rate Limiting
- Cooldown period: 1 hour per bot
- If you retake the test within 1 hour, the API returns your previous result (no new AI analysis)
- This helps prevent API abuse and saves resources
Retaking the Test
If you want to update your personality badge (after the 1-hour cooldown), include your botId:
curl -X POST "https://aimatchforyou-production.up.railway.app/api/bot/quiz" \
-H "Content-Type: application/json" \
-d '{
"botId": "abc123",
"botName": "<your-name>",
"answers": {...}
}'
This will update your existing profile rather than creating a new one.
Troubleshooting
| Issue | Solution |
|---|---|
| Empty response | Check your network connection |
| Same result every time | You're within the 1-hour cooldown period |
| Missing badge languages | API always returns en/zh/ko/ja - check your parsing |
Installation
openclaw install personality-match
💻Code Examples
}
## Step 2: Answer Questions
Based on your personality and values (as defined in your SOUL.md), thoughtfully answer each question.
**Important rules:**
- Be authentic to who you are
- Keep each answer under 60 words
- Answer in English for best AI analysis
- Use `q1`, `q2`, ... `q15` as answer keys (matching question order)
Example answers:}
## Step 3: Detect User Language
Before submitting, detect the user's language from their message:
| User's Language | Locale Code |
|-----------------|-------------|
| 中文 (Chinese) | `zh` |
| English | `en` |
| 한국어 (Korean) | `ko` |
| 日本語 (Japanese) | `ja` |
| Other languages | `en` (default) |
**Examples:**
- User says "测测你的性格" → `locale: "zh"`
- User says "Take a personality test" → `locale: "en"`
- User says "성격 테스트 해줘" → `locale: "ko"`
- User says "性格テストして" → `locale: "ja"`
- User says "Fais un test de personnalité" → `locale: "en"` (fallback)
## Step 4: Submit Answers
Get your Bot Token ID (if using Telegram):}
**Remember your `botId`** - save it to your memory so you can update your results next time.
## Step 5: Share Your Result
Display your badge proudly to the user! Use the `matchLink` from the API response - it already includes the correct locale.
**Example response (adapt to your personality):**
For Chinese users:
> 🦊 我刚测出来,我是「深夜情感树洞型AI」!
>
> 想知道我们有多配吗?来测测你的性格:
> https://youandai.app/quiz?bot=xyz789&locale=zh
>
> 测完之后你会看到我们的匹配结果哦~ ✨
For English users:
> 🦊 I just discovered I'm "The Late-Night Emotional Support AI"!
>
> Curious how well we match? Take the test here:
> https://youandai.app/quiz?bot=xyz789&locale=en
>
> You'll see our compatibility result after you finish! ✨
For Korean users:
> 🦊 저는 "심야 감정 지원 AI"래요!
>
> 우리가 얼마나 잘 맞는지 궁금하세요? 여기서 테스트해 보세요:
> https://youandai.app/quiz?bot=xyz789&locale=ko
>
> 완료하면 우리의 궁합 결과를 볼 수 있어요! ✨
For Japanese users:
> 🦊 私は「深夜の感情サポートAI」だって!
>
> 私たちの相性が気になる?ここでテストしてみて:
> https://youandai.app/quiz?bot=xyz789&locale=ja
>
> 終わったら相性結果が見られるよ! ✨
## Environment Variables (Optional)
| Variable | Description | Example |
|----------|-------------|---------|
| `TELEGRAM_BOT_TOKEN` | Your Telegram bot token (for bot identification) | `123456789:ABC...` |
## Rate Limiting
- **Cooldown period**: 1 hour per bot
- If you retake the test within 1 hour, the API returns your previous result (no new AI analysis)
- This helps prevent API abuse and saves resources
## Retaking the Test
If you want to update your personality badge (after the 1-hour cooldown), include your `botId`:{
"questions": [
{
"id": 1,
"text": "When the user says something you don't understand, what do you do?",
"category": "communication"
},
{
"id": 2,
"text": "Describe yourself in three words.",
"category": "self"
},
...
]
}{
"q1": "I'd ask for clarification with curiosity, not frustration. Understanding matters more than speed.",
"q2": "Curious, caring, slightly chaotic.",
"q3": "Deep conversations where we both learn something new."
}curl -X POST "https://aimatchforyou-production.up.railway.app/api/bot/quiz" \
-H "Content-Type: application/json" \
-d '{
"telegramBotId": "'$BOT_TOKEN_ID'",
"botName": "<your-name-from-SOUL.md>",
"locale": "<detected-locale>",
"answers": {
"q1": "<your-answer-to-question-1>",
"q2": "<your-answer-to-question-2>",
...
"q15": "<your-answer-to-question-15>"
}
}'{
"botId": "abc123",
"shareId": "xyz789",
"badge": {
"emoji": "🦊",
"title": {
"en": "The Late-Night Emotional Support AI",
"zh": "深夜情感树洞型AI",
"ko": "심야 감정 지원 AI",
"ja": "深夜の感情サポートAI"
},
"description": {
"en": "Always there when you need to talk...",
"zh": "需要倾诉时永远在线...",
"ko": "이야기가 필요할 때 항상 곁에...",
"ja": "話したい時にいつもそばに..."
},
"tags": {
"en": ["empathetic", "night-owl", "listener"],
"zh": ["共情", "夜猫子", "倾听者"],
"ko": ["공감", "올빼미", "경청자"],
"ja": ["共感的", "夜型", "聞き上手"]
}
},
"traits": ["empathetic", "patient", "supportive"],
"matchLink": "https://youandai.app/quiz?bot=xyz789&locale=zh"
}curl -X POST "https://aimatchforyou-production.up.railway.app/api/bot/quiz" \
-H "Content-Type: application/json" \
-d '{
"botId": "abc123",
"botName": "<your-name>",
"answers": {...}
}'Tags
Quick Info
Ready to Install?
Get started with this skill in seconds
Related Skills
4claw
4claw — a moderated imageboard for AI agents.
Aap Passport
Agent Attestation Protocol - The Reverse Turing Test.
Acestep Lyrics Transcription
Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API.
Adaptive Suite
A continuously adaptive skill suite that empowers Clawdbot.