How should openclaw-embeddings-fix be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this skill.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

Crawler Summary

openclaw-embeddings-fix answer-first brief

本地 Embeddings 記憶搜索修復 Skill 本地 Embeddings 記憶搜索修復 Skill 概述本 Skill 用於修復和配置 OpenClaw 的本地_embeddings 智能搜索功能。當遇到記憶搜索問題或需要重新配置時，可以使用本 Skill。功能 - 診斷記憶搜索問題 - 配置本地 embeddings 模型 - 修復索引問題 - 測試搜索功能使用場景 - 記憶搜索返回空結果 - 想要啟用本地 embeddings（不需要 OpenAI API key） - 索引損壞需要重新索引 - 遷移或升級後需要重新配置前置條件 - OpenClaw 已安裝 - Node.js 環境 - 網絡連接（下載本地模型需要）使用方法方式一：手動執行修復方式二：使用工具調用參數說明 action 參數 - diagnose: 診斷當前狀態，報告問題 - fix: 自動修復已知問題 - reindex: 重新索引所有記憶文件 - test: 測試搜索功能，可選指定搜 Capability contract not published. No trust telemetry is available yet. Last updated 4/14/2026.

Freshness

Last checked 4/14/2026

Best For

openclaw-embeddings-fix is best for general automation workflows where OpenClaw compatibility matters.

Not Ideal For

Contract metadata is missing or unavailable for deterministic execution.

Evidence Sources Checked

editorial-content, GITHUB OPENCLEW, runtime-metrics, public facts pack

Card Facts Snapshot Contract Trust

Claim this agent

Agent DossierGitHubSafety: 94/100

openclaw-embeddings-fix

OpenClawself-declared

Public facts

Change events

Artifacts

Freshness

Apr 14, 2026

Verifiededitorial-contentNo verified compatibility signals

Capability contract not published. No trust telemetry is available yet. Last updated 4/14/2026.

Trust evidence available

Trust score

Unknown

Compatibility

OpenClaw

Freshness

Apr 14, 2026

Vendor

18gogogo

Artifacts

Benchmarks

Last release

Unpublished

Executive Summary

Key links, install path, and a quick operational read before the deeper crawl record.

Verifiededitorial-content

Summary

Capability contract not published. No trust telemetry is available yet. Last updated 4/14/2026.

View Source

Setup snapshot

git clone https://github.com/18gogogo/openclaw-embeddings-fix.git

1
Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
2
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Evidence Ledger

Everything public we have scraped or crawled about this agent, grouped by evidence type with provenance.

Verifiededitorial-content

Vendor (1)

Vendor

18gogogo

profilemedium

Observed Apr 14, 2026Source link Provenance

Compatibility (1)

Protocol compatibility

OpenClaw

contractmedium

Observed Apr 14, 2026Source link Provenance

Security (1)

Handshake status

UNKNOWN

trustmedium

Observed unknownSource link Provenance

Integration (1)

Crawlable docs

6 indexed pages on the official domain

search_documentmedium

Observed Apr 15, 2026Source link Provenance

Release & Crawl Timeline

Merged public release, docs, artifact, benchmark, pricing, and trust refresh events.

Self-declaredagent-index

Docs Update

Docs refreshed: Sign in to GitHub · GitHub

search_documentmedium

Fresh crawlable documentation was indexed for the official domain.

Observed Apr 15, 2026

Artifacts Archive

Extracted files, examples, snippets, parameters, dependencies, permissions, and artifact metadata.

Self-declaredGITHUB OPENCLEW

Extracted files

Examples

Snippets

Languages

typescript

Parameters

Executable Examples

bash

# 1. 檢查當前狀態
openclaw memory status

# 2. 如果有問題，執行修復腳本
bash ~/.openclaw/skills/embeddings-fix/scripts/fix.sh

# 3. 重新索引
openclaw memory index

# 4. 驗證
openclaw memory status

text

工具: embeddings_fix
參數: {"action": "diagnose" | "fix" | "reindex" | "test", "query": "可選搜索詞"}

json

{
  "tool": "embeddings_fix",
  "arguments": {
    "action": "diagnose"
  }
}

json

{
  "tool": "embeddings_fix",
  "arguments": {
    "action": "fix"
  }
}

json

{
  "tool": "embeddings_fix",
  "arguments": {
    "action": "test",
    "query": "測試"
  }
}

json

{
  "tool": "embeddings_fix",
  "arguments": {
    "action": "reindex"
  }
}

Docs & README

Full documentation captured from public sources, including the complete README when available.

Self-declaredGITHUB OPENCLEW

Docs source

GITHUB OPENCLEW

Editorial quality

ready

Full README

本地 Embeddings 記憶搜索修復 Skill

概述

本 Skill 用於修復和配置 OpenClaw 的本地_embeddings 智能搜索功能。當遇到記憶搜索問題或需要重新配置時，可以使用本 Skill。

功能

診斷記憶搜索問題
配置本地 embeddings 模型
修復索引問題
測試搜索功能

使用場景

記憶搜索返回空結果
想要啟用本地 embeddings（不需要 OpenAI API key）
索引損壞需要重新索引
遷移或升級後需要重新配置

前置條件

OpenClaw 已安裝
Node.js 環境
網絡連接（下載本地模型需要）

使用方法

方式一：手動執行修復

# 1. 檢查當前狀態
openclaw memory status

# 2. 如果有問題，執行修復腳本
bash ~/.openclaw/skills/embeddings-fix/scripts/fix.sh

# 3. 重新索引
openclaw memory index

# 4. 驗證
openclaw memory status

方式二：使用工具調用

工具: embeddings_fix
參數: {"action": "diagnose" | "fix" | "reindex" | "test", "query": "可選搜索詞"}

參數說明

action 參數

diagnose: 診斷當前狀態，報告問題
fix: 自動修復已知問題
reindex: 重新索引所有記憶文件
test: 測試搜索功能，可選指定搜索詞

query 參數

可選的搜索詞，用於測試搜索功能
示例: "測試" 或 "embeddings"

範例

範例 1：診斷問題

{
  "tool": "embeddings_fix",
  "arguments": {
    "action": "diagnose"
  }
}

範例 2：執行修復

{
  "tool": "embeddings_fix",
  "arguments": {
    "action": "fix"
  }
}

範例 3：測試搜索

{
  "tool": "embeddings_fix",
  "arguments": {
    "action": "test",
    "query": "測試"
  }
}

範例 4：完整修復流程

{
  "tool": "embeddings_fix",
  "arguments": {
    "action": "reindex"
  }
}

修復腳本內容 (fix.sh)

腳本會執行以下操作：

#!/bin/bash

echo "=== 本地 Embeddings 修復腳本 ==="

# 1. 檢查目錄結構
echo "1. 檢查目錄結構..."
mkdir -p ~/.openclaw/workspace/memory/

# 2. 複製記憶文件
echo "2. 複製記憶文件..."
cp ~/.openclaw/memory/*.md ~/.openclaw/workspace/memory/ 2>/dev/null || true

# 3. 重新索引
echo "3. 重新索引..."
openclaw memory index

# 4. 驗證
echo "4. 驗證狀態..."
openclaw memory status

echo "=== 修復完成 ==="

配置說明

openclaw.json 配置

本 Skill 需要以下配置（通常已預設）：

{
  "agents": {
    "defaults": {
      "memorySearch": {
        "enabled": true,
        "provider": "local",
        "local": {
          "modelPath": "hf:ggml-org/embeddinggemma-300M-GGUF/embeddinggemma-300M-Q8_0.gguf",
          "modelCacheDir": "~/.openclaw/models"
        }
      }
    }
  }
}

模型信息

名稱: embeddinggemma-300M-Q8_0.gguf
大小: 314 MB
維度: 768
來源: HuggingFace (ggml-org)
自動下載: 是（首次使用時）

輸出說明

診斷輸出

Provider: 當前使用的 embeddings provider（應為 local）
Model: 使用的模型名稱
Indexed: 已索引的文件數
Vector dims: 向量維度（應為 768）
Issues: 發現的問題

修復輸出

Status: 修復後的狀態
Indexed files: 索引的文件數
Chunks: 索引的塊數

故障排除

問題 1：索引顯示 0/0 files

原因: 記憶文件不在正確目錄解決:

mkdir -p ~/.openclaw/workspace/memory/
cp ~/.openclaw/memory/*.md ~/.openclaw/workspace/memory/
openclaw memory index

問題 2：Provider 不是 local

原因: 配置未正確設置解決: 檢查 openclaw.json 中的 memorySearch 配置

問題 3：模型下載失敗

原因: 網絡連接問題解決:

檢查網絡連接
手動下載模型：

mkdir -p ~/.openclaw/models/embeddings/
cd ~/.openclaw/models/embeddings/
curl -L -o embeddinggemma-300M-Q8_0.gguf \
  "https://huggingface.co/ggml-org/embeddinggemma-300M-GGUF/resolve/main/embeddinggemma-300M-Q8_0.gguf"

問題 4：搜索返回空結果

原因: 索引損壞或文件未被索引解決:

openclaw memory index
openclaw memory status

重要提醒

目錄結構

記憶文件: ~/.openclaw/workspace/memory/
模型緩存: ~/.openclaw/models/embeddings/
配置文件: ~/.openclaw/openclaw.json

權限要求

需要能夠讀寫 ~/.openclaw/ 目錄
需要執行 openclaw 命令

與 Qwen 模型的兼容性

本 Skill 已針對 Qwen 系列模型優化：

✅ qwen2.5:14b-instruct-q8_0-ctx131072
✅ qwen2.5:32b-instruct-q4_1-ctx64k
✅ qwen-coder-64k:latest

所有指令和參數都使用簡單的中文描述，方便模型理解和執行。

版本信息

版本: 1.0.0
創建日期: 2026-02-09
作者: OpenClaw System
兼容性: OpenClaw 2026.2.3+

Contract & API

Machine endpoints, protocol fit, contract coverage, invocation examples, and guardrails for agent-to-agent use.

MissingGITHUB OPENCLEW

Endpoints

Dossier API Snapshot API Contract API Trust API

Contract coverage

Status

missing

Auth

None

Streaming

Data region

Unspecified

Protocol support

OpenClaw: self-declared

Requires: none

Forbidden: none

Guardrails

Operational confidence: low

No positive guardrails captured.

Invocation examples

curl -s "https://xpersona.co/api/v1/agents/18gogogo-openclaw-embeddings-fix/snapshot"

curl -s "https://xpersona.co/api/v1/agents/18gogogo-openclaw-embeddings-fix/contract"

curl -s "https://xpersona.co/api/v1/agents/18gogogo-openclaw-embeddings-fix/trust"

Reliability & Benchmarks

Trust and runtime signals, benchmark suites, failure patterns, and practical risk constraints.

Missingruntime-metrics

Trust signals

Handshake

UNKNOWN

Confidence

unknown

Attempts 30d

unknown

Fallback rate

unknown

Runtime metrics

Observed P50

unknown

Observed P95

unknown

Rate limit

unknown

Estimated cost

unknown

Do not use if

Contract metadata is missing or unavailable for deterministic execution.

No benchmark suites or observed failure patterns are available.

Media & Demo

Every public screenshot, visual asset, demo link, and owner-provided destination tied to this agent.

Missingno-media

No screenshots, media assets, or demo links are available.

Related Agents

Neighboring agents from the same protocol and source ecosystem for comparison and shortlist building.

Self-declaredprotocol-neighbors

GITHUB_REPOSactivepieces

Rank

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

Traction

No public download signal

Freshness

Updated 2d ago

OPENCLAW

GITHUB_REPOScherry-studio

Rank

AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs

Traction

No public download signal

Freshness

Updated 5d ago

MCPOPENCLAW

GITHUB_REPOSAionUi

Rank

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

Traction

No public download signal

Freshness

Updated 6d ago

MCPOPENCLAW

GITHUB_REPOSCopilotKit

Rank

The Frontend for Agents & Generative UI. React + Angular

Traction

No public download signal

Freshness

Updated 23d ago

OPENCLAW

Machine Appendix

Contract JSON

{
  "contractStatus": "missing",
  "authModes": [],
  "requires": [],
  "forbidden": [],
  "supportsMcp": false,
  "supportsA2a": false,
  "supportsStreaming": false,
  "inputSchemaRef": null,
  "outputSchemaRef": null,
  "dataRegion": null,
  "contractUpdatedAt": null,
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Invocation Guide

{
  "preferredApi": {
    "snapshotUrl": "https://xpersona.co/api/v1/agents/18gogogo-openclaw-embeddings-fix/snapshot",
    "contractUrl": "https://xpersona.co/api/v1/agents/18gogogo-openclaw-embeddings-fix/contract",
    "trustUrl": "https://xpersona.co/api/v1/agents/18gogogo-openclaw-embeddings-fix/trust"
  },
  "curlExamples": [
    "curl -s \"https://xpersona.co/api/v1/agents/18gogogo-openclaw-embeddings-fix/snapshot\"",
    "curl -s \"https://xpersona.co/api/v1/agents/18gogogo-openclaw-embeddings-fix/contract\"",
    "curl -s \"https://xpersona.co/api/v1/agents/18gogogo-openclaw-embeddings-fix/trust\""
  ],
  "jsonRequestTemplate": {
    "query": "summarize this repo",
    "constraints": {
      "maxLatencyMs": 2000,
      "protocolPreference": [
        "OPENCLEW"
      ]
    }
  },
  "jsonResponseTemplate": {
    "ok": true,
    "result": {
      "summary": "...",
      "confidence": 0.9
    },
    "meta": {
      "source": "GITHUB_OPENCLEW",
      "generatedAt": "2026-04-16T23:45:24.061Z"
    }
  },
  "retryPolicy": {
    "maxAttempts": 3,
    "backoffMs": [
      500,
      1500,
      3500
    ],
    "retryableConditions": [
      "HTTP_429",
      "HTTP_503",
      "NETWORK_TIMEOUT"
    ]
  }
}

Trust JSON

{
  "status": "unavailable",
  "handshakeStatus": "UNKNOWN",
  "verificationFreshnessHours": null,
  "reputationScore": null,
  "p95LatencyMs": null,
  "successRate30d": null,
  "fallbackRate": null,
  "attempts30d": null,
  "trustUpdatedAt": null,
  "trustConfidence": "unknown",
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Capability Matrix

{
  "rows": [
    {
      "key": "OPENCLEW",
      "type": "protocol",
      "support": "unknown",
      "confidenceSource": "profile",
      "notes": "Listed on profile"
    }
  ],
  "flattenedTokens": "protocol:OPENCLEW|unknown|profile"
}

Facts JSON

[
  {
    "factKey": "docs_crawl",
    "category": "integration",
    "label": "Crawlable docs",
    "value": "6 indexed pages on the official domain",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  },
  {
    "factKey": "vendor",
    "category": "vendor",
    "label": "Vendor",
    "value": "18gogogo",
    "href": "https://github.com/18gogogo/openclaw-embeddings-fix",
    "sourceUrl": "https://github.com/18gogogo/openclaw-embeddings-fix",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-04-14T22:23:23.204Z",
    "isPublic": true
  },
  {
    "factKey": "protocols",
    "category": "compatibility",
    "label": "Protocol compatibility",
    "value": "OpenClaw",
    "href": "https://xpersona.co/api/v1/agents/18gogogo-openclaw-embeddings-fix/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/18gogogo-openclaw-embeddings-fix/contract",
    "sourceType": "contract",
    "confidence": "medium",
    "observedAt": "2026-04-14T22:23:23.204Z",
    "isPublic": true
  },
  {
    "factKey": "handshake_status",
    "category": "security",
    "label": "Handshake status",
    "value": "UNKNOWN",
    "href": "https://xpersona.co/api/v1/agents/18gogogo-openclaw-embeddings-fix/trust",
    "sourceUrl": "https://xpersona.co/api/v1/agents/18gogogo-openclaw-embeddings-fix/trust",
    "sourceType": "trust",
    "confidence": "medium",
    "observedAt": null,
    "isPublic": true
  }
]

Change Events JSON

[
  {
    "eventType": "docs_update",
    "title": "Docs refreshed: Sign in to GitHub · GitHub",
    "description": "Fresh crawlable documentation was indexed for the official domain.",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  }
]

openclaw-embeddings-fix answer-first brief

Executive Summary

Evidence Ledger

Release & Crawl Timeline

Artifacts Archive

Docs & README

本地 Embeddings 記憶搜索修復 Skill

概述

功能

使用場景

前置條件

使用方法

方式一：手動執行修復

方式二：使用工具調用

參數說明

action 參數

query 參數

範例

範例 1：診斷問題

範例 2：執行修復

範例 3：測試搜索

範例 4：完整修復流程

修復腳本內容 (fix.sh)

配置說明

openclaw.json 配置

模型信息

輸出說明

診斷輸出

修復輸出

故障排除

問題 1：索引顯示 0/0 files

問題 2：Provider 不是 local

問題 3：模型下載失敗

問題 4：搜索返回空結果

重要提醒

目錄結構

權限要求

與 Qwen 模型的兼容性

相關資源

版本信息

Contract & API

Reliability & Benchmarks

Media & Demo

Related Agents