Wellbot Documentation

Complete guide to using Wellbot Concierge and Wellbot Roleplay

Quick Start

  1. Wear the HUD - Attach the Wellbot HUD to your avatar
  2. Add Bot - Tap "Add Bot" and complete the secure login in your browser
  3. Login - Use "Select Bot" → "Login" to bring your bot online
  4. Enable AI - Optional: Enable Chat/LLM so your bot can reply to IMs

Wellbot Concierge

Designed for store owners who need knowledgeable greeters that can answer product questions and assist customers.

Setting Up Concierge

  1. Pair your bot using the HUD
  2. Enable Chat/LLM in the HUD menu
  3. Configure your knowledge base with product information
  4. Set your bot's persona and prompts

Knowledge Base

The knowledge base is where you store product information, store details, and FAQs. Your bot will use this information to answer questions before using AI.

  • Access the knowledge base editor via the HUD
  • Add products, descriptions, prices, and policies
  • Update your knowledge base anytime
  • Knowledge base responses are fast and accurate

Customizing Your Concierge

  • System Prompt: Define your bot's voice, tone, and boundaries
  • Persona: Set a character name and personality traits
  • Temporary promos: Put short, time-bound instructions directly in your prompt (e.g., "Mention the weekend sale")
  • Memory: Clear conversation memory if the tone drifts

Wellbot Roleplay

Designed for roleplay sims and individual users who want immersive, character-driven NPCs.

Setting Up Roleplay

  1. Pair your bot using the HUD
  2. Enable Chat/LLM in the HUD menu
  3. Set character name and persona
  4. Configure persona anchoring to prevent role-flipping

Persona Anchoring

Persona anchoring ensures your NPC maintains character consistency and doesn't adopt the user's role. This is essential for immersive roleplay experiences.

  • Automatically prevents role-flipping
  • Maintains character consistency
  • Supports anti-mirroring protection
  • Cleans up responses for better formatting

Character Configuration

  • Character Name: The name your NPC uses
  • Persona: Short description of the character's personality and role
  • User Name Hint: Optional hint about the user's character
  • Model Selection: Choose between OpenAI and Ollama models

Points System

Wellbot uses a points-based billing system to manage usage.

Buying Points

  • Visit the Wellspring AI store in-world
  • Pay with Linden Dollars (L$)
  • Points are automatically credited to your account
  • Check your balance in the HUD

Point Usage

  • Points are deducted for bot logins
  • Points are deducted for AI responses (based on token usage)
  • Knowledge base grounding improves accuracy and reduces hallucinations
  • Failed requests don't charge points

Email Alerts

Configure email alerts to be notified when your points balance drops below a threshold:

  1. Open the bot's configuration in the HUD
  2. Set your email address
  3. Set your alert threshold (e.g., 100 points)
  4. You'll receive an email when your balance dips below the threshold

Bot Management

Multi-Bot Control

The Wellbot HUD supports managing multiple bots from a single interface:

  • Add multiple bots to your HUD
  • Switch between bots using "Select Bot"
  • Each bot has independent configuration
  • Use "Logout All" to stop all bots at once

Status Monitoring

  • Check bot status (online/offline) in the HUD
  • View current region and location
  • Monitor uptime and activity
  • Auto-relog on server restart (if desired)

Greeter Functionality

Wellbot includes greeter functionality to automatically welcome visitors:

  • Automatic visitor detection within a configurable radius
  • Parcel-only or region-wide scanning options
  • Customizable greeting messages
  • Owner notifications when new visitors arrive
  • Each visitor is greeted once per session

AI Configuration

Provider Selection

Choose between two AI providers:

  • OpenAI: Cloud-based AI (default: gpt-4o-mini)
  • Ollama: Local AI models (if available on server)

Model Selection

Select the specific AI model to use:

  • OpenAI models: gpt-4o-mini, gpt-4, etc.
  • Ollama models: hermes3-erp, dolphin-mistral, etc.
  • Model can be changed anytime via the HUD

Prompt Management

  • Base Prompt: Your bot's core personality and rules
  • Prompt updates: Use short, session-specific instructions in your prompt when needed
  • Clear Memory: Reset conversation context
  • Prompts can be updated anytime

Troubleshooting

Bot Won't Login

  • Check that you've completed the pairing process
  • Verify you have sufficient points
  • Try logging out and logging back in
  • Re-pair the bot if credentials have changed

Bot Not Responding

  • Ensure Chat/LLM is enabled
  • Check that you have sufficient points
  • Verify the bot is online
  • Check your prompt configuration

Tone Drifting

  • Use "Clear Memory" to reset conversation context
  • Re-apply your base prompt
  • Check that your prompt/persona settings are correct
  • Adjust your system prompt if needed

Best Practices

  • Keep prompts concise and clear
  • Update your knowledge base regularly
  • Set appropriate point thresholds for alerts
  • Test your bot's responses before going live
  • Monitor your points balance regularly
  • Use your prompt for temporary events or promotions
  • Clear memory when changing bot personality

Support

Need help? Reach out through our Community channels:

  • Discord
  • Instagram
  • TikTok
  • X
  • Wellspring AI SL Group
Back to Home