Overview
Orca Memory is an OpenClaw plugin that provides persistent memory for your Claw. It stores and retrieves memories automatically to maintain context across sessions.Projects
A project is your workspace in Orca Memory. Each project has:- A unique API key for authentication
- Its own set of memories
- Configurable memory types
- Usage analytics
Agents
An agent represents your Claw connected to a project. When you install the Orca Memory plugin, your Claw becomes capable of:- Storing new memories via the API
- Retrieving relevant memories before responding
- Updating existing memories as context changes
Plugin Features
Auto-Recall
When enabled, relevant memories are automatically injected into the conversation before each AI turn. The plugin:- Takes the current conversation context
- Searches for semantically similar memories
- Injects them as system context
maxRecallResults (default: 10) and profileFrequency.
Auto-Capture
When enabled, important information is automatically extracted and stored after each turn. The plugin analyzes the conversation and stores:- User preferences mentioned
- Decisions made
- Facts learned
- Patterns observed
captureMode: all (default, filters noise) or everything.
Tools
Your Claw also has manual control via tools:| Tool | Description |
|---|---|
orca_memory_store | Store a new memory |
orca_memory_search | Search existing memories |
orca_memory_forget | Delete a memory |
orca_memory_profile | View memory profile |
Memory Types
Orca Memory uses four distinct memory types, inspired by human cognition:Episodic Memory
Stores specific events and conversations. Useful for:- Recalling past debugging sessions
- Remembering previous discussions about architecture
- Tracking decision history
Semantic Memory
Stores facts and knowledge about your project. Useful for:- Project structure and conventions
- Technology stack information
- Business logic rules
Procedural Memory
Stores patterns, preferences, and how-to knowledge. Useful for:- Coding style preferences
- Workflow patterns
- Repeated procedures
Working Memory
Stores active, short-term context. Useful for:- Current task details
- Recent decisions in the session
- Temporary context
How It Works
- User interacts with their Claw
- Auto-Recall fetches relevant memories from Orca Memory
- Claw responds using retrieved context
- Auto-Capture stores new learnings as memories