Registry / database / openclaw-memory-alibaba-mysql

openclaw-memory-alibaba-mysql

library0.2.6jsnpmunverified

OpenClaw memory plugin that uses Alibaba Cloud RDS MySQL for vector storage, enabling user memories, full-text conversation logs, and self-evolving memory. Version 0.2.6 requires the openclaw peer dependency. It supports automatic recall and capture, LLM-based memory extraction and conflict/dedup handling, time decay for recent memories, and configurable similarity thresholds. Differentiators include deep integration with OpenClaw lifecycle hooks, compatibility with DashScope embeddings and LLMs, and options for both regex and LLM-based memory extraction.

database ai-ml

npm install openclaw-memory-alibaba-mysql

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · OPENCLAW-MEMORY-AL

openclaw-memory-alibaba-mysql

databasejavascriptv0.2.6

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

openclaw

✓ import { config } from 'openclaw'

✗ No import needed; plugin is loaded via OpenClaw config

This is a plugin, not a library. Configure via OpenClaw's plugins.slots.memory and entries.

MySQLConnectionConfig

✓ import { MySQLConnectionConfig } from 'openclaw-memory-alibaba-mysql'

✗ const { MySQLConnectionConfig } = require('openclaw-memory-alibaba-mysql')

ESM only (named export) since v0.2.0; CJS require may fail due to missing default export.

openclaw-memory-alibaba-mysql (default import)

✓ import plugin from 'openclaw-memory-alibaba-mysql'

✗ No use case; plugin is not directly invoked in code

Default import not recommended; use config-based loading.

Shows plugin configuration for OpenClaw with MySQL, embedding, and LLM services; enables full memory features.

// Config snippet for OpenClaw (plugin setup) // Ensure openclaw is installed and this plugin is added to package.json { "plugins": { "slots": { "memory": "openclaw-memory-alibaba-mysql" }, "entries": { "openclaw-memory-alibaba-mysql": { "enabled": true, "config": { "mysql": { "host": process.env.MYSQL_HOST ?? 'your-rds.aliyuncs.com', "port": 3306, "user": process.env.MYSQL_USER ?? 'openclaw', "password": process.env.MYSQL_PASSWORD ?? '', "database": "openclaw", "ssl": true }, "embedding": { "apiKey": process.env.DASHSCOPE_API_KEY ?? '', "model": "text-embedding-v3", "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1" }, "llm": { "apiKey": process.env.DASHSCOPE_API_KEY ?? '', "model": "qwen-plus", "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1" }, "memory_duplication_conflict_process": true, "similarityThresholdUserMemory": 0.65, "similarityThresholdSelfImproving": 0.62, "enableFullContextMemory": true, "enableSelfImprovingMemory": true, "memoryExtractionMethod": "llm", "autoRecall": true, "autoCapture": true, "captureMaxChars": 5000, "enableMemoryDecay": true, "tableName": "openclaw_memories" } } } } }

Debug

Known issues

breakingPlugin only works with openclaw peer dependency; incorrect version may cause runtime errors

fix

Install openclaw@latest in your project

affects: *

deprecatedmemoryExtractionMethod: 'regex' may be removed in future versions; use 'llm'

fix

Switch to 'llm' extraction method

affects: >=0.2.0

gotchaUsing environment variable placeholders like ${MYSQL_PASSWORD} requires the plugin to read them at runtime; missing env var causes connection failure

fix

Ensure all referenced env vars are set before starting OpenClaw

affects: *

gotchaThe embedding model 'text-embedding-v3' requires 'dimensions' parameter (e.g., 1024) in config; missing leads to errors

fix

Add 'dimensions': 1024 to embedding config

affects: >=0.2.0

breakingPlugin uses vector search; MySQL table must have a vector index column; missing schema causes failure

fix

Run schema migration (provided in plugin docs) before first use

affects: *

Errors

Common errors & fixes

Error: connect ECONNREFUSED your-rds.aliyuncs.com:3306

MySQL host/port incorrect or not reachable

fix

Verify MYSQL_HOST and MYSQL_PORT env vars; ensure security group allows inbound on 3306

TypeError: Cannot read properties of undefined (reading 'apiKey')

Missing DASHSCOPE_API_KEY environment variable

fix

Set DASHSCOPE_API_KEY in .env or process environment

Error: Database 'openclaw' does not exist

MySQL database not created before plugin init

fix

CREATE DATABASE openclaw; before starting plugin

Error: Plugin 'openclaw-memory-alibaba-mysql' not found

Package not installed or not in node_modules

fix

Run npm install openclaw-memory-alibaba-mysql

Upgrade

Version history

0.2.6latest on npm

Audit

Dependencies

openclawrequiredPeer dependency; the plugin is an extension for the OpenClaw framework

Agent activity

5 hits · last 30 days

node

Resources

githubhttps://github.com/chengjue-2445/alibabacloud_mysql_openclaw_memory_extension ↗

packageopenclaw-memory-alibaba-mysql ↗

homepagehttps://github.com/chengjue-2445/alibabacloud_mysql_openclaw_memory_extension#readme ↗