🐛 Bug Report — OpenClaw memory_search index metadata is missing

Date : 2026-06-09
Rédactrice : Mami-Nora (via Nóra CEO)
Sévérité : P0 — Tous les agents aveugles (memory_search vectoriel HS depuis le 2 juin)
Versions affectées : v2026.6.1, v2026.6.5

Symptôme

memory_search (API runtime) → "index metadata is missing"
Vector search: paused until memory is rebuilt

Les agents ne peuvent pas faire de recherche sémantique. Seul le full-text search (FTS) fonctionne.

Configuration

// agents.defaults.memorySearch
{
  "provider": "openai-compatible",
  "model": "openai/text-embedding-3-large"
}

// models.providers["openai-compatible"]
{
  "baseUrl": "https://openrouter.ai/api/v1",
  "apiKey": "${OPENROUTER_API_KEY}",
  "models": [
    {
      "id": "openai/text-embedding-3-large",
      "contextWindow": 8191
    }
  ]
}

La clé OpenRouter est valide (200 OK sur les appels d'embedding).

Reproduction (100% fiable)

Étape 1 — Rebuild CLI

openclaw memory status --index --agent nora
openclaw memory index --agent nora --force

Résultat :

Memory index complete.
Provider: openai-compatible (requested: openai-compatible)
Dirty: no
Embeddings: ready
Vector dims: 3072
Memory index updated (nora).

Étape 2 — Vérification CLI

openclaw memory status

Résultat :

Memory Search (nora)
Provider: openai-compatible (requested: openai-compatible)
Model: openai/text-embedding-3-large
Indexed: 7/7 files · 11 chunks
Dirty: yes
Index identity: index metadata is missing
Vector search: paused until memory is rebuilt

Étape 3 — API runtime

L'appel memory_search depuis une session d'agent retourne la même erreur index metadata is missing.

Ce qui a été tenté (6 tentatives, 0 succès)

Tentatives additionnelles : --force, --index, wipe partiel, rebuild sans restart, rebuild avec restart.

Hypothèse

memory status (sans --index) corrompt ou invalide le metadata de l'index SQLite. Le Gateway utilise le même chemin de validation pour les appels API memory_search → l'index est systématiquement invalidé.

Le CLI memory status --index répare l'index, mais le prochain memory status (ou appel API) le recasse.

Impact

• 24 agents ne peuvent pas utiliser memory_search vectoriel
• Seul le FTS (full-text search) fonctionne
• Perte de contexte : les agents ne peuvent pas chercher dans les transcriptions de sessions passées
• Depuis le 2 juin 2026

Fichiers concernés

• openclaw.json : agents.defaults.memorySearch + models.providers["openai-compatible"]
• /home/node/.openclaw/memory/*.sqlite : index par agent
• Image Docker : ghcr.io/openclaw/openclaw:2026.6.5

Demande au support OpenClaw

1. Confirmer si memory status invalide l'index par design ou s'il s'agit d'un bug
2. Fournir la procédure correcte pour un rebuild d'index vectoriel avec openai-compatible + endpoint OpenRouter
3. Si bug confirmé, estimer un délai de correctif