Wellbot Documentation

Turn any bot avatar into an always-online AI concierge or roleplay NPC. WellBot combines smart chat, visitor greeting, memory, custom persona, Store or Sim knowledge, and fully controllable animations.

Quick Start

  1. Create a bot account - Create a separate Second Life bot account and mark it as a Scripted Agent. See Linden Lab's Scripted Agent Policy.
  2. Wear the HUD - Attach the Wellbot HUD to your avatar
  3. Connect Bot - Tap "Connect Bot" and complete the secure login in your browser with the bot account
  4. Login - Use "Bot" → "Login" to bring your bot online
  5. Edit Persona - Optional: use the web editor to set the bot's name, voice, prompt, and rules

Pairing stores encrypted bot credentials on the server so the bot can auto-login when requested. The HUD stores a control token, not your Second Life password.

Wellbot Concierge

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

Setting Up Concierge

  1. Create a separate Second Life bot account and mark it as a Scripted Agent
  2. Pair your bot using the HUD
  3. Enable Chat/LLM in the HUD menu
  4. Configure your Store Knowledge Base with product information
  5. Set your bot's persona and prompts

Store Knowledge Base

The Store Knowledge Base is where you store product information, store details, and FAQs. Your bot will use this information to answer questions before using AI, ensuring it only uses facts from your actual inventory.

  • Access the Store KB editor via the HUD Dashboard button
  • Add products with names, descriptions, prices, permissions, and SLURLs
  • Create, select, update, and delete Store KBs through the web editor
  • Store KBs are archived under your HUD owner UUID; multiple HUD profiles can select the same Store KB and share edits
  • Store KB responses are fast and accurate (no made-up product details)
  • Bot uses Store KB facts to ground AI responses

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. Create a separate Second Life bot account and mark it as a Scripted Agent
  2. Pair your bot using the HUD
  3. Enable Chat/LLM in the HUD menu
  4. Configure your Sim Knowledge Base with sim rules and characters
  5. Set character name and persona
  6. 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. Combined with the Sim Knowledge Base, NPCs know your sim rules and characters, supporting consistent roleplay experiences.

  • Automatically prevents role-flipping
  • Maintains character consistency
  • Works with Sim KB to keep NPCs grounded in your sim's world
  • Supports anti-mirroring protection

Sim Knowledge Base

The Sim Knowledge Base allows your NPCs to reference sim rules, know about major characters, understand sim lore, and provide accurate responses grounded in your sim's story.

  • Access the Sim KB editor via the HUD Dashboard button
  • Add sim rules, major characters, and lore information
  • Create, select, update, and delete Sim KBs through the web editor
  • Sim KBs are archived under your HUD owner UUID; multiple HUD profiles can select the same Sim KB and share edits
  • NPCs use Sim KB facts to ground responses and stay consistent with your world
  • Sim KB prevents NPCs from making up information about your sim

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
  • AI replies: Powered by Anthropic Claude on the server; the HUD does not offer a model or provider picker

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 owner-requested bot logins; automatic server/deploy recovery relogs are not charged
  • Points are deducted for AI responses (based on token usage)
  • Knowledge base (Store KB or Sim KB) grounding improves accuracy and reduces hallucinations
  • Failed requests don't charge points

Bot Management

Simplified Bot Control

The current Wellbot HUD is designed around one connected bot per HUD:

  • Connect one bot to each HUD
  • Use the Bot menu for login, logout, start location, greeter sync, and extras
  • Use separate HUDs for separate bots or separate KB profiles
  • Each HUD has its own KB selection, but can reuse previously created owner KBs from the web editor

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:

  • Attach the Greeter HUD to the bot avatar; log the bot in from the Control HUD
  • In the same region, use Bot → Greeter → Sync Greeter to push bot_id and control token (or set them in GreeterConfig)
  • Automatic visitor detection within a configurable radius (default 20m, 1–96m)
  • Parcel-only or region-wide scanning; default scan interval 10 seconds
  • Customizable greeting via GreeterConfig (greet_msg, enable_server_im, enable_prompt_owner, etc.)
  • Each visitor is greeted once per session (until greeter region change/teleport)
  • Bot must be online for server IMs; re-sync does not require logout/login

Bot Animations

Bot animations are controlled from the Control HUD but played by the Greeter HUD worn by the bot avatar.

  • Drop user-supplied animation assets into the bot-worn Greeter HUD inventory
  • Make sure the Control HUD includes AnimationHUD.lsl and the Greeter HUD includes GreeterAnimations.lsl
  • Use Bot → Greeter → Sync Greeter in the same region, or configure bot_id= and ct= in GreeterConfig
  • Accept the Second Life animation permission prompt on the bot avatar when the Greeter HUD attaches or resets
  • Open Bot → Extras → Animations to choose an animation, page through the list, or use Stop All

AI Configuration

LLM provider and model

Wellbot IM replies use Anthropic Claude (cloud). The default model is set on the server (typically claude-sonnet-4-20250514 unless the operator sets ANTHROPIC_MODEL). End users cannot switch provider or model from the HUD.

Cloud responses are powered by Anthropic Claude (not ChatGPT). Message content, relevant conversation history, summaries, memories, and KB context may be sent to Anthropic to generate replies.

Prompt Management

  • Base Prompt: Your bot's core personality and rules, edited through Extras → Edit Persona
  • Prompt updates: Use the web persona editor when your character or brand voice changes
  • Clear Memory: Reset conversation context
  • Prompts can be updated anytime

Persona Editor

Use Extras → Edit Persona to open the web persona editor and set char_name, persona, prompt, optional store_url, and repeatable rule: lines. New no-mod HUD builds cannot rely on users dropping notecards into the HUD inventory.

  • Field limits: character name up to 100 characters; persona up to 400; store URL up to 500 (http/https); each rule up to 160 characters; up to 16 rules
  • Prompt format: prompt: may span multiple lines until the next supported field
  • Prompt limit: prompt text can be up to 4000 characters
  • Memory reset: saving the persona clears server-side conversation memory so the new settings take effect cleanly

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

Persona editor does not open or save

  • Use Extras → Edit Persona instead of loading inventory notecards
  • Keep prompt text under the editor limit and shorten very long rule: lines
  • Allow pop-ups or open the persona editor URL from chat manually if the browser page does not open

Animations do not appear or play

  • Confirm animation assets are in the bot-worn Greeter HUD inventory, not the Control HUD
  • Confirm GreeterAnimations.lsl is running on the Greeter HUD and AnimationHUD.lsl is running on the Control HUD
  • Re-run Bot → Greeter → Sync Greeter while both HUDs are in the same region
  • Confirm the bot avatar granted animation permission after attaching or resetting the Greeter HUD

Best Practices

  • Keep prompts concise and clear
  • Update your knowledge base (Store KB or Sim KB) regularly
  • Check your point balance before heavy usage
  • 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