ClawXMemory Plugin

@openbmb/clawxmemory is the OpenClaw memory plugin package published from the ClawXMemory repository.

It is responsible for:

• capturing conversations into L0
• building L1 memory fragments when topics close
• updating L2 project memory, L2 daily timeline memory, and the singleton GlobalProfileRecord
• injecting memory context during before_prompt_build
• performing a best-effort session flush before before_reset
• serving the local memory dashboard

Install

openclaw plugins install @openbmb/clawxmemory
openclaw gateway restart

After installation, it is recommended to verify the plugin status:

openclaw plugins inspect clawxmemory --json

Required Config

Make sure your OpenClaw config includes:

{
  "plugins": {
    "slots": {
      "memory": "clawxmemory"
    },
    "entries": {
      "clawxmemory": {
        "enabled": true,
        "hooks": {
          "allowPromptInjection": true
        }
      }
    }
  }
}

Notes:

• This is a kind: "memory" plugin and should be assigned to plugins.slots.memory.
• allowPromptInjection: true must be enabled, or OpenClaw will block the memory injection performed during before_prompt_build.
• If port 39393 is already in use on your machine, explicitly set plugins.entries.clawxmemory.config.uiPort.

Development

Run these commands from this directory:

npm install
npm run build
npm run test
npm run debug:retrieve -- --query "project progress"

For local OpenClaw integration and debugging:

npm run relink
npm run reload
npm run uninstall

Publish to ClawHub

Run from this directory:

npx clawhub package publish . --family code-plugin

The clawhub package publish CLI version tested in this repository does not support --dry-run. To inspect the currently supported arguments first, run:

npx clawhub package publish --help

Repository-level installation, usage, and design docs are available in the root README.md and docs/README_zh.md.