agent-chat-ux
Multi-agent UX for OpenClaw Control UI — agent selector, per-agent sessions, session history viewer with search, agent-filtered Sessions tab with friendly names, Create Agent wizard, emoji picker, and backend agent CRUD.
Install / Use
npx skills add LeoYeAI/openclaw-master-skills --skill agent-chat-ux-v1-4-0Installs into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of agent-chat-ux
agent-chat-ux scores 90/100 on our quality scale, 1360th of 4,698 Development & Engineering skills we index (top 29%).
Its SKILL.md is 26 KB long, well organised into 59 sections with 8 code examples: a thorough specification that gives an agent plenty to work with.
With 2,149 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-10-30 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 98/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-30. Automated pattern scan on 2026-09-30. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
agent-chat-ux compared with similar skills
All 4 of these similar skills score higher than agent-chat-ux; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| agent-chat-ux (this skill)by LeoYeAI | 90 | 2.1k | 4mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.6k | today | MCP Server |
Frequently asked questions
- How do I install agent-chat-ux?
- Run
npx skills add LeoYeAI/openclaw-master-skills --skill agent-chat-ux. The install tabs above show the steps for each supported agent. - Which AI agents does agent-chat-ux work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is agent-chat-ux safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 98/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is agent-chat-ux still maintained?
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubname: agent-chat-ux version: 1.4.0 author: Charles Sears description: "Multi-agent UX for OpenClaw Control UI — agent selector, per-agent sessions, session history viewer with search, agent-filtered Sessions tab with friendly names, Create Agent wizard, emoji picker, and backend agent CRUD."
agent-chat-ux
name: agent-chat-ux
version: 1.4.0
author: Charles Sears
description: Multi-agent UX for OpenClaw Control UI — agent selector, per-agent sessions, session history viewer with search, agent-filtered Sessions tab with friendly names, Create Agent wizard, emoji picker, and backend agent CRUD.
⚠️ Security & Transparency Notes
Before applying this skill's patches, be aware of the following:
Credential Access (agents.wizard)
The AI Wizard backend (agents.wizard RPC) calls the configured model provider API directly via HTTP. To do this it needs an API key. It resolves credentials in this exact order:
- Default config auth — uses it if the resolved mode is
api-key(most common) - Auth profile store — searches for the first
api_key-type profile matching the provider. Reads onlyproviderandtypefields to find it; does not log or return values. - Environment variable —
ANTHROPIC_API_KEYorOPENAI_API_KEYas a last resort
If you don't want the wizard reading your auth store, set
ANTHROPIC_API_KEYin your environment and ensure your default auth profile is alreadyapi-keymode — step 2 is skipped entirely in that case.
External API Calls
agents.wizard makes a single HTTP POST to:
https://api.anthropic.com/v1/messages(Anthropic models)https://api.openai.com/v1/chat/completions(OpenAI-compatible models)
No other outbound calls. The call carries your user-supplied description and nothing else from your system.
Patch Scope
These patches modify only agent-related files:
| Patch | File modified | What it changes |
|---|---|---|
| schema-agents.txt | src/gateway/protocol/schema/agents-models-skills.ts | Adds emoji optional param to AgentsUpdateParamsSchema |
| server-agents.txt | src/gateway/server-methods/agents.ts | Adds agents.wizard RPC; fixes agents.update to write - Emoji: (not - Avatar:) so emoji edits persist correctly |
| app-main.txt | ui/src/ui/app.ts | Adds 19 @state() fields: 10 for Create Agent/Wizard + 9 for edit agent, delete agent |
| app-render.txt | ui/src/ui/app-render.ts | Wires create/wizard props + edit agent save handler (sends emoji param, not avatar; evicts identity cache after save) |
| app-render-helpers.txt | ui/src/ui/app-render.helpers.ts | Agent selector dropdown in chat header (uses resolveAgentEmoji() for correct emoji), per-agent session filter, + New Session button |
| agents-view.txt | ui/src/ui/views/agents.ts | Create Agent panel (manual + wizard modes, 103-emoji picker); Edit agent inline form (name/emoji/workspace); Delete agent with confirmation; always-editable Overview |
| agents-utils.txt | ui/src/ui/views/agents-utils.ts | buildModelOptionsMulti() for multi-select fallback dropdown |
| agents-panels-cron.txt | ui/src/ui/views/agents-panels-status-files.ts | Cron Jobs tab Scheduler card now shows agent-specific job count and next-wake (not global gateway stats) |
Each patch is scoped to a single concern. If any patch file modifies more than the files listed above, stop — you have an outdated copy.
LLM Output Validation
Wizard model output is parsed as JSON and validated before use:
- Must be a JSON object with
name(string),emoji(string),soul(string) nameis capped at 100 characters,emojiat 10soulmust be ≥ 20 characters- Empty or non-JSON responses are rejected with a user-visible error — nothing is auto-created
Source Code Modification
This skill applies git apply patches against ~/openclaw and requires a UI + gateway rebuild. Changes are persistent. Always backup before patching:
cd ~/openclaw && git stash # or git branch backup/pre-agent-ux
What This Skill Adds
1. Agent Selector Dropdown in Chat Header
When multiple agents are configured, a dropdown appears left of the session dropdown in the chat header. Selecting an agent switches to that agent's most recent session (or falls back to a fresh webchat key for that agent). The session dropdown automatically filters to show only sessions belonging to the selected agent.
2. Per-Agent Session Filtering (Sorted Newest First)
Sessions are now scoped to the active agent and sorted newest-first. No more mixing other agents' cron jobs and subagent sessions into the current chat's session picker.
3. + New Session Button in Chat Header
A + icon button sits right of the session dropdown, allowing new sessions to be started without typing /new.
4. Create Agent Panel (Manual + AI Wizard)
The Agents tab gains a + Create Agent button that expands a panel with two modes:
Manual mode:
- Agent name
- Workspace path (auto-generated from name if left blank)
- Emoji picker (see below)
AI Wizard mode:
- Describe the agent in plain English
- Click "Generate Agent" — AI generates name, emoji, and full SOUL.md
- Review the preview, then click "✅ Create This Agent"
After creation, the agents list and config form are both refreshed automatically — no "not found in config" error, no manual reload needed.
5. Emoji Picker Dropdown
The emoji field in Create Agent and Edit Agent forms is a dropdown with 103 curated emojis grouped into 5 categories (Tech & AI, People & Roles, Animals, Nature & Elements, Objects & Symbols), each showing the emoji and its name. A large live preview shows the selected emoji next to the dropdown.
6. Edit Agent Inline (Agents Overview)
The Agents Overview card now shows editable inputs directly — no toggle needed:
- Name, Emoji (dropdown, 103 emojis), Workspace are always editable
- Changes activate the bottom Save button — no separate inline Save/Cancel
- Emoji is saved as
- Emoji:in IDENTITY.md (last-wins override of creation value); identity cache is evicted after save so changes appear immediately - Edit uses the
emojiparam ofagents.update(notavatar) so the correct IDENTITY.md key is written
7. Delete Agent
- 🗑️ Delete button appears in the Overview header for non-default agents
- Inline confirmation dialog before deletion; hidden for the main/default agent
8. Agent-Specific Cron Stats
The Scheduler card on the Cron Jobs tab previously showed global gateway stats (total job count, global next wake). Now:
- Jobs → count of cron jobs targeting this agent only
- Next wake → earliest
nextRunAtMsacross this agent's jobs (n/aif no jobs) - Subtitle → "Agent cron scheduling status." (was "Gateway cron status.")
This means agents with no crons correctly show
Jobs: 0/Next wake: n/a.
9. Agents Tab — Model Selector Cleanup
- Removed the redundant read-only "Primary Model" row from the Overview grid (it's already editable in the Model Selection section below)
- Fallback models converted from a free-text comma-separated input to a proper
<select multiple>using the same full model catalog as the primary selector - Added spacing and clear labels between primary and fallback fields
- Small hint "(hold Ctrl/⌘ to select multiple)" on the fallback selector
10. Backend — agents.create / agents.update / agents.delete / agents.wizard
New RPC handlers wired into the gateway:
| Method | Description |
|--------|-------------|
| agents.create | Provisions a new agent entry in config + scaffolds workspace (SOUL.md, AGENTS.md, USER.md) |
| agents.update | Patches agent config (name, workspace, model, identity, etc.) |
| agents.delete | Removes agent from config |
| agents.wizard | Calls the configured LLM to generate name, emoji, and SOUL.md from a plain-text description |
Auth fix in agents.wizard: Raw HTTP calls to the model API require an api_key token, not an OAuth/bearer token. The wizard now falls back to an explicit api_key profile (or ANTHROPIC_API_KEY env var) when the default resolved auth mode is oauth or token.
11. Session History Viewer (v1.4.0)
A modal overlay accessible from the Sessions tab that displays full conversation history for any session:
- Agent dropdown filter — scope sessions by agent
- Session dropdown — pick a session to view (filtered by agent)
- Search bar — debounced full-text search across message content (case-insensitive)
- Role filter chips — All / User / Assistant / System / Tool
- Message timeline — role icons (👤/🤖/⚙️/🔧), timestamps, and message text
- Pagination — "Load More" with count display (100 messages per page)
- Click "History" button on any row in the Sessions tab to open
12. Sessions Tab Overhaul (v1.4.0)
The Sessions tab now provides a unified multi-agent experience:
- Agent filter dropdown — filter sessions by agent (populated from
agents.list) - Friendly session names — "Main Session", "Cron: pipedream-token-refresh", "discord:#bot-chat" instead of raw keys like
agent:main:cron:cc63fdb3-... - Agent identity column — shows agent emoji + identity name (e.g. "🤖 Assistant") using
identity.name→name→idfallback chain - Raw key shown as subtitle — full technical key displayed in smaller muted monospace text below the friendly name
- Label column removed — redundant since the friendly name already incorporates label/displayName
- CSS grid layout — proper column alignment using
grid-template-columnswith proportional widths; headers align precisely with data - Empty state — clear message when an agent has no sessions
- Session count — total/filtered count shown in the store info line
- History button pre-selects — clicking History on a row opens the modal with agent and session already selected, loading history immediately
13. Backend — sessions.history RPC (v1.4.0)
New RPC handler that reads full JSONL transcript files:
| Param | Type | Description |
|-------|------|-------------|
| key | string | Session key |
| limit | number | Max messages (default 200, max 500) |
| offset | number | Pagination offset |
| search | string | Full-text search filter |
| rolesFilter | string[] | Filter by role(s) |
Returns {key, sessionId, agentId, total, offset, items[{role, text, timestamp}]}.
Files Changed
| File | Change |
|------|--------|
| src/gateway/protocol/schema/agents-models-skills.ts | Adds emoji optional param to AgentsUpdateParamsSchema |
| src/gateway/server-methods/agents.ts | agents.wizard RPC; agents.update emoji fix (writes - Emoji: not - Avatar:) |
| ui/src/ui/app-render.helpers.ts | Agent dropdown in chat (with resolveAgentEmoji()), per-agent session filter, + New Session button |
| ui/src/ui/views/agents.ts | Create Agent panel, 103-emoji picker, edit/delete agent UI, always-editable Overview |
| ui/src/ui/views/agents-utils.ts | buildModelOptionsMulti() for multi-select fallback model dropdown |
| ui/src/ui/views/agents-panels-status-files.ts | Cron Jobs tab Scheduler card: agent-specific job count + next wake |
| ui/src/ui/app-render.ts | Create/wizard props wiring + edit agent save handler (emoji param, cache eviction) + session history modal wiring + agent filter for Sessions tab + agent identity name resolution (identity.name fallback chain) + History button agent pre-selection |
| ui/src/ui/app.ts | 19 @state() fields: create/wizard (10) + edit/delete agent (9) + session history modal (8) + sessions agent filter (1) |
| ui/src/ui/app-view-state.ts | Session history modal + sessions agent filter type definitions |
| ui/src/ui/views/sessions.ts | Overhauled: friendly names, agent identity column, agent filter dropdown, CSS grid layout, History button, Label column re
Truncated for display — read the full file on GitHub.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.6k🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
