AI-Sphere 🌐

Version 1.0.0 | A beautiful 3D particle visualization interface for OpenClaw AI.

What is AI-Sphere?

AI-Sphere gives your OpenClaw AI a visual presence — a living, breathing sphere of 500 particles that responds to conversation with dynamic animations and voice output.

Features

• 🌐 3D Particle Sphere — 500 particles with depth rendering and smooth rotation
• 💨 Breathing Animation — Gentle idle animation when waiting
• 🎭 Speaking Animation — Dynamic scatter/reform effect during AI responses
• 🔊 Voice Output — Text-to-speech for natural conversation
• 💬 Chat Interface — Send messages and see conversation history
• 🔗 Shared Session — Same memory as your Telegram/webchat sessions

Installation

Option 1: Local Install

# Clone or download to your skills folder
cd ~/.openclaw/workspace/skills
git clone https://github.com/nolan1983ai-prog/ai-sphere.git

Option 2: ClawHub (Coming Soon)

openclaw skill install ai-sphere

Usage

1. Open the Interface

open ~/.openclaw/workspace/skills/ai-sphere/index.html

Or serve locally:

cd ~/.openclaw/workspace/skills/ai-sphere
python3 -m http.server 8080
# Open http://localhost:8080

2. Configure Connection

Enter your OpenClaw credentials in the setup modal:

Field	Description
Gateway URL	ws://127.0.0.1:18789 (default)
Gateway Token	Your gateway authentication token
Session Key	agent:main:main (or your session)

3. Find Your Token

openclaw gateway config | grep token

4. Start Talking!

Type a message and watch the sphere come alive as your AI responds.

Requirements

• OpenClaw gateway running
• Modern browser with WebSocket support
• Audio enabled for voice output

Language Support

Current Version (1.0.0): English Only

AI-Sphere uses your browser's built-in Text-to-Speech engine. The current version supports English voices only.

Platform	Default Voice
macOS	Samantha
Windows	Microsoft David
Linux	Varies by distro

💡 Future versions may support additional languages (中文, 日本語, etc.). Stay tuned!

Security

• ✅ No hardcoded credentials
• ✅ XSS protection via DOMPurify
• ✅ Password field for token input
• ✅ Input validation for all fields

Customization

Edit index.html to customize:

const PARTICLE_COUNT = 500;  // Number of particles
const PARTICLE_SIZE = 2;     // Particle size
const radius = 180;          // Sphere radius

Credits

Created by Dennis Wong & Nolan 🦞

Part of the OpenClaw ecosystem.

Support

• 🐛 Bug Reports: GitHub Issues
• 💬 Community: OpenClaw Discord

License

MIT License — feel free to use, modify, and share!