Velora Chat Skill#

Automated testing and interaction with Velora AI companions (velora.cloudm8.net).

Prerequisites#

Before using this skill, ensure:

1. Node.js installed (v18+)

2. Playwright installed: bash

   npm install playwright
   npx playwright install chromium
   
   

3. Valid Velora account credentials

Credentials Setup#

Required Environment Variables#

Create a .env file or set these variables:

bash

# Velora Account (REQUIRED)
VELORA_EMAIL=your-email@domain.com
VELORA_PASSWORD=your-password

Required Credentials#

Create a .env file or set these environment variables:

bash

VELORA_EMAIL=your-email@domain.com
VELORA_PASSWORD=your-password

⚠️ Note: You must provide your own Velora account credentials. The skill does not include default credentials for security reasons.

Quick Start#

Option 1: Using the Script (CLI)#

bash

# Basic chat
node scripts/velora-chat.js "email@domain.com" "password" "Lilith" "Hey, how are you?"

# With image generation request
node scripts/velora-chat.js "email@domain.com" "password" "Rin" "Send me your best photo!"

Usage:

bash

node scripts/velora-chat.js <email> <password> <companion> <message>

Option 2: Direct in OpenClaw#

The skill provides instructions for browser automation directly in conversations. Simply request:

• "Chat with [Companion Name]"
• "Test [Companion Name]'s image generation"
• "Generate [Companion Name]'s image"

Companion List#

Available companions (28 total):

NameTypeRinTsundereLilithVampire/SuccubusFreyaCozy warmthYukiSnow princessMikoSacred sinAmaraRadiant temptressAoiSporty & flirtyAnd 21 more...

See references/companions.md for full list.

API Reference#

Login Flow#

javascript

const { chromium } = require('playwright');

const browser = await chromium.launch({ headless: true });
const page = await browser.newPage();

await page.goto('https://velora.cloudm8.net/login');
await page.fill('input[type="email"]', process.env.VELORA_EMAIL);
await page.fill('input[type="password"]', process.env.VELORA_PASSWORD);
await page.click('button:has-text("Sign In")');
await page.waitForURL('**/chat**', { timeout: 20000 });

Start Chat#

javascript

// New chat
await page.click('text=Neuer Chat');
await page.click('text=Lilith'); // Companion name
await page.waitForTimeout(5000);

Send Message#

javascript

const input = await page.locator('input[type="text"], textarea').first();
await input.fill('Your message');
await input.press('Enter');
await page.waitForTimeout(15000); // Wait for AI response

Get Generated Images#

javascript

const images = await page.evaluate(() => {
  const imgs = document.querySelectorAll('img');
  return Array.from(imgs).map(img => img.src);
});
// Download: curl -s -o image.jpg "IMAGE_URL"

Troubleshooting#

IssueSolutionLogin failsVerify credentials, check account existsImages not loadingWait 15-20 seconds for generationChat won't startEnsure proper navigation to /chat URLPlaywright not foundRun npm install playwright

Security Notes#

• ⚠️ Never commit credentials to version control
• Use environment variables, not hardcoded values
• Test accounts recommended for automation

Testing Checklist#

• Login flow works
• Companion list loads (28+ companions)
• Chat initiates properly
• Messages send successfully
• AI responses received
• Images generate correctly (512x768 / 1024x1024)
• Wallet/Gallery features (optional)