# Send LanceDB Hybrid Search to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "memory-lancedb-hybrid",
    "name": "LanceDB Hybrid Search",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/joeykrug/memory-lancedb-hybrid",
    "canonicalUrl": "https://clawhub.ai/joeykrug/memory-lancedb-hybrid",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/memory-lancedb-hybrid",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=memory-lancedb-hybrid",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "plugin/config.ts",
      "plugin/index.ts",
      "plugin/openclaw.plugin.json",
      "plugin/package-lock.json",
      "plugin/package.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/memory-lancedb-hybrid"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/memory-lancedb-hybrid",
    "downloadUrl": "https://openagent3.xyz/downloads/memory-lancedb-hybrid",
    "agentUrl": "https://openagent3.xyz/skills/memory-lancedb-hybrid/agent",
    "manifestUrl": "https://openagent3.xyz/skills/memory-lancedb-hybrid/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/memory-lancedb-hybrid/agent.md"
  }
}
```
## Documentation

### LanceDB Hybrid Search (Memory Plugin)

This skill packages a drop-in OpenClaw memory plugin that adds hybrid search to LanceDB memory:

Vector search (semantic)
BM25 full-text search (exact terms)
Configurable reranking:

rrf (Reciprocal Rank Fusion, recommended)
linear (weighted combination)

It is based on (and credits) OpenClaw PR openclaw/openclaw#7636.

### What you get

A local plugin (extension) located at:

plugin/ → overrides the built-in plugin id memory-lancedb (adds hybrid search)

Once enabled, it provides the same tools as the bundled LanceDB memory plugin:

memory_store
memory_recall
memory_forget

…but memory_recall/auto-recall/forget now use hybrid search when enabled.

### Install / Enable

Ensure the skill folder exists (ClawHub install puts it under your workspace):

~/.openclaw/workspace/skills/memory-lancedb-hybrid/plugin

Install the plugin dependencies (once):

cd ~/.openclaw/workspace/skills/memory-lancedb-hybrid/plugin
npm install --omit=dev

Add the plugin to OpenClaw’s plugin load paths.

This plugin keeps the id memory-lancedb, so it will override the bundled memory-lancedb extension when discovered via plugins.load.paths (higher precedence than bundled).

Edit ~/.openclaw/openclaw.json:

{
  plugins: {
    load: {
      // Point at the plugin directory inside this skill
      paths: ["~/.openclaw/workspace/skills/memory-lancedb-hybrid/plugin"]
    },

    // Ensure the memory slot points at LanceDB memory
    slots: {
      memory: "memory-lancedb"
    },

    // Configure LanceDB memory (this override adds the \`hybrid\` config block)
    entries: {
      "memory-lancedb": {
        enabled: true,
        config: {
          embedding: {
            apiKey: "${OPENAI_API_KEY}",
            model: "text-embedding-3-small"
          },

          // Optional
          dbPath: "~/.openclaw/memory/lancedb",

          // Optional
          autoCapture: true,
          autoRecall: true,

          // Hybrid search options
          hybrid: {
            enabled: true,
            reranker: "rrf"

            // If using reranker: "linear", you can also set:
            // vectorWeight: 0.7,
            // textWeight: 0.3,
          }
        }
      }
    }
  }
}

Restart the Gateway.

Hybrid search needs an FTS index on the text column; the plugin will attempt to create it automatically. If FTS setup fails for any reason, the plugin logs a debug message and falls back to vector-only search.

### Config reference

All config lives under plugins.entries.memory-lancedb.config.

hybrid.enabled (boolean, default true)
hybrid.reranker (rrf | linear, default rrf)
hybrid.vectorWeight (number 0–1, default 0.7, only used for linear)
hybrid.textWeight (number 0–1, default 0.3, only used for linear)

### Notes / troubleshooting

This plugin does not modify OpenClaw’s install on disk; it overrides the bundled memory-lancedb at runtime (remove plugins.load.paths to revert).
If you already have LanceDB memory data on disk, you can keep using the same dbPath.
If you see no hybrid effect, make sure hybrid.enabled is true and that the FTS index was created (check Gateway logs).

### Files

plugin/index.ts – plugin implementation (hybrid search)
plugin/config.ts – config parsing + UI hints
plugin/openclaw.plugin.json – manifest + JSON Schema (used for strict config validation)
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: joeykrug
- Version: 1.2.1
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/memory-lancedb-hybrid)
- [Send to Agent page](https://openagent3.xyz/skills/memory-lancedb-hybrid/agent)
- [JSON manifest](https://openagent3.xyz/skills/memory-lancedb-hybrid/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/memory-lancedb-hybrid/agent.md)
- [Download page](https://openagent3.xyz/downloads/memory-lancedb-hybrid)