Problem

The Python mem0 SDK supports LM Studio as both an embedder and LLM provider, but the TypeScript SDK does not. Users configuring LM Studio via OpenClaw or mem0-ts get Unsupported embedder provider: lmstudio / Unsupported LLM provider: lmstudio errors.

Reported in #4235.

Solution

Add LMStudioEmbedder and LMStudioLLM classes to mem0-ts, matching the Python SDK's feature set:

• LMStudioEmbedder — Standalone embedder using the OpenAI client with encoding_format: "float" (required because LM Studio doesn't support the OpenAI SDK's default base64 encoding, which produces zero vectors). Includes newline normalization and error wrapping.
• LMStudioLLM — Extends OpenAILLM with LM Studio defaults (localhost:1234, dummy API key, Meta Llama model). Wraps errors with clear messages.
• ConfigManager — Normalizes Python SDK snake_case keys (lmstudio_base_url → baseURL, embedding_dims → embeddingDims) for both embedder and LLM configs. Uses nullish coalescing (??) so existing providers are unaffected.
• Factory registration — "lmstudio" registered in both EmbedderFactory and LLMFactory.
• Exports and docs — Re-exported from index.ts, documented in OpenClaw README.

Files changed

Testing

Unit tests (always run)

• lmstudio-embedder.test.ts (4 tests) — embed with encoding_format: "float", newline normalization, error wrapping, batch embedding
• lmstudio-llm.test.ts (5 tests) — text response, tool calls, error wrapping, chat response
• config-manager.test.ts (14 new tests) — snake_case normalization for embedder and LLM, camelCase precedence, full OpenClaw-style config from issue OpenClaw integration doesn’t support lmstudio #4235, mocked Memory E2E flow (factory wiring, dimension auto-detect, search, add)
• factory.test.ts (2 new tests) — EmbedderFactory.create("lmstudio") and unsupported provider error

Integration tests (require local LM Studio, skipped by default)

• lmstudio-integration.test.ts (10 tests) — Tested against real LM Studio server with text-embedding-nomic-embed-text-v1.5 (embedder) and qwen2.5-0.5b-instruct (LLM). Enable with LMSTUDIO_INTEGRATION=1.
• Verified: embedding dimensions (768), newline normalization, batch embeddings, semantic similarity (cosine 0.83 similar vs 0.36 different), chat responses, multi-turn conversation.

Regression

• All 79 existing tests pass with no changes.

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

Maintainer Checklist

• closes OpenClaw integration doesn’t support lmstudio #4235