📦 Ollama Memory Setup — Ollama 内存设置

Ollama 内存设置 使用此技能使 OpenClaw 的 memory_search 在本地使用 Ollama 嵌入代替易碎的原生 node-llama-cpp 构建或付费的托管嵌入 API 工作。 什么是成功的设置 正确的设置包括以下所有内容：

• Ollama 已安装并可以在 http://localhost:11434 访问
• 嵌入模型已拉取，通常为 nomic-embed-text
• OpenClaw 配置显式设置 agents.defaults.memorySearch.provider 为 ollama
• 内存索引在配置更改后重建
• memory_search("...") 或 openclaw memory search "..." 返回提供者 ollama 的结果

快速路径 首先使用捆绑的诊断脚本：bash scripts/check-ollama-memory.sh 要安装/拉取模型并打印/应用 OpenClaw 配置命令：bash scripts/check-ollama-memory.sh --install --apply-config openclaw 网关重启 openclaw 内存索引 --force openclaw 内存状态 --deep 如果在具有第一类配置工具的代理中运行，请使用这些工具进行配置更改，而不是手动编辑 JSON。 工作流程

• 在更改任何内容之前进行预检

检查：

• command -v ollama
• curl -s http://localhost:11434/api/tags
• ollama 列表 | grep -E 'nomic-embed-text|qwen.*embedding'
• openclaw 内存状态 --deep

如果 Ollama 可达且模型存在，则跳过安装并转到配置验证。

• 安装或启动 Ollama

macOS：brew install ollama brew services start ollama Linux：curl -fsSL https://ollama.com/install.sh | sh ollama serve 不要直接将 Ollama 暴露在公共互联网上。将其保持在 localhost、VPN 或私有 LAN 上。

• 拉取嵌入模型

默认：ollama pull nomic-embed-text 使用 nomic-embed-text 进行最低摩擦度的设置。仅当 OpenClaw/Ollama 支持另一个嵌入模型且用户有理由时才使用它。

• 配置 OpenClaw 内存搜索

设置以下内容： agents.defaults.memorySearch： { "enabled": true, "provider": "ollama", "model": "nomic-embed-text", "remote": { "baseUrl": "http://localhost:11434" } } CLI 批处理形式： openclaw config set --batch-json '[ {"path":"agents.defaults.memorySearch.enabled","value":true}, {"path":"agents.defaults.memorySearch.provider","value":"ollama"}, {"path":"agents.defaults.memorySearch.model","value":"nomic-embed-text"}, {"path":"agents.defaults.memorySearch.remote.baseUrl","value":"http://localhost:11434"} ]' --strict-json 然后重启网关：openclaw 网关重启

• 重新索引和验证

openclaw 内存索引 --force openclaw 内存状态 --deep openclaw 内存搜索 "项目决策" --max-results 5 在代理中的验证：memory_search("来自 MEMORY.md 的已知主题") 预期结果：提供者是 ollama，搜索未禁用，结果在语义上相关。 何时阅读故障排除 当以下情况发生时，请阅读 references/troubleshooting.md：

• memory_search 仍然显示为禁用
• Ollama 已安装但不可达
• 模型已拉取但 OpenClaw 仍然使用其他提供者
• 索引速度慢或没有返回有用的结果
• 配置命令失败或安装的 OpenClaw CLI 比配置文件旧

安全规则

• 永远不要将秘密粘贴到 openclaw.json 中以进行此设置。
• Ollama 本地嵌入不需要真实的 API 密钥。
• 除非用户了解网络/安全风险，否则不要将 Ollama 绑定到 0.0.0.0。
• 不要删除现有的内存文件以“修复”搜索。
• 重新索引。
• 在进行真正的 memory_search/openclaw 内存搜索验证之前，不要承诺语义质量。