Session Management
AmebaClaw supports multi-session conversations — a single chat window (channel + chat ID) can hold multiple independent conversation histories. Use slash commands to switch between sessions at any time without losing context.
What is a Session?
Each session has its own independent conversation context. For example, in Telegram you can maintain a work session and a travel session simultaneously; their histories are fully isolated and the AI’s “memory” in each session is independent.
Note
Slash commands work across all configured messaging channels: Telegram, WeChat, Feishu, QQ, the local web chat window, and the serial terminal.
—
Slash Command Reference
Send any of the following commands in any channel to manage sessions. Commands are case-sensitive; the / prefix is required.
Command |
Description |
|---|---|
|
Create a new session and immediately switch to it. The previous session’s history is fully preserved. The name is optional; if omitted, a name is generated automatically (format |
|
List all sessions in the current channel. The active session is marked |
|
Switch to the named session and restore its conversation history. |
|
Rename the current active session. |
|
Delete the named session and its history. The currently active session cannot be deleted; use |
|
Clear the conversation history of the current session and start fresh. The session name is retained; other sessions are unaffected. |
—
Command Details and Examples
/new
Create a new session and switch to it immediately. The history of the previous session is preserved and can be resumed at any time with /resume.
Syntax:
/new [name]
Examples:
/new work
✓ New session 'work' created.
/new
✓ New session '0630-1530' created.
Note
Session names may only contain letters, digits, dots (.), underscores (_), and hyphens (-), up to 32 characters.
/list
List all sessions under the current chat. The active session is marked (current).
Syntax:
/list
Example:
/list
Sessions:
• default
• work (current)
• travel
/resume
Switch context to the named session and restore its history.
Syntax:
/resume <name>
Examples:
/resume travel
✓ Switched to session 'travel'.
If the name does not exist:
/resume xyz
Session 'xyz' not found. Use /list to see available sessions.
If the name argument is missing:
/resume
Usage: /resume <name>
/rename
Rename the current active session.
Syntax:
/rename <new-name>
Examples:
/rename home
✓ Session renamed to 'home'.
If the new name is already taken:
/rename work
Session name 'work' already exists.
/delete
Delete the named session and its conversation history.
Syntax:
/delete <name>
Example:
/delete default
✓ Session 'default' deleted.
Warning
The currently active session cannot be deleted. Switch to another session first:
/delete work
Cannot delete the current session. Use /resume to switch first.
/clear
Clear all conversation history in the current session and start fresh under the same session name. Other sessions are not affected.
Syntax:
/clear
Example:
/clear
✓ Conversation cleared.
—
Typical Usage Scenarios
Maintaining separate work and personal conversations in one Telegram account:
/new work ← create a work session
(discuss work with the AI...)
/new life ← create a personal session; work context is preserved
(chat about daily life...)
/resume work ← switch back to work context at any time
Check what sessions exist before switching:
/list
Sessions:
• work (current)
• life
Clean up a test session:
/resume work ← switch away first, since 'test' is the current session
/delete test
Note
All slash commands are intercepted before the message reaches the AI, so they do not consume LLM tokens and respond instantly.
—
Web Console Management
In addition to slash commands, the web console provides a unified cross-channel session management view where you can browse sessions across all channels, view conversation histories, and delete sessions. See the Session Management section in AmebaClaw Web Console User Manual.
