modbender BEE — Belief Extraction Engine
Give your OpenClaw agents persistent, structured memory across sessions.
What BEE Does
BEE hooks into the OpenClaw lifecycle and:
- Extracts beliefs at session end via a lightweight LLM call (Haiku by default)
- Injects recalled context before every agent spawn
- Scopes by namespace — each agent (VECTOR, FORGE, ORACLE, etc.) has isolated beliefs
- Deduplicates — cosine similarity check prevents duplicate beliefs (>0.92 → merge)
- Tracks spawns — monitors subagent budget per session
Beliefs live in a SQLite database (vector.db) and persist indefinitely across restarts.
Installation
Step 1 — Install the package
From npm (recommended):
npm install -g @skysphere-labs/openclaw-bee
From GitHub (latest):
npm install -g github:skysphere-labs/openclaw-bee
Step 2 — Configure openclaw.json
Add BEE to your extensions in ~/.openclaw/openclaw.json:
{
"extensions": {
"entries": {
"bee": {
"enabled": true,
"config": {
"dbPath": "~/.openclaw/workspace/state/vector.db",
"agentId": "main",
"extractionEnabled": true,
"extractionModel": "anthropic/claude-haiku-4-5",
"maxCoreBeliefs": 10,
"maxActiveBeliefs": 5,
"maxRecalledBeliefs": 5
}
}
}
}
}
Step 3 — Restart the gateway
openclaw gateway restart
BEE will run its database migration on first start and begin capturing beliefs.
Configuration Options
| Option | Default | Description |
|---|---|---|
dbPath |
required | Path to your SQLite database |
agentId |
"main" |
Namespace for belief scoping |
extractionEnabled |
true |
Enable/disable belief extraction |
extractionModel |
"anthropic/claude-haiku-4-5" |
Model used for extraction (cheapest works well) |
extractionMinConfidence |
0.55 |
Minimum confidence to store a belief (0-1) |
maxCoreBeliefs |
10 |
Core beliefs injected into every session |
maxActiveBeliefs |
5 |
Recently active beliefs injected |
maxRecalledBeliefs |
5 |
Semantically recalled beliefs per query |
maxOutputChars |
2000 |
Max chars of belief context injected |
debug |
false |
Enable verbose logging |
spawnBudgetWarning |
20 |
Warn when subagent spawns exceed this threshold |
Verifying It Works
After restart, ask your agent:
"How many beliefs do you have?"
Or check directly:
sqlite3 ~/.openclaw/workspace/state/vector.db "SELECT COUNT(*) FROM beliefs"
You should see beliefs accumulate after sessions complete.
Multi-Agent Setup
For setups with multiple named agents (VECTOR, FORGE, ORACLE, etc.), use different agentId values per agent spawn. BEE scopes beliefs by agentId so each PM has isolated memory.