- Browser: add viewport coordinate clicks for managed and existing-session automation, plus `openclaw browser click-coords` for CLI use. (#54452) Thanks @dluttz.

- Browser/config: support per-profile `browser.profiles.<name>.headless` overrides for locally launched browser profiles, so one profile can run headless without forcing all browser profiles headless. Thanks @nakamotoliu.

- Plugins/PDF: move local PDF extraction into a bundled `document-extract` plugin so core no longer owns `pdfjs-dist` or PDF image-rendering dependencies. Thanks @vincentkoc.

- Dependencies/memory: stop installing `node-llama-cpp` by default; local embeddings now load it only when operators install the optional runtime package. Thanks @vincentkoc.

- Matrix: require full cross-signing identity trust for self-device verification and add `openclaw matrix verify self` so operators can establish that trust from the CLI. (#70401) Thanks @gumadeiras.

- WebChat/sessions: keep runtime-only prompt context out of visible transcript history and scrub legacy wrappers from session history surfaces. Thanks @91wan.

- Gradium: add a bundled text-to-speech provider with voice-note and telephony output support. (#64958) Thanks @LaurentMazare.

Without an embedding provider, only keyword search is available.

To force the built-in local embedding provider, point `local.modelPath` at a

GGUF file:

To force the built-in local embedding provider, install the optional

`node-llama-cpp` runtime package next to OpenClaw, then point `local.modelPath`

at a GGUF file:

```json5

{

| Voyage | `voyage` | Yes | |

| Mistral | `mistral` | Yes | |

| Ollama | `ollama` | No | Local, set explicitly |

| Local | `local` | Yes (first) | GGUF model, ~0.6 GB download |

| Local | `local` | Yes (first) | Optional `node-llama-cpp` runtime |

Auto-detection picks the first provider whose API key can be resolved, in the

order shown. Set `memorySearch.provider` to override.

- **Reranking and query expansion** for better recall.

- **Index extra directories** -- project docs, team notes, anything on disk.

- **Index session transcripts** -- recall earlier conversations.

- **Fully local** -- runs via Bun + node-llama-cpp, auto-downloads GGUF models.

- **Fully local** -- runs with the optional node-llama-cpp runtime package and

auto-downloads GGUF models.

- **Automatic fallback** -- if QMD is unavailable, OpenClaw falls back to the

builtin engine seamlessly.

}

```

For local embeddings with no API key, use `provider: "local"` (requires

node-llama-cpp).

For local embeddings with no API key, install the optional `node-llama-cpp`

runtime package next to OpenClaw and use `provider: "local"`.

## Supported providers

import { formatErrorMessage } from "../dreaming-shared.js";

import { filterUnregisteredMemoryEmbeddingProviderAdapters } from "./provider-adapter-registration.js";

const NODE_LLAMA_CPP_RUNTIME_PACKAGE = "node-llama-cpp";

const NODE_LLAMA_CPP_RUNTIME_VERSION = "3.18.1";

const NODE_LLAMA_CPP_INSTALL_SPEC = `${NODE_LLAMA_CPP_RUNTIME_PACKAGE}@${NODE_LLAMA_CPP_RUNTIME_VERSION}`;

export type BuiltinMemoryEmbeddingProviderDoctorMetadata = {

providerId: string;

authProviderId: string;

return false;

}

const code = (err as Error & { code?: unknown }).code;

return code === "ERR_MODULE_NOT_FOUND" && err.message.includes("node-llama-cpp");

return code === "ERR_MODULE_NOT_FOUND" && err.message.includes(NODE_LLAMA_CPP_RUNTIME_PACKAGE);

}

function listRemoteEmbeddingSetupHints(): string[] {

"To enable local embeddings:",

"1) Use Node 24 (recommended for installs/updates; Node 22 LTS, currently 22.14+, remains supported)",

missing

? "2) Reinstall OpenClaw (this should install node-llama-cpp): npm i -g openclaw@latest"

? `2) Install optional local embedding runtime next to OpenClaw: npm i -g ${NODE_LLAMA_CPP_INSTALL_SPEC}`

: null,

"3) If you use pnpm: pnpm approve-builds (select node-llama-cpp), then pnpm rebuild node-llama-cpp",

`3) If you use pnpm: pnpm approve-builds (select ${NODE_LLAMA_CPP_RUNTIME_PACKAGE}), then pnpm rebuild ${NODE_LLAMA_CPP_RUNTIME_PACKAGE}`,

...listRemoteEmbeddingSetupHints(),

]

.filter(Boolean)

"typescript": "^6.0.3",

"vitest": "^4.1.5"

},

"peerDependencies": {

"node-llama-cpp": "3.18.1"

},

"peerDependenciesMeta": {

"node-llama-cpp": {

"optional": true

}

},

"overrides": {

"axios": "1.15.0",

"follow-redirects": "1.16.0",