Context Engine#

Smart Context Engine maintains conversation state and project continuity across OpenClaw sessions.

Quick Start#

The context engine automatically:

• Restores your last active project on session start
• Saves context periodically (heartbeat) and on session end
• Tracks pending tasks and notes per project

Commands#

• "remember" / "save context" - Manually save current context
• "switch to [project]" - Switch to a project (creates if doesn't exist)
• "show projects" / "what are we working on" - List all projects
• "summarize" / "where did we leave off" - Get project summary

Storage#

Projects are stored in: /home/deus/.openclaw/workspace/memory/projects/

• projects.json - All project data
• session.json - Current session state

Actions#

save_context#

Saves the current context including:

• Last topic discussed
• Last file worked on
• Last command executed
• Pending tasks
• Notes

Trigger: Explicit mention ("remember", "save context"), session_end, heartbeat

restore_context#

Restores the previous session's context:

• Loads last active project
• Shows "Welcome back to [project]"
• Lists pending tasks if any

Trigger: session_start, explicit request

switch_project#

Switches between projects:

• Saves current project context
• Loads or creates new project
• Sets as active

Trigger: Explicit mention ("switch to X")

list_projects#

Lists all projects with status indicators:

• Shows active project highlighted
• Displays status (active/paused/completed/archived)
• Shows last session date

Trigger: Explicit mention ("show projects", "what are we working on")

summarize#

Generates a summary of the active project:

• Current status
• Pending tasks
• Last topic
• Session history

Trigger: Explicit mention ("summarize", "where did we leave off")

Triggers#

TriggerConditionPrioritysession_startNew session begins1explicit_mentionUser says "remember", "save context", "project", "switch to", "show projects", "summarize"2heartbeatEvery ~30 min when enabled3

Integration#

Works with the MEMORY.md system - updates long-term memory with project summaries.