Embeddings et mémoire persistante

Ce que fait la mémoire persistante#

Par défaut, le contexte de votre agent est limité à la conversation en cours. La mémoire persistante lui permet de se souvenir d'informations entre les sessions, de retrouver du travail passé et de s'appuyer sur les interactions précédentes.

Comment ça marche#

SpineOS utilise une base de données vectorielle embarquée pour stocker et rechercher les souvenirs de votre agent. Quand elle est activée :

1. L'agent crée des embeddings (représentations numériques) des informations importantes pendant les conversations.
2. Ces embeddings sont stockés sur le disque persistant du bureau.
3. Quand vous démarrez une nouvelle conversation, l'agent recherche dans sa mémoire le contexte pertinent.
4. Les souvenirs récupérés sont injectés dans la conversation, ce qui donne de la continuité à l'agent.

Ce qu'il vous faut#

La mémoire persistante nécessite une clé API d'embeddings et un modèle, séparés de la clé de votre provider IA principal. Les embeddings utilisent un modèle spécialisé pour convertir du texte en vecteurs.

Providers d'embeddings supportés#

Configurer la mémoire persistante#

Lors de la création du bureau#

1. Cliquez sur New Desktop.
2. Configurez votre provider IA principal (Anthropic, OpenAI ou OpenRouter).
3. Développez la section Embeddings.
4. Sélectionnez un provider d'embeddings (OpenAI ou OpenRouter).
5. Entrez votre clé API d'embeddings.
6. Choisissez un modèle d'embeddings.
7. Créez votre bureau.

Sur un bureau existant#

1. Ouvrez les paramètres de votre bureau.
2. Ajoutez ou mettez à jour la configuration des embeddings.
3. Redémarrez votre bureau.

Ce que ça donne en pratique#

Avec la mémoire active, votre agent peut :

• Se souvenir du contexte projet : "Nous construisons une API REST avec Express et PostgreSQL."
• Retrouver des décisions passées : "La dernière fois, nous avons décidé d'utiliser JWT pour l'authentification."
• Suivre l'avancement : "L'utilisateur m'a demandé de configurer trois microservices. Deux sont terminés."
• Retenir les préférences : "L'utilisateur préfère TypeScript à JavaScript."

Sans mémoire, chaque nouvelle conversation repart de zéro.

Où sont stockés les souvenirs#

Les souvenirs se trouvent dans ~/.openclaw/workspace/memory/ sur le disque du bureau. Tant que ce bureau n'est pas détruit, ils persistent entre les redémarrages, arrêts et relances.

Vous pouvez inspecter le répertoire mémoire depuis le terminal :

ls ~/.openclaw/workspace/memory/

Coût#

Les appels API d'embeddings sont facturés par votre provider en fonction des tokens traités. Le coût est généralement très faible, quelques centimes par million de tokens pour text-embedding-3-small.

Conseils#

• Vous pouvez utiliser un provider différent pour les embeddings et pour votre modèle principal. Par exemple, Anthropic pour le chat et OpenAI pour les embeddings.
• Si vous n'avez pas besoin de mémoire, ignorez la configuration des embeddings. L'agent fonctionnera quand même, il ne se souviendra simplement pas des sessions passées.
• La qualité de la mémoire s'améliore avec le temps à mesure que l'agent accumule du contexte sur vos projets et préférences.