Skip to content

Savers (Chat Storage)

Sidebar → Chat Storage → New

A Saver is the storage backend for conversation history — every chat session and channel must reference one. Pick a backend that matches the lifetime and durability you want.

Backends

BackendDescriptionBest for
FileOne JSON file per conversation thread under ~/.sbot/savers/<saver-id>/Default choice; durable, easy to inspect or back up
SQLiteSingle SQLite database fileMany concurrent threads, faster searches
MemoryIn-process, cleared when the session endsOne-off Q&A, stateless assistants

Configuration

FieldDescription
NameDisplay name
TypeFile / SQLite / Memory
PathStorage location for File / SQLite (defaults to ~/.sbot/savers/<id>/)

Conversation Compaction

When a conversation exceeds a configurable token threshold, sbot automatically summarizes earlier messages and replaces them with a compact recap — preserving continuity while keeping per-turn token cost bounded. This compaction is independent of the saver backend; the full untrimmed transcript stays on disk while the agent sees only the active window.

Assignment

Savers are picked per-session or per-channel. The same Saver can be reused across many sessions — each conversation thread is stored independently.

Tips

  • For a personal assistant you'll come back to: use File
  • For a high-volume IM channel: use SQLite
  • For an "ask once and forget" REST integration: use Memory

Released under the MIT License.