qwang6-1936520/Human-like-memory-skill

Compétence de Mémoire Similaire à l'Humain

Outils de mémoire à long terme utilisables par un agent pour une mémoire similaire à l'humain.

Cette compétence prend en charge :

• Rappel et sauvegarde déclenchés par l'agent lorsque le modèle juge que la mémoire est utile
• Invocation explicite par l'utilisateur lorsqu'il demande directement de se souvenir ou de stocker une information

Cette compétence est intentionnellement pas toujours active :

• Elle ne doit pas rappeler automatiquement à chaque tour par défaut
• Elle ne doit pas enregistrer silencieusement chaque tour de conversation par défaut
• Elle lit uniquement les variables d'environnement exposées à l'exécution
• Elle ne lit pas les fichiers de secrets locaux ni les fichiers de configuration privés propres à la compétence

Si vous souhaitez un rappel/stockage automatique toujours actif, utilisez le plugin Human-Like Memory au lieu de cette compétence.

Divulgation des Données et du Réseau

Lorsque l'agent ou l'utilisateur invoque cette compétence :

• recall / search envoie votre requête, votre user_id et votre agent_id vers https://plugin.human-like.me ou l'URL de base configurée
• save / save-batch envoie le contenu de la conversation que vous transmettez explicitement au même service
• Aucun fichier local, historique de shell ou variable d'environnement non liée n'est lu ou téléchargé

Quand l'utiliser

• Vous souhaitez rechercher explicitement des souvenirs passés
• Vous souhaitez enregistrer explicitement un fait, une décision, une préférence ou un résumé de l'utilisateur
• L'agent a besoin du contexte passé pour répondre correctement
• L'agent doit enregistrer une préférence, décision, correction ou résumé durable

Quand ne pas l'utiliser

• Vous souhaitez un rappel automatique à chaque tour ou une sauvegarde en arrière-plan au niveau du hook
• Vous avez besoin d'une activité réseau cachée ou silencieuse
• Vous ne voulez aucun transfert de données à distance

Configuration

1. Obtenir une clé API

Visitez plugin.human-like.me et copiez votre clé mp_xxx.

2. Configurer via Hermes

export HUMAN_LIKE_MEM_API_KEY="mp_votre_clé_ici"
export HUMAN_LIKE_MEM_BASE_URL="https://plugin.human-like.me"
export HUMAN_LIKE_MEM_USER_ID="hermes-user"
export HUMAN_LIKE_MEM_AGENT_ID="main"

Vous pouvez également utiliser la configuration sécurisée d'environnement Hermes lorsque vous y êtes invité au moment du chargement de la compétence.

3. Vérifier

node {baseDir}/scripts/memory.mjs config

La sortie attendue inclut :

{
  "apiKeyConfigured": true
}

Commandes

Rappeler ou rechercher un souvenir

node {baseDir}/scripts/memory.mjs recall "<requête>"
node {baseDir}/scripts/memory.mjs search "<requête>"

Enregistrer un tour

node {baseDir}/scripts/memory.mjs save "<message_utilisateur>" "<réponse_assistant>"

Enregistrer un lot

echo '[{"role":"user","content":"..."},{"role":"assistant","content":"..."}]' | node {baseDir}/scripts/memory.mjs save-batch

Inspecter la configuration d'exécution

node {baseDir}/scripts/memory.mjs config

Style d'invocation de l'agent

Cette compétence peut être appelée par l'agent lorsque la mémoire est clairement utile.

Comportement recommandé :

• Utilisez recall / search lorsque l'utilisateur fait référence à un travail antérieur, des préférences antérieures, des décisions antérieures, ou demande de continuer quelque chose de plus tôt
• Utilisez save lorsque l'utilisateur demande explicitement de se souvenir de quelque chose, corrige des détails d'identité, exprime une préférence stable, ou confirme une décision importante
• Utilisez save-batch après une discussion significative de plusieurs tours si HUMAN_LIKE_MEM_AUTO_SAVE_ENABLED=true et que la conversation actuelle a accumulé environ HUMAN_LIKE_MEM_SAVE_TRIGGER_TURNS tours
• N'appelez pas les API de mémoire pour de simples salutations ou des questions génériques à un seul tour sans valeur de continuité

Cela donne à l'agent une autonomie, mais maintient la compétence en mode déclenchement intelligent plutôt qu'en mode toujours actif.

Requêtes suggérées

• Rappel : "décisions de roadmap de la semaine dernière"
• Recherche : "quelle préférence de nom ai-je mentionnée"
• Sauvegarde : "Je préfère les horodatages UTC+8"

Déclencheurs de sauvegarde

L'agent devrait fortement considérer save lorsque l'utilisateur :

• exprime une préférence stable
• prend ou confirme une décision
• fournit un fait de profil personnel important pour plus tard
• corrige un malentendu précédent
• dit explicitement "souviens-toi de ceci"

L'agent peut utiliser save-batch après un échange plus long lorsqu'un résumé compact des derniers tours est susceptible d'aider la continuité future.

Gestion des erreurs

• Si la clé API est manquante, le script affiche les étapes exactes de configuration des variables d'environnement
• Si le service expire ou rencontre une erreur, rien n'est enregistré implicitement
• Si aucun souvenir n'est trouvé, traitez cela comme un résultat vide normal

Confidentialité

• Évitez d'envoyer des mots de passe, jetons ou secrets
• Transmettez uniquement le contenu que vous êtes prêt à stocker sur votre service de mémoire configuré
• Consultez SECURITY.md pour les champs transmis et les notes opérationnelles

Notes de compatibilité OpenClaw

• Les artefacts de métadonnées OpenClaw sont préservés dans compat/openclaw/.
• Les commandes d'exécution restent compatibles (la surface de commande scripts/memory.mjs est inchangée).