Feature Request: Agent Selector in WebChat UI

📋 Summary

Add ability to create new chat sessions with agent selection in WebChat UI.

🎯 Problem

Current behavior:

• Multiple agents can be configured in openclaw.json
• WebChat UI shows agent list in dropdown (agent → agents)
• BUT: No way to create a new session with a different agent through UI
• Users can only interact with the default agent in WebChat

Example:

{
  "agents": {
    "list": [
      {
        "id": "main",
        "default": true,
        "identity": {
          "name": "Клошка",
          "emoji": "🐾"
        }
      },
      {
        "id": "tech-advisor",
        "identity": {
          "name": "Tech Консультант",
          "emoji": "🔧"
        }
      }
    ]
  }
}

User can see both agents in the list, but cannot start a chat with tech-advisor through WebChat UI.

💡 Proposed Solution

Option 1: "New Chat" button with agent selector

Add a "New Chat" or "+" button in WebChat UI that:

1. Opens a modal/dropdown with available agents
2. Shows agent name + emoji + description (if available)
3. Creates a new session with selected agent
4. Switches to that session

UI mockup:

┌─────────────────────────────────┐
│ 🐾 Клошка (main)          [▼]  │ ← Current agent dropdown
├─────────────────────────────────┤
│                                 │
│ [Sessions]                      │
│ • Current chat (main)           │
│ • divinerdash (subagent)        │
│                                 │
│ [+ New Chat]  ← NEW BUTTON      │
│   ┌─────────────────────────┐   │
│   │ Select Agent:           │   │
│   │ ○ 🐾 Клошка (main)      │   │
│   │ ○ 🔧 Tech Консультант   │   │
│   │ [Create]                │   │
│   └─────────────────────────┘   │
└─────────────────────────────────┘

Option 2: Agent selector in existing session list

Add agent filter/selector when viewing session list:

• Filter sessions by agent
• "Create new session with..." option for each agent

Option 3: Quick action in agent dropdown

Current agent dropdown (top-left) could have:

🐾 Клошка (current)
─────────────────
🔧 Tech Консультант
   → Start new chat

🔧 Technical Details

Backend support:

• ✅ Multiple agents already supported in config
• ✅ sessions_spawn supports agentId parameter
• ❌ WebChat UI doesn't expose this functionality

Required changes:

1. Frontend (WebChat UI):

   • Add "New Chat" button/modal
   • Agent selector component
   • API call to create session with specific agent

2. API endpoint (if needed):

   • Endpoint to create new session with agent selection
   • Or use existing session creation with agentId parameter

📊 Use Cases

Use Case 1: Separate contexts

User wants different agents for different purposes:

• 🐾 Main agent - project work (divinerdash)
• 🔧 Tech advisor - general technical questions
• 📝 Writer - content creation
• 🎨 Designer - UI/UX discussions

Use Case 2: Specialized agents

User configures agents with different:

• System prompts
• Tool access
• Models
• Personalities

Use Case 3: Team collaboration

Multiple team members use different agents:

• DevOps agent - infrastructure questions
• Backend agent - API development
• Frontend agent - UI implementation

✅ Acceptance Criteria

• User can see list of available agents in WebChat UI
• User can create new session with selected agent
• New session appears in session list with agent indicator
• User can switch between sessions with different agents
• Agent identity (name, emoji) is visible in session list
• Works with existing agent configuration in openclaw.json

🎨 Design Considerations

Session list display:

Sessions:
• 🐾 Current chat (Клошка)
• 🔧 Tech questions (Tech Консультант)
• 🐾 divinerdash work (Клошка)

Agent badge in chat header:

┌─────────────────────────────────┐
│ 🔧 Tech Консультант        [×]  │ ← Clear agent indicator
├─────────────────────────────────┤
│ Chat messages...                │

🚀 Priority

Medium-High

Reasoning:

• Core functionality already exists (multiple agents work)
• Only UI layer is missing
• Unlocks powerful use case (context separation)
• Relatively small UI change

🔗 Related

• Current workaround: Use CLI openclaw chat --agent <id>
• Alternative: Use different channels (Telegram, Discord) for different agents
• Related to: Session management, agent configuration

📝 Additional Notes

Current limitations:

• Sub-agents created via sessions_spawn appear in session list but are read-only after completion
• No way to "restart" or "continue" a completed sub-agent session
• Agent allowlist restrictions may prevent spawning certain agents

Future enhancements:

• Agent templates/presets
• Agent-specific settings in UI
• Agent switching within same session (if technically feasible)

Reported by: User (Льоха)
Date: 2026-04-30
OpenClaw version: 2026.4.27
Environment: WebChat UI