# Send Ollama Memory Embeddings 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "ollama-memory-embeddings",
    "name": "Ollama Memory Embeddings",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/vidarbrekke/ollama-memory-embeddings",
    "canonicalUrl": "https://clawhub.ai/vidarbrekke/ollama-memory-embeddings",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/ollama-memory-embeddings",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ollama-memory-embeddings",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "LICENSE.md",
      "uninstall.sh",
      "install.sh",
      "verify.sh",
      "README.md",
      "watchdog.sh"
    ],
    "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/ollama-memory-embeddings"
    },
    "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/ollama-memory-embeddings",
    "downloadUrl": "https://openagent3.xyz/downloads/ollama-memory-embeddings",
    "agentUrl": "https://openagent3.xyz/skills/ollama-memory-embeddings/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ollama-memory-embeddings/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ollama-memory-embeddings/agent.md"
  }
}
```
## Documentation

### Ollama Memory Embeddings

This skill configures OpenClaw memory search to use Ollama as the embeddings
server via its OpenAI-compatible /v1/embeddings endpoint.

Embeddings only. This skill does not affect chat/completions routing —
it only changes how memory-search embedding vectors are generated.

### What it does

Installs this skill under ~/.openclaw/skills/ollama-memory-embeddings
Verifies Ollama is installed and reachable
Lets the user choose an embedding model:

embeddinggemma (default — closest to OpenClaw built-in)
nomic-embed-text (strong quality, efficient)
all-minilm (smallest/fastest)
mxbai-embed-large (highest quality, larger)


Optionally imports an existing local embedding GGUF into Ollama via
ollama create (currently detects embeddinggemma, nomic-embed, all-minilm,
and mxbai-embed GGUFs in known cache directories)
Normalizes model names (handles :latest tag automatically)
Updates agents.defaults.memorySearch in OpenClaw config (surgical — only
touches keys this skill owns):

provider = "openai"
model = <selected model>:latest
remote.baseUrl = "http://127.0.0.1:11434/v1/"
remote.apiKey = "ollama" (required by client, ignored by Ollama)


Performs a post-write config sanity check (reads back and validates JSON)
Optionally restarts the OpenClaw gateway (with detection of available
restart methods: openclaw gateway restart, systemd, launchd)
Optional memory reindex during install (openclaw memory index --force --verbose)
Runs a two-step verification:

Checks model exists in ollama list
Calls the embeddings endpoint and validates the response


Adds an idempotent drift-enforcement command (enforce.sh)
Adds optional config drift auto-healing watchdog (watchdog.sh)

### Install

bash ~/.openclaw/skills/ollama-memory-embeddings/install.sh

From this repository:

bash skills/ollama-memory-embeddings/install.sh

### Non-interactive usage

bash ~/.openclaw/skills/ollama-memory-embeddings/install.sh \\
  --non-interactive \\
  --model embeddinggemma \\
  --reindex-memory auto

Bulletproof setup (install watchdog):

bash ~/.openclaw/skills/ollama-memory-embeddings/install.sh \\
  --non-interactive \\
  --model embeddinggemma \\
  --reindex-memory auto \\
  --install-watchdog \\
  --watchdog-interval 60

Note: In non-interactive mode, --import-local-gguf auto is treated as
no (safe default). Use --import-local-gguf yes to explicitly opt in.

Options:

--model <id>: one of embeddinggemma, nomic-embed-text, all-minilm, mxbai-embed-large
--import-local-gguf <auto|yes|no>: default no (safer default; opt in with yes)
--import-model-name <name>: default embeddinggemma-local
--restart-gateway <yes|no>: default no (restart only when explicitly requested)
--skip-restart: deprecated alias for --restart-gateway no
--openclaw-config <path>: config file path override
--install-watchdog: install launchd drift auto-heal watchdog (macOS)
--watchdog-interval <sec>: watchdog interval (default 60)
--reindex-memory <auto|yes|no>: memory rebuild mode (default auto)
--dry-run: print planned changes and commands; make no modifications

### Verify

~/.openclaw/skills/ollama-memory-embeddings/verify.sh

Use --verbose to dump raw API response on failure:

~/.openclaw/skills/ollama-memory-embeddings/verify.sh --verbose

### Drift enforcement and auto-heal

Manually enforce desired state (safe to run repeatedly):

~/.openclaw/skills/ollama-memory-embeddings/enforce.sh \\
  --model embeddinggemma \\
  --openclaw-config ~/.openclaw/openclaw.json

Check for drift only:

~/.openclaw/skills/ollama-memory-embeddings/enforce.sh \\
  --check-only \\
  --model embeddinggemma

Run watchdog once (check + heal):

~/.openclaw/skills/ollama-memory-embeddings/watchdog.sh \\
  --once \\
  --model embeddinggemma

Install watchdog via launchd (macOS):

~/.openclaw/skills/ollama-memory-embeddings/watchdog.sh \\
  --install-launchd \\
  --model embeddinggemma \\
  --interval-sec 60

### GGUF detection scope

The installer searches for embedding GGUFs matching these patterns in known
cache directories (~/.node-llama-cpp/models, ~/.cache/node-llama-cpp/models,
~/.cache/openclaw/models):

*embeddinggemma*.gguf
*nomic-embed*.gguf
*all-minilm*.gguf
*mxbai-embed*.gguf

Other embedding GGUFs are not auto-detected. You can always import manually:

ollama create my-model -f /path/to/Modelfile

### Notes

This does not modify OpenClaw package code. It only updates user config.
A timestamped backup of config is written before changes.
If no local GGUF exists, install proceeds by pulling the selected model from Ollama.
Model names are normalized with :latest tag for consistent Ollama interaction.
If embedding model changes, rebuild/re-embed existing memory vectors to avoid
retrieval mismatch across incompatible vector spaces.
With --reindex-memory auto, installer reindexes only when the effective
embedding fingerprint changed (provider, model, baseUrl, apiKey presence).
Drift checks require a non-empty apiKey but do not require a literal "ollama" value.
Config backups are created only when a write is needed.
Legacy schema fallback is supported: if agents.defaults.memorySearch is absent,
the enforcer reads known legacy paths and mirrors writes to preserve compatibility.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: vidarbrekke
- Version: 1.0.4
## 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/ollama-memory-embeddings)
- [Send to Agent page](https://openagent3.xyz/skills/ollama-memory-embeddings/agent)
- [JSON manifest](https://openagent3.xyz/skills/ollama-memory-embeddings/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/ollama-memory-embeddings/agent.md)
- [Download page](https://openagent3.xyz/downloads/ollama-memory-embeddings)