Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Honcho ajoute une mémoire native pour l’IA à OpenClaw. Il persiste les conversations dans un service dédié et construit au fil du temps des modèles utilisateur et agent, offrant à votre agent un contexte inter-sessions qui va au-delà des fichiers Markdown de l’espace de travail.

​
Ce qu’il fournit

  • Mémoire inter-sessions — les conversations sont persistées après chaque tour, de sorte que le contexte est conservé entre les réinitialisations de session, la Compaction et les changements de canal.
  • Modélisation utilisateur — Honcho maintient un profil pour chaque utilisateur (préférences, faits, style de communication) et pour l’agent (personnalité, comportements appris).
  • Recherche sémantique — recherche dans les observations issues des conversations passées, et pas seulement dans la session courante.
  • Conscience multi-agent — les agents parents suivent automatiquement les sous-agents générés, avec les parents 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 LLM) :
OutilCe qu’il fait
honcho_contextReprésentation complète de l’utilisateur entre les sessions
honcho_search_conclusionsRecherche sémantique dans les conclusions stockées
honcho_search_messagesTrouver des messages entre les sessions (filtrer par expéditeur, date)
honcho_sessionHistorique et résumé de la session courante
Questions-réponses (piloté par LLM) :
OutilCe qu’il fait
honcho_askPoser une question sur l’utilisateur. depth='quick' pour les faits, 'thorough' pour la synthèse

​
Premiers pas

Installez le Plugin et exécutez la configuration : 
openclaw plugins install @honcho-ai/openclaw-honcho
openclaw honcho setup
openclaw gateway --force
La commande de configuration demande vos identifiants d’API, écrit la configuration et migre éventuellement les fichiers mémoire existants de l’espace de travail.
Honcho peut fonctionner entièrement en local (auto-hébergé) ou via l’API gérée à api.honcho.dev. Aucune dépendance externe n’est requise pour l’option auto-hébergée.

​
Configuration

Les paramètres se trouvent sous plugins.entries["openclaw-honcho"].config : 
{
  plugins: {
    entries: {
      "openclaw-honcho": {
        config: {
          apiKey: "your-api-key", // omettre pour l’auto-hébergement
          workspaceId: "openclaw", // isolation de la mémoire
          baseUrl: "https://api.honcho.dev",
        },
      },
    },
  },
}
Pour les instances auto-hébergées, pointez baseUrl vers votre serveur local (par exemple http://localhost:8000) et omettez la clé API.

​
Migration de la mémoire existante

Si vous avez des fichiers mémoire existants dans l’espace de travail (USER.md, MEMORY.md, IDENTITY.md, memory/, canvas/), openclaw honcho setup les détecte et propose de les migrer.
La migration est non destructive — les fichiers sont téléversés vers Honcho. Les originaux ne sont jamais supprimés ni déplacés.

​
Fonctionnement

Après chaque tour IA, la conversation est persistée dans Honcho. Les messages utilisateur et agent sont tous deux observés, ce qui permet à Honcho de construire et d’affiner ses modèles au fil du temps. Pendant la conversation, les outils Honcho interrogent le service dans la phase before_prompt_build, injectant le contexte pertinent avant que le modèle ne voie le prompt. Cela garantit des frontières de tour précises et un rappel pertinent.

​
Honcho vs mémoire intégrée

Intégrée / QMDHoncho
StockageFichiers Markdown d’espace de travailService dédié (local ou hébergé)
Inter-sessionsVia les fichiers mémoireAutomatique, intégré
Modélisation utilisateurManuelle (écrire dans MEMORY.md)Profils automatiques
RechercheVecteur + mot-clé (hybride)Sémantique sur les observations
Multi-agentNon suiviConscience parent/enfant
DépendancesAucune (intégrée) ou binaire QMDInstallation de Plugin
Honcho et le système de mémoire intégré peuvent fonctionner ensemble. Lorsque QMD est configuré, des outils supplémentaires deviennent disponibles pour rechercher dans les fichiers Markdown locaux en plus de la mémoire inter-sessions de Honcho.

​
Commandes CLI

openclaw honcho setup                        # Configurer la clé API et migrer les fichiers
openclaw honcho status                       # Vérifier l’état de connexion
openclaw honcho ask <question>               # Interroger Honcho au sujet de l’utilisateur
openclaw honcho search <query> [-k N] [-d D] # Recherche sémantique dans la mémoire

​
Pour aller plus loin

​
Liens associés