Documentation Index
Fetch the complete documentation index at: https://docs.orcamemory.com/llms.txt
Use this file to discover all available pages before exploring further.
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