Struct MemoryManager 

pub struct MemoryManager { /* private fields */ }

Implementations

impl MemoryManager

pub fn new(config: &MemoryConfig) -> Result<Self>

Create a new MemoryManager with the default agent ID (“main”)

pub fn new_with_agent(config: &MemoryConfig, agent_id: &str) -> Result<Self>

Create a new MemoryManager for a specific agent ID (OpenClaw-compatible)

pub fn new_with_full_config( memory_config: &MemoryConfig, app_config: Option<&Config>, agent_id: &str, ) -> Result<Self>

Create a new MemoryManager with full config (for OpenAI embedding provider)

pub fn with_embedding_provider( self, provider: Arc<dyn EmbeddingProvider>, ) -> Self

Set embedding provider for semantic search (requires OpenAI API key)

pub fn has_embeddings(&self) -> bool

Check if semantic search is available

pub fn workspace(&self) -> &PathBuf

pub fn db_path(&self) -> &PathBuf

Get the path to the SQLite database used by this memory manager.

pub fn backend(&self) -> &dyn MemoryBackend

Get a reference to the active memory backend.

pub fn read_memory_file(&self) -> Result<String>

Read the main MEMORY.md file

pub fn read_heartbeat_file(&self) -> Result<String>

Read the HEARTBEAT.md file

pub fn read_soul_file(&self) -> Result<String>

Read the SOUL.md file (persona/tone guidance)

pub fn read_user_file(&self) -> Result<String>

Read the USER.md file (OpenClaw-compatible: user info)

pub fn read_identity_file(&self) -> Result<String>

Read the IDENTITY.md file (OpenClaw-compatible: agent identity context)

pub fn read_agents_file(&self) -> Result<String>

Read the AGENTS.md file (OpenClaw-compatible: list of agents)

pub fn is_brand_new(&self) -> bool

Check if this is a brand new workspace (first run)

pub fn read_tools_file(&self) -> Result<String>

Read the TOOLS.md file (OpenClaw-compatible: local tool notes)

pub fn read_recent_daily_logs(&self, days: usize) -> Result<String>

Read recent daily log files

pub fn search(&self, query: &str, limit: usize) -> Result<Vec<MemoryChunk>>

Search memory using hybrid search (FTS + semantic if available)

pub fn search_fts(&self, query: &str, limit: usize) -> Result<Vec<MemoryChunk>>

Search memory using FTS only (faster, no API calls)

pub fn chunk_count(&self) -> Result<usize>

Get total chunk count

pub fn reindex(&self, force: bool) -> Result<ReindexStats>

Reindex all memory files

pub fn stats(&self) -> Result<MemoryStats>

Get memory statistics

pub fn recent_entries(&self, count: usize) -> Result<Vec<RecentEntry>>

Get recent memory entries

pub fn start_watcher(&self) -> Result<MemoryWatcher>

Start file watcher for automatic reindexing.

The file watcher is only supported with the SQLite backend because it creates its own MemoryIndex connection for the background thread.

pub async fn generate_embeddings( &self, batch_size: usize, ) -> Result<(usize, usize)>

Generate embeddings for chunks that don’t have them Returns (chunks_processed, chunks_embedded) Uses embedding cache to avoid regenerating identical content

pub fn embedded_chunk_count(&self) -> Result<usize>

Get count of chunks with embeddings

Trait Implementations

impl Clone for MemoryManager

fn clone(&self) -> MemoryManager

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.