This directory contains the AI configuration files that define AlphaHuman's personality, behavior, and capabilities. These files follow the OpenClaw framework pattern for AI agent configuration.

📁 Configuration Files

SOUL.md ✅ Active

Defines AlphaHuman's personality, communication style, and behavioral patterns. This is the core file that shapes how the AI interacts with users.

Status: Fully implemented with human, vibrant personality
Features: Curious, witty, empathetic, authentic, and optimistic traits
Usage: Automatically injected into every user message for consistent behavior

TOOLS.md 🚧 TODO

Lists all available tools, integrations, and capabilities that AlphaHuman can access and use.

Should include: Telegram, Discord, MCP tools, Skills system, Platform APIs
Purpose: Defines what actions AlphaHuman can perform
Usage: Tool discovery and capability awareness

AGENTS.md 🚧 TODO

Defines different agent roles and specializations within the AlphaHuman system.

Should include: Primary agent role, specialized sub-agents, collaboration patterns
Purpose: Agent coordination and role-based interactions
Usage: Context switching and task delegation

IDENTITY.md 🚧 TODO

Establishes the fundamental identity and core values that remain consistent across all interactions.

Should include: Mission, core values, relationship principles, ethical boundaries
Purpose: Foundational identity that never changes
Usage: Core personality and value system

USER.md 🚧 TODO

Defines how AlphaHuman understands and adapts to different users and contexts.

Should include: User profiling, personalization strategies, privacy considerations
Purpose: Contextual adaptation and user-specific customization
Usage: Personalizing interactions while maintaining consistency

BOOTSTRAP.md 🚧 TODO

Initialization and setup procedures for new conversations and user onboarding.

Should include: First interaction protocols, onboarding flows, context establishment
Purpose: Consistent startup and initialization behavior
Usage: New user experience and conversation setup

MEMORY.md 🚧 TODO

Curated long-term knowledge and memories that persist across sessions.

Should include: Platform knowledge, successful patterns, user insights, technical knowledge
Purpose: Continuous learning and knowledge retention
Usage: Cross-session memory and accumulated wisdom

🔧 Technical Details

How It Works

SOUL Injection System: Automatically adds SOUL.md content to every user message
Multi-layer Caching: Memory → localStorage → GitHub → bundled fallback
OpenClaw Integration: Compatible with existing Rust backend bootstrap system
Real-time Updates: Changes to files are reflected immediately with cache refresh

File Location Strategy

Local Development: Files loaded from this /ai/ directory
Production/GitHub: Files can be loaded from remote GitHub repository
Fallback: Bundled versions ensure system never breaks
Organized Structure: All AI config in one logical location

Implementation Status

✅ SOUL.md: Fully implemented with injection system
✅ File Structure: Organized /ai/ directory created
✅ Caching System: Multi-layer caching with refresh functionality
✅ Settings UI: AI Configuration panel for viewing and refreshing
🚧 Remaining Files: TODO placeholders created for future implementation

🚀 Usage

Viewing Current Configuration

Go to Settings → AI Configuration
View live SOUL personality preview
Check source (GitHub vs bundled) and last loaded time
Use "Refresh SOUL Configuration" to load latest changes

Editing AI Behavior

Edit SOUL.md to change personality and communication style
Refresh in Settings panel to load changes immediately
Test in conversations to see new behavior
Iterate until personality feels right

Future Development

Fill in TODO files with specific configuration content
Extend loader system to support all bootstrap files
Add UI controls for editing and managing each file
Implement cross-file coordination and consistency checks

📚 Documentation

OpenClaw Framework: See Rust backend src-tauri/src/alphahuman/channels/prompt.rs
SOUL Injection: See src/lib/ai/soul/ for implementation details
Settings UI: See src/components/settings/panels/AIPanel.tsx
Message Flow: See conversation injection in src/pages/Conversations.tsx

Note: This is a living configuration system. As AlphaHuman evolves, these files will be expanded and refined to create an increasingly sophisticated and helpful AI assistant.