Système de mémoire à embedding locale pour OpenClaw (Windows) pour Openclaw

Un système de recherche sémantique et d'embedding local sécurisé et axé sur le fonctionnement hors ligne, conçu pour fournir une mémoire contextuelle profonde pour les Skills Openclaw sous Windows.

paudyyin
v2.0.0
Jun 8, 2026
0
583
0

Installer & Télécharger

1. ClawHub CLI

Le moyen le plus rapide d'installer une compétence directement depuis le registre.

npx clawhub@latest install node-llama-cpp-install-guide

2. Installation manuelle

Copiez le dossier de la compétence dans l'un de ces emplacements

Global
~/.openclaw/skills/
Espace de travail
<project>/skills/

Priorité : Espace de travail > Local > Intégré

3. Installation du prompt

Copiez ce prompt dans OpenClaw pour l'installer automatiquement.

Aide-moi à installer node-llama-cpp-install-guide via Clawhub. Si Clawhub n'est pas installé, installe-le d'abord (npm i -g clawhub).

Vous préférez télécharger ?

Obtenez les fichiers bruts de la compétence dans une archive ZIP.

Qu'est-ce que Système de mémoire à embedding locale pour OpenClaw (Windows) ?

Le Local Embedding Memory System est une suite d'amélioration de la mémoire hautement optimisée et capable de fonctionner hors ligne, conçue pour tourner de manière transparente sur Windows. En exploitant des modèles d'embedding locaux légers, tels que nomic-embed-text-v1.5 au format GGUF (~80 Mo), ce système permet des capacités avancées de recherche sémantique pour les agents IA sans dépendre d'API cloud externes. Il constitue une base de performance cruciale pour les Skills Openclaw, permettant aux bases de données vectorielles locales de mettre en cache, d'indexer et de récupérer instantanément le contexte historique.

Outre l'exécution locale, ce système résout les contraintes typiques des entreprises, telles que les pare-feux d'entreprise et les configurations strictes de proxy, en utilisant des hôtes miroirs fiables (comme hf-mirror) et en prenant en charge des verrous de configuration à plusieurs niveaux pour éviter que les paramètres d'exécution ne soient écrasés lors des redémarrages de la passerelle. Il intègre également une visualisation de projection 2D optionnelle et esthétique, utilisant UMAP et sentence-transformers, transformant les vecteurs de mémoire bruts en cartes sémantiques interactives et exploitables.

Cas d'utilisation de Système de mémoire à embedding locale pour OpenClaw (Windows)

  • Rétention de contexte d'agent hors ligne : Exécution de recherche sémantique sécurisée et performante pour les agents IA dans des environnements intranet ou isolés (air-gapped).
  • Conformité à la sécurité d'entreprise : Garantie que les données propriétaires utilisées comme mémoire d'agent ne quittent jamais le réseau local ou l'hôte Windows.
  • Visualisation interactive de la mémoire : Génération de cartes HTML 2D interactives des mémoires d'agent à l'aide de Nomic Atlas pour déboguer les modèles de stockage et de récupération de la mémoire.
  • Pipelines IA sécurisés pour intranet : Contournement des pare-feux stricts en utilisant des modèles GGUF locaux ou des proxies d'API distants approuvés par l'entreprise pour les embeddings.

Comment fonctionne Système de mémoire à embedding locale pour OpenClaw (Windows)

  1. Ingestion de modèle local : Le système télécharge et met en cache un modèle de représentation vectorielle locale hautement quantifié (nomic-embed-text-v1.5) via des miroirs robustes dans le répertoire local de l'utilisateur.
  2. Ancrage de configuration : La configuration de la mémoire est écrite et verrouillée sur trois niveaux (préréglages PRD, variables d'environnement système et fichiers de liste blanche) pour garantir des paramètres persistants après redémarrage.
  3. Activation de plugin : Le plugin memory-tencentdb (v0.3.8+) est installé pour coordonner la génération de vecteurs et les routines de recherche en texte intégral (FTS).
  4. Récupération contextuelle : Lors de l'exécution des Skills Openclaw, l'agent interroge la mémoire vectorielle, générant des résultats de recherche sémantique de haute précision.
  5. Réduction de dimensionnalité et visualisation (optionnel) : En utilisant Python (sentence-transformers & UMAP), les vecteurs d'embedding de haute dimension sont réduits en coordonnées 2D et tracés sur un canvas HTML interactif pour débogage.

Configuration de Système de mémoire à embedding locale pour OpenClaw (Windows)

Étape 1 : Télécharger le modèle d'embedding GGUF local

Exécutez la commande PowerShell suivante pour créer le répertoire et récupérer le modèle nomic-embed-text d'environ 80 Mo depuis un hôte miroir rapide :

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.openclaw\models"
Invoke-WebRequest -Uri "https://hf-mirror.com/nomic-ai/nomic-embed-text-v1.5-GGUF/resolve/main/nomic-embed-text-v1.5.Q4_K_M.gguf" -OutFile "$env:USERPROFILE\.openclaw\models\nomic-embed-text-v1.5.Q4_K_M.gguf"

Étape 2 : Configurer le memorySearch d'OpenClaw

Ajoutez le bloc suivant à votre configuration openclaw.json. Assurez-vous de remplacer le dossier de profil utilisateur modelPath par votre propre nom d'utilisateur Windows :

{
  "agents": {
    "defaults": {
      "memorySearch": {
        "enabled": true,
        "provider": "local",
        "model": "fts-only",
        "local": {
          "modelPath": "D:\\Users\\YOUR_USER\\.openclaw\\models\\nomic-embed-text-v1.5.Q4_K_M.gguf"
        }
      }
    }
  }
}

Étape 3 : Installer le plugin de mémoire et vérifier

clawhub install memory-tencentdb
openclaw memory status

Le résultat de statut attendu devrait montrer :

Provider: local (requested: local)
Model: fts-only
Vector: ready
FTS: ready

Schéma de données et taxonomie de Système de mémoire à embedding locale pour OpenClaw (Windows)

La skill de mémoire à embedding locale utilise une organisation de système de fichiers structurée combinée à des fichiers relationnels/vectoriels locaux. Les métadonnées vectorielles de haute dimension sont organisées comme suit :

Répertoire / Fichier Type Description
~/.openclaw/models/nomic-embed-text-v1.5.Q4_K_M.gguf Fichier modèle binaire Modèle d'embedding local central pour la génération de vecteurs (~80 Mo).
openclaw.json Fichier de configuration Paramètres au niveau de l'agent mappant le chemin du modèle local et activant les fournisseurs FTS/vectoriels.
prd-openclaw.json Configuration préréglée Le niveau de persistance principal contenant les configurations memorySearch pour éviter toute perte de configuration au redémarrage.
nomic_atlas_visualizer.py Script Python Génère des cartes visuelles HTML 2D interactives basées sur des embeddings de sentence-transformers de 768 dimensions réduits via UMAP.

Taxonomie des métadonnées vectorielles

  • Dimension : 768 dimensions (norme Nomic Embed v1.5).
  • Moteur FTS : Activé simultanément avec les calculs d'espace vectoriel local.
  • Quantification : Q4_K_M (quantification 4 bits optimisée pour l'exécution CPU sous Windows).

Fonctionnalités avancées de Système de mémoire à embedding locale pour OpenClaw (Windows)

  • Verrouillage de configuration à trois couches : Implémente des configurations de sécurité pour empêcher les signaux SIGUSR1 ou les redémarrages de passerelle d'effacer votre installation. Protège les configurations dans prd-openclaw.json, les variables d'environnement système via openclaw.cmd et le filtrage de liste blanche JS.
  • Visualisations vectorielles 2D Nomic Atlas : Permet aux utilisateurs avancés d'exporter, de projeter et de visualiser les relations spatiales des mémoires d'agent stockées dans des cartes HTML 2D interactives basées sur navigateur en utilisant UMAP.
  • Inférence GGUF sans compilation native : Remplace complètement les dépendances de compilation de modules natifs fragiles (comme node-llama-cpp) par une indexation mémoire GGUF pure pour une compatibilité Windows infaillible.
  • Basculement distant pour intranet : Support intégré pour basculer des modèles GGUF locaux vers des API distantes hautement sécurisées compatibles avec les proxies d'entreprise (comme les passerelles compatibles LiteLLM/OpenAI) lors de l'exécution dans des systèmes d'entreprise isolés.

SKILL.md


Chargement

Compétences Openclaw associées

METADATA

Github Stars: 0
forks: 0

En vedette*