Description

Fixes a bug in the OpenClaw plugin where setting oss.historyDbPath in the config had no effect, causing a SQLITE_CANTOPEN crash loop when running as a macOS LaunchAgent (service).

Root cause

mem0ai's DEFAULT_MEMORY_CONFIG always initialises historyStore.config.historyDbPath to "memory.db" (a relative path). The Memory constructor always prefers historyStore over the top-level historyDbPath field when historyStore is present — and it is always present because it is merged from defaults. So the user-configured historyDbPath was never actually used.

When the OpenClaw gateway runs as a LaunchAgent with no WorkingDirectory set (the default install), process.cwd() resolves to /. The relative "memory.db" then becomes /memory.db, which is unwritable on macOS (System Integrity Protection), causing:

[openclaw] Uncaught exception: Error: SQLITE_CANTOPEN: unable to open database file

on every before_agent_start hook — crashing the gateway in a continuous restart loop on each incoming message.

Fix

• Extracts the OSS Memory config-building logic from OSSProvider._init() into an exported buildOSSMemoryConfig() helper
• When historyDbPath is explicitly set, also sets historyStore to override the default, ensuring the Memory constructor uses the correct absolute path

Fixes # (no existing issue — discovered and fixed in production)

Type of change

• Bug fix (non-breaking change which fixes an issue)
• Refactor (does not change functionality — extraction of config builder for testability)

How Has This Been Tested?

Unit tests (openclaw/tests/oss-history-db.test.ts, 13 tests via vitest):

• Base config shape with no/empty ossConfig
• Passthrough of embedder, vectorStore, and llm provider configs
• historyDbPath absent → historyStore not set
• historyDbPath present → both historyDbPath and historyStore set correctly
• historyStore.config.historyDbPath matches the configured path (regression test)
• resolvePath applied to both historyDbPath and historyStore

✓ tests/oss-history-db.test.ts (13 tests)
Test Files  1 passed (1)
     Tests  13 passed (13)

Manual (production verification on macOS with gateway running as LaunchAgent):

• Without fix: gateway crashed with SQLITE_CANTOPEN on every message

• With fix: history.db created at the specified absolute path, gateway runs stably

• Unit Test

• Test Script (manual — described above)

Checklist

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• Any dependent changes have been merged and published in downstream modules
• I have checked my code and corrected any misspellings