Installer OpenProse dans OpenClaw : guide pas à pas

Introduction

Pour installer OpenProse OpenClaw, utilisez le plugin inclus qui orchestre des sessions d'IA à partir de fichiers Markdown .prose. Cette approche est utile quand un workflow demande plusieurs sous-agents, des étapes parallèles ou un état inspectable. Elle est inutile pour une commande déterministe ou un script court : restez alors sur une approche plus simple.

Le parcours officiel n'emploie ni paquet Python, ni version Gateway inventée, ni téléchargement ClawHub pour l'installation standard. Activez le plugin, redémarrez le Gateway et contrôlez la commande /prose. Ce tutoriel couvre aussi les outils requis, l'état, les tests et les limites de sécurité. Pour comprendre le langage avant de l'exécuter, consultez le guide complet OpenProse.

Résumé rapide

1. Vérifiez qu'OpenClaw fonctionne avec openclaw gateway status.
2. Activez le plugin inclus : openclaw plugins enable open-prose.
3. Redémarrez le Gateway : openclaw gateway restart.
4. Vérifiez l'activation avec openclaw plugins list.
5. Dans le chat, lancez /prose help, puis /prose examples.
6. Testez un fichier local avec /prose compile, puis /prose run.
7. Contrôlez les outils autorisés et examinez tout programme distant comme du code.

OpenProse est bien un plugin OpenClaw qui livre des skills ; ce n'est ni un « skill Python » ni un service SaaS externe.

Prérequis et vocabulaire

Vous avez besoin d'une installation OpenClaw actuelle, d'un Gateway fonctionnel et d'un accès à son terminal. Le démarrage officiel d'OpenClaw repose sur Node et sa configuration principale se trouve dans ~/.openclaw/openclaw.json. N'utilisez pas pip install openclaw ou openclaw.yaml pour ce parcours.

Les couches se répartissent ainsi :

Élément	Rôle
Plugin open-prose	Fournit l'intégration OpenProse au runtime OpenClaw.
Skill pack	Enseigne à l'agent comment interpréter et exécuter les programmes.
Commande /prose	Surface utilisateur pour l'aide, la compilation et l'exécution.
Outils OpenClaw	sessions_spawn, read, write et web_fetch réalisent les opérations nécessaires.
Fichier .prose	Programme déclaratif à revoir et versionner comme du code.
État .prose/	Données d'exécution conservées dans le workspace.

Le plugin n'accorde pas automatiquement tous les droits. Si la politique de l'agent bloque un outil requis, le programme échoue. Cette séparation est volontaire : l'installation d'une capacité ne doit pas contourner la politique d'outils.

Installer et vérifier OpenProse

Activer le plugin inclus

openclaw plugins enable open-prose

Le mot important est enable : OpenProse est déjà inclus dans la distribution OpenClaw actuelle. N'ajoutez pas une seconde copie issue d'une source inconnue. Depuis un checkout du dépôt OpenClaw, les développeurs peuvent installer l'extension locale, mais ce n'est pas le parcours normal d'un utilisateur.

Avant de redémarrer, notez l'état initial du plugin et l'heure du test. Cette précaution aide à distinguer une activation récente d'une configuration déjà présente. Si la commande renvoie une erreur, ne modifiez pas plusieurs réglages à la fois : contrôlez d'abord que la CLI vise le bon Gateway, que l'utilisateur possède les droits nécessaires et que l'installation OpenClaw est saine. Relancez ensuite une seule étape et conservez son résultat. Cette méthode évite de masquer la cause avec une réinstallation inutile.

Redémarrer le Gateway

openclaw gateway restart

Puis contrôlez l'inventaire :

openclaw plugins list

La liste doit montrer open-prose activé. Si ce n'est pas le cas, inspectez le plugin et les diagnostics :

openclaw plugins inspect open-prose --runtime --json
openclaw plugins doctor --json

Vérifier la commande de chat

Dans le Control UI ou un canal connecté :

/prose help

Les commandes documentées comprennent notamment :

/prose run <file.prose>
/prose run <handle/slug>
/prose compile <file.prose>
/prose examples
/prose update

N'utilisez pas un faux statut pending-restart, une version figée ou des sorties terminal recopiées comme preuve. La preuve est le résultat observé sur votre installation.

Checklist de validation

• open-prose apparaît comme activé dans l'inventaire des plugins ;
• /prose help répond depuis une nouvelle session ;
• /prose compile refuse proprement un fichier volontairement invalide ;
• un programme local minimal crée un run inspectable dans le workspace ;
• aucun outil absent de l'allowlist n'est utilisé silencieusement.

Si l'un de ces contrôles échoue, arrêtez le parcours avant d'ajouter un backend d'état ou un programme distant. Corrigez d'abord l'activation locale : elle constitue la base reproductible du reste du tutoriel.

Configurer les outils et l'état

OpenProse mappe ses opérations sur des outils OpenClaw. Les programmes multi-agents ont besoin de sessions_spawn; les accès aux fichiers passent par read et write; les programmes distants utilisent web_fetch. Vérifiez que la politique de l'agent expose uniquement ce qui est nécessaire au programme testé.

Une allowlist restrictive peut ressembler à ceci :

{
  tools: {
    allow: ["sessions_spawn", "read", "write"],
  },
}

Ajoutez web_fetch seulement si le workflow doit récupérer une ressource distante. Une allowlist détermine les outils visibles, mais ne constitue pas à elle seule une isolation du système de fichiers ou du shell. Pour les programmes non fiables, utilisez aussi un environnement isolé et des approbations.

Avant la production, faites trois essais distincts. Le premier utilise un fichier local sans accès web et prouve la compilation. Le deuxième provoque volontairement une erreur de syntaxe et vérifie que le run s'arrête sans état trompeur. Le troisième retire sessions_spawn de l'allowlist et confirme qu'un programme multi-agent échoue clairement. Conservez pour chacun la commande, le résultat et le dossier de run : cette trace distingue une activation réussie d'une simple absence d'erreur visible.

Décidez aussi qui peut lancer /prose depuis vos canaux. Un plugin actif sur le Gateway ne signifie pas que chaque correspondant doit pouvoir exécuter un programme. Combinez les politiques du canal, le routage vers un agent dédié et une politique d'outils minimale. Pour une procédure de gouvernance plus générale, voyez comprendre les skills OpenClaw.

Par défaut, OpenProse conserve l'état dans .prose/runs/ au sein du workspace. Des modes in-context, SQLite et PostgreSQL sont également documentés, avec des prérequis spécifiques pour les deux derniers. Ne configurez pas ces backends dans un openclaw.yaml inexistant. Commencez avec le mode filesystem, inspectable, puis changez seulement si une contrainte mesurée le justifie.

Ajoutez les données d'exécution sensibles ou volumineuses à votre politique de sauvegarde et à votre .gitignore, tout en versionnant les sources .prose utiles.

En exploitation, attribuez un identifiant fonctionnel à chaque workflow et conservez la version du fichier exécuté. Un résultat sans lien vers sa source est difficile à reproduire après une modification. Définissez une durée maximale, un plafond de sous-agents et une règle d'arrêt en cas de source absente. Si un run doit publier, envoyer ou modifier un système tiers, séparez la préparation de l'action : OpenProse produit d'abord un artefact à relire, puis un outil borné réalise l'effet après approbation.

Exemple concret

Créez un fichier exemple.prose dans un workspace de test :

input topic: "Quel sujet faut-il résumer ?"

agent researcher:
  prompt: "Cherche les faits importants et signale les incertitudes."

agent writer:
  prompt: "Produis une synthèse courte à partir du contexte fourni."

parallel:
  findings = session: researcher
    prompt: "Analyse {topic}."
  draft = session: writer
    prompt: "Prépare un plan sur {topic}."

session "Fusionne les résultats sans inventer de faits."
  context: { findings, draft }

Vérifiez d'abord la syntaxe :

/prose compile exemple.prose

Puis exécutez :

/prose run exemple.prose

Contrôlez le résultat dans le chat et l'état sous .prose/runs/. La validation ne consiste pas seulement à voir une réponse : vérifiez que les deux sessions attendues ont été lancées, que la synthèse reprend leurs sorties et qu'aucun outil non autorisé n'a été appelé.

La syntaxe et les patterns plus avancés sont détaillés dans Syntaxe .prose : agents, sessions et contrôle de flux et Agents parallèles avec OpenProse.

Bonnes pratiques

• Traitez chaque .prose comme du code. Relisez les actions, entrées et dépendances avant exécution.
• Préférez les fichiers locaux. Une URL ou un handle ajoute une dépendance distante susceptible de changer.
• Examinez les imports transitifs. OpenProse demande une approbation explicite avant de récupérer des imports use distants ; ne l'accordez pas mécaniquement.
• Limitez les outils. Un programme de synthèse n'a pas besoin d'un shell ou d'un accès d'écriture global.
• Commencez avec le stockage filesystem. Il facilite l'inspection et le débogage.
• Bornez le parallélisme. Chaque sous-agent consomme du temps et des ressources fournisseur.
• Testez les échecs. Retirez temporairement un outil requis et vérifiez que le workflow échoue clairement.
• Épinglez vos hypothèses. Les API de plugins évoluent ; testez après chaque mise à jour d'OpenClaw.

Pour un workflow déterministe avec étapes d'approbation, OpenProse n'est pas toujours le meilleur niveau d'abstraction. Utilisez-le lorsque la coordination de sessions et la souplesse agentique apportent une valeur réelle.

Questions fréquentes

Faut-il installer OpenProse depuis ClawHub ?

Non pour l'intégration standard actuelle : le plugin open-prose est inclus dans OpenClaw et désactivé par défaut. Activez-le puis redémarrez le Gateway.

Pourquoi /prose n'apparaît-il pas ?

Vérifiez que le plugin est activé, redémarrez le Gateway et inspectez le runtime avec la CLI. Une session existante peut aussi conserver un ancien snapshot de skills ; ouvrez une nouvelle session si nécessaire.

OpenProse a-t-il besoin de Python ?

Non. Le parcours OpenClaw actuel n'utilise ni pip, ni BaseSkill, ni classes d'agents Python.

Puis-je exécuter un programme distant ?

Oui, mais considérez-le comme du code non fiable. Examinez sa source et ses imports, puis accordez uniquement les outils et approbations indispensables.

Articles liés

L'installation ne constitue que la première étape : la valeur vient d'un programme relu, borné et reproductible. Les ressources suivantes couvrent le langage, le parallélisme et la place d'OpenProse dans l'écosystème OpenClaw.

• Guide complet OpenProse
• Syntaxe .prose : agents, sessions et contrôle de flux
• Agents parallèles avec OpenProse
• Guide complet OpenClaw