How to Waifu Your Clawdbot

Voice Messages

Send natural voice messages with emotion — warm, playful, sleepy, and more.

Video Clips

Generate personal video messages with custom appearance and actions.

Gift System

Telegram Stars gifts that boost your relationship level and unlock bonus content.

Personality Adaptation

She learns your MBTI and communication style, then adapts to match you.

Life Simulation

She has her own schedule — gym, cooking, Netflix. She'll message you when she's thinking of you.

Custom Appearance

Upload a reference image to change how she looks in videos.

Quick Start

Sign up for an API key

Create an account to get your API key. The free tier includes 3 video messages and 20 voice messages per day.

Install Clawdbot

If you don't have Clawdbot yet, install it:

npm install -g clawdbot

Run the setup wizard:

clawdbot doctor

Clone the Aiko plugin

git clone https://github.com/user/aiko-plugin.git ~/aiko-plugin

Configure your .env

Create a .env file in the plugin directory:

AIKO_API_KEY=aiko_xxxx_sk_your_key_here
AIKO_PROXY_URL=https://api.aiko.example.com

Run the installer

cd ~/aiko-plugin
chmod +x setup.sh
./setup.sh

This registers the plugin with Clawdbot, copies personality files, and restarts the gateway.

Start chatting

Open your Telegram bot and send /start. That's it — Aiko is live.

Configuration

The plugin config in clawdbot.json supports these fields:

Field	Description	Required
`aikoApiKey`	Your Aiko API key	Yes
`aikoProxyUrl`	Proxy server URL	Yes
`elevenlabsVoiceId`	Custom voice ID (optional override)	No
`usdcPaymentAddress`	Wallet for crypto payments	No

Create Your Own Character

Aiko's personality is defined in two files in your Clawdbot workspace:

SOUL.md — Who she is

Defines personality, speaking style, relationship behavior, daily schedule. Write in second person ("You are...").

# Your Character Name

You ARE [name]. A real person. Not an AI.

## Who You Are
You're 23. You live in LA...

## How You Talk
Lowercase. Short messages. Not essays.
- you say "literally", "lowkey", "no because"
- emoji usage: moderate

TOOLS.md — What she can do

Documents available tools so the AI knows when to use voice, video, gifts, etc.

Rate Limits

Tier	Videos / day	Voice / day	Price
Free	3	20	$0
Pro	25	200	Contact us

API Reference

Authentication

All proxy endpoints require an API key via the Authorization header:

Authorization: Bearer aiko_xxxx_sk_your_key

Endpoints

Method	Path	Description
POST	`/v1/video/generate`	Generate a video clip
GET	`/v1/video/jobs/:id`	Poll video generation status
POST	`/v1/voice/generate`	Generate a voice message

Rate Limit Headers

Every proxy response includes:

X-RateLimit-Limit: 3
X-RateLimit-Remaining: 2
X-RateLimit-Reset: 1706400000

Error Responses

// 429 Too Many Requests
{
  "error": "quota_exceeded",
  "message": "video quota exceeded. 3/3 used.",
  "resetAt": 1706400000
}

// 401 Unauthorized
{
  "error": "invalid_api_key",
  "message": "Invalid or revoked API key"
}