Chat
The Chat interface lets you converse with your agents directly from LordClaw. It mirrors the experience of messaging an agent through Telegram or WhatsApp, but with additional power features.
Conversation List
The main Chat page shows all agents as a conversation list (similar to a messaging app):
- Agent avatar and name
- Last message preview (truncated to 2 lines)
- Relative timestamp of the last message
- Typing indicator when an agent is actively running
- Draft indicator if you have unsaved text in the input
Conversations are sorted by most recent activity.
Chat Interface
Clicking a conversation opens the full chat view:
Messages
- User messages appear on the right in blue bubbles (dark mode optimized)
- Agent messages appear on the left with markdown rendering
- System messages can be toggled on/off in chat options
- Tool calls are shown inline with status indicators (running spinner, ✓ done, ✗ error)
- Streaming — agent responses stream in real-time with a typing cursor
Collapsible Messages
Long messages are automatically collapsed:
- System messages: collapsed after 6 lines
- Regular messages: collapsed after 20 lines
- A “Show more” / “Show less” button appears when content exceeds the threshold (with a 2-line buffer to avoid collapsing for just 1-2 extra lines)
Input Bar
- Floating input at the bottom with rounded corners
- Dynamic sizing — adjusts from single-line to multi-line (max 4 lines on mobile, 3 on desktop)
- Corner radius transitions — rounded pill shape for single-line, standard rounded for multi-line
Chat Options
Access chat options via the settings icon in the conversation header:
| Option | Description |
|---|---|
| Text size | Adjustable font size for messages |
| Show system messages | Toggle visibility of system/internal messages |
| Full quote reply | Include complete message text when replying |
| Send with Enter | When ON, Enter sends (Shift+Enter for newline). Default: ON on desktop, OFF on mobile |
Slash Commands
Type / in the input bar to access local slash commands:
| Command | Action |
|---|---|
/help or /commands | Shows all available commands |
/new or /reset | Creates a new session, shows current model + “Browse providers” button |
/models | Shows provider grid → model list picker |
/model <name> | Sets the model for the current session |
/status | Shows gateway info and agent status |
/stop | Aborts the agent’s current run |
/think, /verbose, /reasoning, /elevated, /usage | Forwarded to the gateway |
Slash command responses are rendered locally in the chat — they don’t depend on gateway chat events, so they appear instantly.
Message Actions
Tap/click a message bubble to reveal action dots. Available actions:
- Copy — copies the message text to clipboard
- Reply — quotes the message in your input
- Forward — sends the message to another agent
Sessions
Each agent can have multiple sessions. The session selector in the chat header lets you switch between them. The default session is agent:<id>:main.
Drafts
Your in-progress messages are automatically saved as drafts (debounced, stored in the database). When you return to a conversation, your draft is restored. Drafts are cleared when you send the message.