Sessions and memory
Mémoire Honcho
Honcho ajoute à OpenClaw une mémoire native pour l’IA au moyen d’un Plugin externe. Il conserve les conversations dans un service dédié et élabore au fil du temps des modèles de l’utilisateur et de l’agent, fournissant à votre agent un contexte intersession qui va au-delà des fichiers Markdown de l’espace de travail.
Fonctionnalités fournies
- Mémoire intersession - les conversations sont conservées après chaque tour, de sorte que le contexte est maintenu lors des réinitialisations de session, de la Compaction et des changements de canal.
- Modélisation de l’utilisateur - Honcho maintient un profil pour chaque utilisateur (préférences, faits, style de communication) ainsi que pour l’agent (personnalité, comportements appris).
- Recherche sémantique - effectue des recherches dans les observations issues des conversations passées, et pas uniquement dans la session actuelle.
- Prise en compte de plusieurs agents - les agents parents suivent automatiquement les sous-agents créés, les parents étant ajoutés comme observateurs dans les sessions enfants.
Outils disponibles
Honcho enregistre des outils que l’agent peut utiliser pendant la conversation :
Récupération de données (rapide, sans appel au LLM) :
| Outil | Fonction |
|---|---|
honcho_context |
Représentation complète de l’utilisateur entre les sessions |
honcho_search_conclusions |
Recherche sémantique dans les conclusions stockées |
honcho_search_messages |
Recherche de messages entre les sessions (filtrage par expéditeur et date) |
honcho_session |
Historique et résumé de la session actuelle |
Questions-réponses (avec LLM) :
| Outil | Fonction |
|---|---|
honcho_ask |
Pose une question sur l’utilisateur. depth='quick' pour les faits, 'thorough' pour la synthèse |
Prise en main
Installez le Plugin et lancez la configuration :
openclaw plugins install @honcho-ai/openclaw-honchoopenclaw honcho setupopenclaw gateway --forceLa commande de configuration vous demande vos identifiants d’API, écrit la configuration et peut éventuellement migrer les fichiers de mémoire existants de l’espace de travail.
Configuration
Les paramètres se trouvent sous plugins.entries["openclaw-honcho"].config :
{ plugins: { entries: { "openclaw-honcho": { config: { apiKey: "your-api-key", // omit for self-hosted workspaceId: "openclaw", // memory isolation baseUrl: "https://api.honcho.dev", }, }, }, },}Pour les instances auto-hébergées, définissez baseUrl sur votre serveur local (par exemple
http://localhost:8000) et omettez la clé d’API.
Migration de la mémoire existante
Si votre espace de travail contient déjà des fichiers de mémoire (USER.md, MEMORY.md,
IDENTITY.md, memory/, canvas/), openclaw honcho setup les détecte et
vous propose de les migrer.
Fonctionnement
Après chaque tour de l’IA, la conversation est conservée dans Honcho. Les messages de l’utilisateur et de l’agent sont tous deux observés, ce qui permet à Honcho d’élaborer et d’affiner ses modèles au fil du temps.
Pendant la conversation, les outils Honcho interrogent le service lors du hook de Plugin
before_prompt_build d’OpenClaw, afin d’injecter le contexte pertinent avant que le modèle
ne reçoive l’invite.
Honcho et la mémoire intégrée
| Intégrée / QMD | Honcho | |
|---|---|---|
| Stockage | Fichiers Markdown de l’espace de travail | Service dédié (local ou hébergé) |
| Intersession | Au moyen de fichiers de mémoire | Automatique et intégré |
| Modélisation de l’utilisateur | Manuelle (écriture dans MEMORY.md) | Profils automatiques |
| Recherche | Vectorielle + mots-clés (hybride) | Sémantique dans les observations |
| Multi-agent | Non suivi | Prise en compte des relations parent/enfant |
| Dépendances | Aucune (intégrée) ou binaire QMD | Installation du Plugin |
Honcho et le système de mémoire intégré peuvent fonctionner ensemble. Lorsque QMD est configuré, des outils supplémentaires permettent de rechercher dans les fichiers Markdown locaux en complément de la mémoire intersession de Honcho.
Commandes CLI
openclaw honcho setup # Configure API key and migrate filesopenclaw honcho status # Check connection statusopenclaw honcho ask <question> # Query Honcho about the useropenclaw honcho search <query> [-k N] [-d D] # Semantic search over memory