OpenClaw

Public visé et interface concrète

Ce guide connecte les agents OpenClaw à la mémoire persistante XMemo. OpenClaw fonctionne selon une architecture à deux couches : le plugin de mémoire natif OpenClaw sur ClawHub fournit la liaison des outils au moment de l'exécution, tandis que la Skill compagnon fournit des conseils de rappel proactifs et des points de contrôle de session.

Prérequis

Assurez-vous que les dépendances et outils d'exécution suivants sont présents avant la connexion :

• Environnement d'exécution de l'agent OpenClaw installé et opérationnel.
• Accès aux paquets ClawHub activé.
• Compte XMemo valide sur https://xmemo.dev.
• Environnement d'exécution Node.js version 22.22.0 ou supérieure lors de l'installation de la Skill compagnon.

Chemin recommandé : Plugin natif plus Skill compagnon

Le chemin recommandé installe le plugin de mémoire natif OpenClaw depuis ClawHub et la Skill compagnon directement via la gestion des paquets OpenClaw :

openclaw plugins install clawhub:@xmemo/openclaw-memory
openclaw skills install @xmemo/xmemo

Options d'autorisation et d'identifiants

Configurez les identifiants via des variables d'environnement ou une connexion interactive sur l'appareil. N'utilisez jamais de connexion simple sans avoir d'abord choisi votre chemin de stockage d'identifiants :

• Identifiant d'environnement (recommandé) : Définissez XMEMO_KEY dans le shell ou l'environnement de service qui lance OpenClaw.
• Connexion interactive : Si vous utilisez la Skill compagnon, exécutez login avec --allow-plaintext uniquement lorsque secret-store XMEMO_KEY n'est pas disponible (notez que --allow-plaintext stocke l'identifiant non chiffré sur cet ordinateur).
• Vérifier les identifiants : Exécutez openclaw plugins list pour confirmer l'activation du plugin, et vérifiez l'état d'authentification avec la Skill compagnon.

Chemin alternatif : Exécuteur de service headless

Pour les exécuteurs OpenClaw headless ou les pipelines CI automatisés, transmettez XMEMO_KEY directement via des variables d'environnement au plugin sans invite interactive.

export XMEMO_KEY='<your-xmemo-token>'
openclaw run --plugin @xmemo/openclaw-memory

Vérification de connexion (lecture seule)

Vérifiez toujours la connectivité avec une requête en lecture seule avant d'écrire des données. Cette vérification ne modifie pas l'état de la mémoire.

• Vérification : Démarrez une session de test OpenClaw et émettez une requête de rappel actif pour le contexte de projet existant.
• Signal de réussite : OpenClaw renvoie des résultats de mémoire structurés avec des champs Reference et Location valides issus de l'espace de travail autorisé.

Première tâche utile : Cycle de vie de mémoire synthétique

Vérifiez la persistance de la mémoire, la transition de session sans état, le rappel attribué à la source et la correction :

• 1. Enregistrer un fait synthétique : Stockez une convention de projet ("Demo project timestamps use UTC.") dans "projects/demo-onboarding/conventions".
• 2. Transition sans état : Terminez la conversation OpenClaw actuelle et lancez une nouvelle session.
• 3. Rappel avec attribution de source : Interrogez "demo project timestamp format". Confirmez les champs Reference et Location renvoyés.
• 4. Corriger la mémoire : Mettez à jour la convention mémorisée avec le formatage ISO 8601.
• 5. Nettoyage optionnel : Effectuez une suppression réversible (soft-delete) de la convention de démonstration une fois la vérification d'intégration terminée.

Capacités et flux de travail de mémoire

Les flux de travail OpenClaw regroupent les actions par résultat à travers les sessions d'agent :

• Rappel actif proactif : Injecte automatiquement les souvenirs durables pertinents dans le contexte actif avant la planification.
• Continuité de session : Enregistre et restaure les instantanés de redémarrage, suit les décisions et maintient les TODOs à travers les relais.
• Couche de résilience : Le cache de rappel de courte durée et la boîte d'envoi d'écriture temporaire gèrent les brèves interruptions réseau.

Limites et frontières

Contraintes opérationnelles pour l'intégration OpenClaw :

• Isolation de l'espace de travail : Chaque opération est strictement délimitée à l'espace de travail de l'utilisateur authentifié.
• Disponibilité de ClawHub : Les registres tiers non testés ou les forks non officiels du plugin sont marqués comme non testés.
• Portée du grand livre : Les synthèses mensuelles du grand livre et les outils d'audit financier nécessitent des portées commerciales dédiées.

Récupération, mise à jour et suppression

Procédures de dépannage et de maintenance pour OpenClaw :

• Récupération (plugin non chargé) : Exécutez openclaw plugins list et vérifiez les journaux OpenClaw pour détecter les erreurs d'initialisation.
• Récupération (authentification expirée) : Réexportez un XMEMO_KEY valide ou réauthentifiez-vous via la Skill compagnon.
• Mise à jour : Pour mettre à jour les plugins et skills installés, reportez-vous à la documentation de gestion des plugins d'OpenClaw.
• Suppression : Pour supprimer ou désactiver les plugins et skills installés, reportez-vous à la documentation de gestion des plugins d'OpenClaw.