openclaw - 💡(How to fix) Fix [Bug] sqlite-vec package not found after v2026.4.27 upgrade — memory vector search broken [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#75161Fetched 2026-05-01 05:37:28
View on GitHub
Comments
1
Participants
2
Timeline
2
Reactions
2
Author
Timeline (top)
closed ×1commented ×1

Error Message

  1. memory_search calls vector similarity — error logged

Root Cause

The bundled code does require('sqlite-vec') but the package's exports field requires the full subpath:

// sqlite-vec/package.json
{
  "exports": {
    ".": { "require": "./index.cjs", "import": "./index.mjs", "types": "./index.d.ts" }
  }
}

Node.js cannot resolve require('sqlite-vec') to the correct file without the subpath export map being respected.

Fix Action

Workaround

Manually installing the package fixes it:

cd ~/.openclaw/plugin-runtime-deps/openclaw-2026.4.27-*/
npm install sqlite-vec

After install + gateway restart, vector search works normally.

Code Example

[memory] sqlite-vec unavailable: Cannot find package 'sqlite-vec' imported from /path/to/openclaw/plugin-runtime-deps/openclaw-2026.4.27-*/dist/engine-storage-*.js
Did you mean to import "sqlite-vec/index.cjs"?
[memory] chunks_vec not updated — sqlite-vec unavailable. Vector recall degraded.

---

// sqlite-vec/package.json
{
  "exports": {
    ".": { "require": "./index.cjs", "import": "./index.mjs", "types": "./index.d.ts" }
  }
}

---

cd ~/.openclaw/plugin-runtime-deps/openclaw-2026.4.27-*/
npm install sqlite-vec
RAW_BUFFERClick to expand / collapse

Bug Description

After upgrading to v2026.4.27, the memory system logs repeated errors:

[memory] sqlite-vec unavailable: Cannot find package 'sqlite-vec' imported from /path/to/openclaw/plugin-runtime-deps/openclaw-2026.4.27-*/dist/engine-storage-*.js
Did you mean to import "sqlite-vec/index.cjs"?
[memory] chunks_vec not updated — sqlite-vec unavailable. Vector recall degraded.

This causes memory_search vector similarity ranking to degrade — only keyword matching works.

Root Cause

The bundled code does require('sqlite-vec') but the package's exports field requires the full subpath:

// sqlite-vec/package.json
{
  "exports": {
    ".": { "require": "./index.cjs", "import": "./index.mjs", "types": "./index.d.ts" }
  }
}

Node.js cannot resolve require('sqlite-vec') to the correct file without the subpath export map being respected.

Reproduction

  1. Fresh install of v2026.4.27
  2. No sqlite-vec in plugin-runtime-deps/.../node_modules/
  3. memory_search calls vector similarity — error logged

Workaround

Manually installing the package fixes it:

cd ~/.openclaw/plugin-runtime-deps/openclaw-2026.4.27-*/
npm install sqlite-vec

After install + gateway restart, vector search works normally.

Suggested Fix

Either:

  1. Add sqlite-vec as an explicit dependency in the plugin-runtime-deps package and ship it bundled, OR
  2. Patch the import path in engine-storage*.js to use \sqlite-vec/index.cjs'

Environment

  • OpenClaw v2026.4.27 (v2026.4.27-da6bdffc3d96)
  • macOS (Darwin 25.4.0, arm64)
  • Node.js v25.8.2
  • sqlite-vec v0.1.9

Severity

Medium — core memory recall quality is degraded, but text search still functions.

extent analysis

TL;DR

Manually installing sqlite-vec or patching the import path in engine-storage*.js may resolve the vector similarity ranking issue.

Guidance

  • Verify that sqlite-vec is not present in plugin-runtime-deps/.../node_modules/ before attempting a fix.
  • Consider adding sqlite-vec as an explicit dependency in the plugin-runtime-deps package to ensure it is bundled and shipped correctly.
  • If manual installation is preferred, run npm install sqlite-vec in the ~/.openclaw/plugin-runtime-deps/openclaw-2026.4.27-*/ directory and restart the gateway.
  • To patch the import path, update engine-storage*.js to use require('sqlite-vec/index.cjs') instead of require('sqlite-vec').

Example

// engine-storage*.js
const sqliteVec = require('sqlite-vec/index.cjs'); // updated import path

Notes

The issue is specific to OpenClaw v2026.4.27 and may not affect other versions. The suggested fixes assume that the sqlite-vec package is compatible with the current Node.js version (v25.8.2).

Recommendation

Apply the workaround by manually installing sqlite-vec using npm install sqlite-vec in the affected directory, as this is a quicker solution than patching the import path or adding sqlite-vec as a dependency.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

openclaw - 💡(How to fix) Fix [Bug] sqlite-vec package not found after v2026.4.27 upgrade — memory vector search broken [1 comments, 2 participants]