BEE Belief Extraction Engine

Install and configure BEE — the Belief Extraction Engine for OpenClaw. Gives agents persistent structured memory across sessions. Auto-extracts beliefs at session end, scopes by agent namespace, and injects recalled context on agent start. Use when: setting up agent memory, configuring belief persistence, or troubleshooting BEE. NOT for: general memory questions (use built-in memory tools instead).

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):

bash

npm install -g @skysphere-labs/openclaw-bee

From GitHub (latest):

bash

npm install -g github:skysphere-labs/openclaw-bee

Step 2 — Configure openclaw.json

Add BEE to your extensions in ~/.openclaw/openclaw.json:

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

bash

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:

bash

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.

---

Source

• GitHub: https://github.com/skysphere-labs/openclaw-bee
• npm: https://www.npmjs.com/package/@skysphere-labs/openclaw-bee
• Built by Skysphere AI Labs