openclaw-openbrain-context

OpenBrain-backed ContextEngine plugin for OpenClaw.

This plugin stores session context in OpenBrain over REST so context can be reassembled from recent history plus semantic matches instead of relying only on in-session compaction state.

Features

• Registers context engine id: openbrain
• Typed OpenBrain REST client with Bearer auth
• Session-aware ingest + batch ingest
• Context assembly from recent + semantic search under token budget
• Compaction summaries archived to OpenBrain
• Subagent seed/result handoff helpers

Requirements

• OpenClaw with plugin/context-engine support (openclaw >= 2026.3.2)
• Reachable OpenBrain REST API
• OpenBrain API key

Install (local workspace plugin)

pnpm install
pnpm build

Then reference this plugin in your OpenClaw config.

OpenBrain Setup (self-host or hosted)

You must provide both of these in plugin config:

• baseUrl: your OpenBrain API root (example: https://brain.your-domain.com)
• apiKey: Bearer token for your OpenBrain instance

No host or key fallback is built in. Missing baseUrl or apiKey throws OpenBrainConfigError at bootstrap().

Configuration

Plugin entry id: openclaw-openbrain-context
Context engine slot id: openbrain

Config fields

• baseUrl (required, string): OpenBrain API base URL
• apiKey (required, string): OpenBrain Bearer token
• source (optional, string, default openclaw): source prefix; engine stores thoughts under <source>:<sessionId>
• recentMessages (optional, integer, default 20): recent thoughts to fetch for bootstrap/assemble
• semanticSearchLimit (optional, integer, default 10): semantic matches fetched in assemble
• subagentRecentMessages (optional, integer, default 8): context lines used for subagent seed/result exchange

Environment Variable Pattern

Use OpenClaw variable interpolation in openclaw.json:

{
  "apiKey": "${OPENBRAIN_API_KEY}"
}

Then set it in your shell/runtime environment before starting OpenClaw.

Example openclaw.json

{
  "plugins": {
    "slots": {
      "contextEngine": "openbrain"
    },
    "entries": {
      "openclaw-openbrain-context": {
        "enabled": true,
        "config": {
          "baseUrl": "https://brain.example.com",
          "apiKey": "${OPENBRAIN_API_KEY}",
          "source": "openclaw",
          "recentMessages": 20,
          "semanticSearchLimit": 10,
          "subagentRecentMessages": 8
        }
      }
    }
  }
}

Development

pnpm lint
pnpm build
pnpm test