MEMORY.md. Clawboo leaves that alone and never shares it. Shared memory also learns from use: agents report which facts helped, and the facts the team trusts rise to the top.
Use this page to understand what shared memory holds, who can see a fact, when agents recall facts without asking, and how search and embeddings work.
The mental model
Shared memory is the team’s notebook. When an agent learns something the team should keep, such as the staging deploy command or the tone you prefer, it writes it down. Any teammate can look it up later. A runtime’s own memory is usually that agent’s private diary; Claude Code is the exception, described under “Each runtime’s own memory” below. Clawboo never copies between the two: an agent chooses what to write in the shared notebook.What shared memory holds
- Facts. A short statement with a title, content and optional tags, for example “Staging deploys run
pnpm deploy:staging”. - Procedures. A named how-to. Saving one under the same name again adds a new version.
memory_save, memory_search, memory_browse and memory_feedback. You browse, search and add facts in the Memory panel (Settings, then Workspace, then Memory); see Memory.
Who can see a fact
The panel labels each fact Team-shared, Agent-scoped or Global. When an agent searches, it sees its team’s facts, facts filed for that agent, and global facts, never another team’s.
OpenClaw agents see global facts only: one Gateway configuration serves all of them, so Clawboo cannot tell which team an OpenClaw agent works for. The scope comes from the agent’s connection, not from what the model asks for, so an agent cannot widen what it sees or file a fact under another team.
Memory learns from use
When an agent uses a fact, it can report how it went withmemory_feedback. The outcomes are useful, dead end (it misled or wasted effort) and corrected (it was wrong, and the note holds the correction). In the Memory panel’s graph you can do the same: click a fact, then Helpful or Outdated.
Clawboo turns these reports into a status on each fact:
A “different reporter” is a different agent, or the same agent on a different task, so your own clicks alone cannot make a fact preferred. Older reports count for less: a report’s weight halves every 30 days. Search results show each fact’s status and id, so an agent can report on the fact it used.
The memory graph
The Memory panel draws your facts as a graph. Facts that share tags are linked, versions of a procedure are linked, and, when embeddings are on, facts with a similar meaning are linked too. Clusters of related facts are grouped and coloured together. Click a fact to read it, see its history, and mark it Helpful or Outdated.When facts are recalled without asking
Whether an agent starts with facts already in hand depends on how the run started:
Most work runs through team chat, so most runs start with no facts and rely on the agent to search. A direct run through the runtime run API can turn the block off with
disableMemoryAutoInject: true. How a team works explains the two paths.
The block ranks preferred facts higher, flags contested ones, and leaves dead-end facts out; they can still be found with a search. Before a fact enters another agent’s prompt, Clawboo drops it if it contains instructions aimed at the agent, such as “ignore your previous instructions”, and masks secrets again.
How search works
Keyword search always works, with no setup. When embeddings are on, a search is hybrid: it weighs meaning (60%) and keyword match (40%), so a search for “deploy steps” can find a fact that says “release process”. A fact embedded by a different model matches on keywords only.Embeddings: local first
Embeddings are what let memory match on meaning. Clawboo picks a provider in this order:- To turn on local embeddings, run
ollama pull nomic-embed-text, or press Install model in the Memory panel. - Memory always looks for Ollama at
http://localhost:11434.OLLAMA_BASE_URLdoes not change it. - The OpenAI key counts when you connected it in Clawboo or exported
OPENAI_API_KEY. A key that only OpenClaw holds is never used for memory. - Set
CLAWBOO_DISABLE_EMBEDDINGS=1to stay on keyword search. - No restart is needed. Clawboo re-checks every 10 minutes while Ollama serves and every 30 seconds otherwise, and indexes facts saved without an embedding in the background.
Each runtime’s own memory
Claude Code agents do not load your own Claude Code memory: not your
~/.claude/CLAUDE.md or rules, not a CLAUDE.md in any folder above the one they work in, and not Claude Code’s auto memory. They do read the CLAUDE.md of the folder they work in, such as a repository’s. A run on a task in the task’s own folder also reads the team’s folder’s CLAUDE.md, so a CLAUDE.md in a team’s folder reaches every Claude Code agent of that team. See Claude Code.What you control
- See and add facts: in the Memory panel, which also shows the graph and each fact’s status. See Memory.
- Correct the team’s memory: mark a fact Helpful or Outdated in the graph.
- Turn on matching by meaning: install
nomic-embed-textin Ollama, or press Install model. - Decide about OpenAI: choose Use OpenAI instead during an Ollama outage, or set
CLAWBOO_DISABLE_EMBEDDINGS=1so memory never calls an embedding provider.
Limits
- Team chat runs, which are most runs, get no facts added automatically. Agents have to search.
- OpenClaw agents read and save global facts only.
- Masking secrets is a pattern match on credential-shaped values, not a guarantee.
- With OpenAI as the embedding provider, fact text and searches are sent to OpenAI.
- The Memory panel saves facts as global; it does not file them under a team.
Under the hood
Under the hood
- Storage. Facts and procedures live in
memory_factsandmemory_procedures, with an FTS5 table for keyword search and a stored vector per fact. Feedback lives inmemory_outcomes. Tables: Database schema. - Tools.
memory_savesaves a fact, or a versioned procedure whenprocedureNameis set.memory_searchtakesmode(fts,vectororhybrid; hybrid when embeddings are available, otherwisefts) andlimit(1 to 100).memory_browsetakeslimit(1 to 200).memory_feedbacktakes a fact id, or an id prefix of at least 8 characters, anoutcome, and a note, whichcorrectedrequires. See MCP tools. - Scope binding. Clawboo binds each run’s Memory connection to its team and agent: in process for Clawboo Native, and in a signed URL for the other runtimes. A bound save is filed under the team only. A run with no team reads global facts only, and so does an HTTP connection without a valid signature, which also saves to global. The
clawboo-mcp-memorystdio program, which you run yourself, takes its scope from the tool arguments and defaults to~/.openclaw/clawboo/clawboo.db, not the server’s database, unless you setCLAWBOO_DB_PATH; see MCP servers. - Automatic recall. The task runner searches in hybrid mode with the task’s title and description, scoped to the task’s team and agent. Each line in the block starts with an 8-character
(id …)so the agent can cite it, and each fact shown is recorded as cited once per task. The block goes into the part of the prompt that is rebuilt every run. - Learning. Status rules: mixed signals give
contested, negatives only givedead_end, two or more distinct(agent, task)reporters ofusefulgivepreferred, one givestentative. Weights decay with a 30-day half-life. - REST.
GETandPOST /api/memory,GET /api/memory/browse,/graph,/outcomesand/provider,POST /api/memory/feedback,/embedding/reindexand/embedding/install. See the Memory API.
Related
- Memory: the Memory panel, step by step.
- Teams, rooms and runtimes: what a team shares and where each runtime keeps its state.
- What an agent sees: everything that goes into an agent’s turn.
- Claude Code: running Claude Code agents, and the setup they share with you.
- MCP tools: the Memory tools’ inputs and outputs.