Command Overview
The openclaw sessions command manages conversation sessions for the AI assistant. Each user's conversation in each channel is an independent session containing conversation history and context information.
View Session List
openclaw sessions list
Sessions:
ID Channel User Messages Last Active
────────────────────────────────────────────────────────────────
sess_abc123 telegram-main user001 45 2 min ago
sess_def456 telegram-main user002 12 1 hour ago
sess_ghi789 discord-dev devuser 128 15 min ago
sess_jkl012 webchat anonymous 3 3 days ago
Total: 4 active sessions
View Session Details
openclaw sessions show sess_abc123
Session: sess_abc123
Channel: telegram-main
User: user001
Agent: default
Model: gpt-4o-mini
Created: 2026-03-15 10:30:00
Last Active: 2 minutes ago
Messages: 45
Token Usage: 12,500
Context Window: 8,192 tokens used / 128,000 max
View Conversation History
openclaw sessions history sess_abc123
openclaw sessions history sess_abc123 --last 10
Session History (last 10 messages):
[2026-03-17 10:25] User: How do I read a JSON file in Python?
[2026-03-17 10:25] AI: You can use Python's json module...
[2026-03-17 10:28] User: What if the file is very large?
[2026-03-17 10:28] AI: For large files, I'd recommend using the ijson library for streaming...
Export Sessions
# Export as JSON
openclaw sessions export sess_abc123 --output session.json
# Export as Markdown
openclaw sessions export sess_abc123 --output session.md --format markdown
# Export all sessions
openclaw sessions export --all --output sessions/
Clean Up Sessions
# Clear a specific session's history (reset context)
openclaw sessions clear sess_abc123
# Delete a session
openclaw sessions delete sess_abc123
# Clean up expired sessions
openclaw sessions cleanup --older-than 7d
# Clean up all inactive sessions
openclaw sessions cleanup --inactive 24h
Session Configuration
{
"sessions": {
"maxHistory": 50,
"maxTokens": 100000,
"timeout": 3600,
"storage": "file",
"cleanupInterval": 86400,
"retentionDays": 30
}
}
| Field | Description |
|---|---|
| maxHistory | Maximum messages per session |
| maxTokens | Maximum context window tokens |
| timeout | Session timeout in seconds |
| retentionDays | Days to retain history |
Session Statistics
openclaw sessions stats
Session Statistics:
Active sessions: 12
Total sessions (30 days): 156
Avg messages per session: 23
Avg session duration: 15 minutes
Total tokens used: 2.5M
Storage used: 45MB
Search Sessions
# Search by user
openclaw sessions search --user user001
# Search by content
openclaw sessions search --query "Python JSON"
# Search by time range
openclaw sessions search --since "2026-03-15" --until "2026-03-17"
Session Migration
Migrate sessions between channels:
openclaw sessions migrate sess_abc123 --to-channel discord-dev
Summary
openclaw sessions provides complete conversation session management. By properly configuring session parameters and regularly cleaning up expired data, you can maintain a great user experience while keeping storage usage under control.