OpenClaw mémoire QMD: Capture de la chute silencieuse

La réponse sûre est la suivante: Ne traitez pas une recherche de mémoire réussie OpenClaw comme une preuve que QMD est sain . Prouvez d'abord que la passerelle peut résoudre le binaire de QMD et que QMD ne sert pas la recherche. Appliquez ensuite les contrôles de préparation requis par le mode de recherche configuré, confirmez que l'index est frais et récupérez un canary synthétique. Cette distinction est importante parce que OpenClaw tombe délibérément sur son moteur de mémoire intégré si QMD échoue. Le fallback préserve un comportement de mémoire utile, mais il modifie le fait d'être testé. Un résultat peut être valide car OpenClaw a trouvé une mémoire alors qu'elle est invalide car l'arrière plan QMD configuré est prêt. La règle de fonctionnement du présent guide est la suivante: Le QMD n'est sain que lorsque la disponibilité exécutable, le backend efficace, la fraîcheur de mise à jour, la préparation spécifique au mode et la récupération des canaries sont d'accord. C'est plus étroit que de prouver qu'un agent se souvenait de la bonne chose dans chaque situation. Il s'agit d'un reçu de santé backend: preuve que le chemin de récupération prévu est disponible et suffisamment courant pour la prochaine étape dépendante de la mémoire. Une requête verte peut cacher le mauvais arrière plan La documentation QMD de OpenClaw décrit QMD comme un sidecar local first qui combine BM25, la recherche vectorielle et le réaffichage. OpenClaw crée des collections gérées, exécute des mises à jour et, lorsque les modes sémantiques en ont besoin, maintient des intégrations. Il est également documenté le retour automatique du moteur SQLite en construction lorsque QMD ne peut pas s'ouvrir. Le retrait est une fonctionnalité de disponibilité raisonnable. Ce n'est pas une preuve de QMD. Considérez deux séries qui récupèrent toutes les deux la même phrase synthétique: Observation Retour A Retour B L'arrière plan est configuré qmd qmd Query renvoie le canary Oui, c'est vrai. Oui, c'est vrai. Résultats efficaces qmd builtin Le verdict du QMD candidat en bonne santé actives en cas de chute Le texte retourné ne peut pas distinguer ces courbes. L'identité de l'arrière plan doit avoir une priorité plus élevée que le succès de la récupération. Commencez par l'environnement qui lance la passerelle. Une coquille interactive peut avoir un PATH différent d'un service: La première commande doit résoudre un exécutable. Le second enregistre une version. Le troisième demande à OpenClaw de vérifier l'état de la mémoire plutôt que de faire confiance à une défaillance de mise en cache de chat. Si qmd version ne fonctionne que dans votre coque de connexion, les instructions officielles de dépannage recommandent de fixer un memory.qmd.command absolu et de vérifier à partir de l'environnement de la passerelle. N'enregistrez pas l'ensemble de l'environnement de service pour le prouver. Un reçu utile ne nécessite que: La version ci dessus est un exemple de l'instantané de recherche actuelle, pas une exigence minimale. La dernière version de QMD GitHub observée pour cet article était v2.5.3, publiée le 29 mai 2026. OpenClaw maintient des chemins de compatibilité pour les anciennes formes de collecte QMD et MCP, donc not latest n'est pas automatiquement unhealthy. Enregistrer la version parce que la compatibilité, le diagnostic et les champs de sortie changent. Sur le coureur de publication utilisé pour cet article, OpenClaw 2026.7.1 2 a été installé et son entrepôt de mémoire intégré configuré a été rapporté prêt, tandis que qmd version a renvoyé command not found . Ce n'était pas un test d'arrêt de QMD. Le coureur n'était pas configuré comme un déploiement de QMD. Il s'agissait d'une observation utile des limites: une bonne commande de mémoire OpenClaw et la disponibilité de QMD sont des faits distincts. La préparation dépend de searchMode QMD dispose de trois modes de recherche pertinents dans le contrat OpenClaw en cours: Le search est le BM25 lexique. vsearch utilise des preuves vectorielles. Le query utilise la voie hybride/modèle et peut inclure une réévaluation. Le référence de configuration de mémoire indique explicitement que le search est uniquement BM25. OpenClaw saute les sondes sémantiques de préparation vectorielle et intègre la maintenance dans ce mode. Par conséquent, une règle générale telle que les embellissements en attente signifie que la mémoire est malsaine. Utilisez cette passerelle de mode: Mode de recherche Récolte fraîche requise Zéro intégrations en attente requises Les canaries sont requises search Oui, c'est vrai. Il n'y en a pas. Oui, c'est vrai. vsearch Oui, c'est vrai. Oui, c'est vrai. Oui, c'est vrai. query Oui, c'est vrai. Oui, c'est vrai. Oui, c'est vrai. Ce n'est pas un argument pour la recherche léxicale sur la recherche sémantique. Il empêche un contrôleur de santé d'imposer une dépendance que le mode sélectionné n'utilise pas. L'intervalle documenté de mise à jour par défaut de QMD de OpenClaw est de cinq minutes, tandis que l'intervalle d'intégration est par défaut de soixante minutes. Ces valeurs décrivent la planification, et non un seuil de santé universel. Construisez un bail de fraîcheur à partir de votre configuration et de votre tolérance opérationnelle: Par exemple, un intervalle de cinq minutes, une mise à jour normale pire de quatre vingt dix deux secondes, et une marge de trente deux secondes donne un bail de sept minutes. Une période de mise à jour de 421 secondes est obsolète dans le cadre de cette politique; 419 secondes sont encore dans le contrat de location. Ne prolongez pas silencieusement le bail après une alerte. Si les mises à jour le dépassent régulièrement, fixez la charge de travail ou révisez la politique avec des preuves enregistrées. Dans le cas contraire, un indice obsolète devient vert. La première requête sémantique peut être inhabituellement lente car QMD peut télécharger environ 2 Go de modèles GGUF pour l'expansion et le réaffichage de la requête. Cela rend l'attente de la dépendance documentée de la première sortie différente de la dépendance de la première sortie. Construire un canary qui prouve le chemin géré Un canary doit être synthétique, unique et sûr à conserver. Il ne doit pas contenir un fait client, un prompt, une clé API, une adresse e mail ou une décision de tâche réelle. Créez un fichier Markdown sous une collection que OpenClaw gère réellementpour la collection d'espace de travail par défaut, c'est à dire MEMORY.md ou l'arbre memory/ . Utilisez un jeton tel que: Enregistrez son chemin source relatif et son hachage de contenu, laissez le cycle de mise à jour configuré se terminer, puis recherchez le jeton exact via OpenClaw: Le reçu doit indiquer: 1. le fichier source appartient à la collecte gérée prévue; 2. la dernière mise à jour réussie se fait dans le cadre du bail de fraîcheur; 3. les vecteurs sémantiques sont prêts si le mode en a besoin; 4. le backend effectif est QMD; 5. le canary exact est retourné de la source attendue. Un résultat vide ne prouve pas immédiatement que QMD est cassé. Le contrat officiel énumère plusieurs explications plus restreintes: les chemins cachés sont ignorés, la racine minuscule memory.md n'est pas la même que MEMORY.md , l'étendue du groupe/canal est refusée par défaut, et les schémas de chemin supplémentaires peuvent exclure un fichier. Gardez ces distinctions afin que la réparation reste limitée. Évitez d'invoquer manuellement qmd update avec des annuaires XDG arbitraires. OpenClaw donne à chaque agent une maison QMD gérée et autonome. Un commandement direct dans le mauvais environnement peut tester un indice différent et produire un résultat vert convaincant mais irréel. De même, n'utilisez pas un canary qui réussit pour prétendre à une grande qualité de rappel. Le canary prouve qu'un document connu a traversé la voie actuelle d'ingestion et de récupération. Un indice de référence de rappel représentatif, le test de continuité de décision et la vérification des résultats en aval restent séparés. Répétez le verdict avant de télécharger une alerte. L'artefact créé pour cet article accepte un reçu JSON normalisé et renvoie un état. Il a une priorité intentionnelle: 1. config drift 2. qmd unavailable 3. fallback active 4. stale index 5. vector not ready 6. retrieval failed 7. healthy Voici la décision fondamentale: La répétition de six cas a produit six verdicts attendus: Le cas de l'accusé Des preuves importantes Le verdict BM25 avec 27 intégrations en attente mode est search , canary trouvé healthy QMD binary manquant commande non résolue qmd unavailable Canary trouvé à travers la bouiltin l'arrière plan efficace est construit fallback active 721 ans de collecte, 420 ans de location mise à jour périmée stale index Mode requête avec 14 intégrations en attente vecteurs incomplets vector not ready Mode vectoriel frais, pas de canaries absence de récupération retrieval failed Cette répétition ajoute deux commandes utiles. Tout d'abord, le builtin fallback ne peut pas emprunter un résultat vert de la couche de récupération. Deuxièmement, la recherche BM25 n'hérite pas une fausse dépendance à l'entretien vectoriel. Chaque état malsain obtient une action suivante: QMD indisponible: résoudre le binaire à partir de l'environnement de la passerelle et de la sonde à nouveau. Fallback active: inspectez la défaillance ouverte de QMD; ne désactivez pas la rétroaction juste pour rendre le contrôleur rouge. Stale index: attendre ou exécuter le chemin de mise à jour géré, puis vérifier un nouveau temps de succès. Vecteurs non prêts: finition intégration pour le modèle actif et vérifier la cohérence des empreintes digitales avec les diagnostics QMD actuels. Retrieval a échoué: inspectez la portée de la collecte, le schéma de fichier, les preuves de mise à jour et le jeton exact avant de reconstruire quoi que ce soit. Reconstruire chaque index n'est pas la réparation par défaut. Il augmente le coût et détruit les preuves qui pourraient distinguer une erreur de chemin d'une erreur de fraîcheur. Expirer le reçu et garder la conclusion étroite Un reçu sain est limité dans le temps. Conservez le temps de vérification, le mode configuré, la version QMD, le backend effectif, la dernière mise à jour réussie, le nombre de vecteurs en attente, le cas échéant, le hash de source canarien et le verdict. Il expire lorsque le bail de fraîcheur prend fin ou que l'une de ces entrées change. Le reçu prouve: l'exécutable QMD prévu était accessible; OpenClaw utilisait le QMD au moment du contrôle; l'indice géré était suffisamment frais; les dépendances du mode sélectionné étaient prêtes; un élément sûr connu était récupérable. Il prouve Znot que chaque mémoire est pertinente, que chaque décision a survécu à la compression, que les données privées sont correctement classées ou qu'un agent a produit le produit de livraison prévu. Ils ont besoin de preuves séparées. L'orientation du produit de Sidewisp est de rendre les limites de santé comme celles ci visibles à travers les délais d'exécution des agents: identifier ce qui fonctionne, exposer les preuves, distinguer l'attente de l'échec et préserver l'autorité humaine sur les réparations. Sidewisp est actuellement en préversion privée. L'adaptateur et le moteur de surveillance OpenClaw de production ne sont généralement pas expédiés, donc ce guide est un modèle de fonctionnement que vous pouvez mettre en œuvre aujourd'huinon une affirmation selon laquelle Sidewisp effectue déjà ces contrôles de QMD. Si une tâche dépendante de la mémoire est importante, demandez le reçu avant le début de la tâche et vérifiez le résultat réel de la tâche par la suite. Ce qui comble les deux faux verts: mémoire fonctionnait sans QMD, et QMD fonctionnait sans que le travail soit fait.