Installer OpenProse dans OpenClaw : guide pas à pas

Introduction

OpenProse est le moteur d'orchestration multi-agents qui s'intègre directement dans OpenClaw via un plugin officiel. Il apporte un compilateur, un backend d'état et une bibliothèque standard de 50 exemples, le tout utilisable sans quitter votre workspace. Ce guide vous montre comment l'installer, le configurer et exécuter un premier programme .prose en moins de dix minutes. Avant de plonger dans les commandes, consultez le guide complet OpenProse si vous souhaitez comprendre l'architecture générale du système.

---

Résumé rapide

1. Vérifiez les prérequis : OpenClaw installé, gateway en version compatible, droits admin.
2. Choisissez votre méthode d'installation : OpenClaw CLI ou ClawHub CLI.
3. Activez les permissions requises dans l'allowlist du workspace.
4. Redémarrez la gateway pour charger le plugin.
5. Vérifiez l'installation avec /prose help.
6. Exécutez votre premier fichier exemple.prose.

---

Prérequis

Avant de lancer la moindre commande, assurez-vous que votre environnement remplit les conditions suivantes.

OpenClaw installé et à jour

Le plugin open-prose requiert OpenClaw. Si ce n'est pas encore le cas, suivez le guide complet OpenClaw pour l'installation initiale. Vérifiez ensuite votre version :

openclaw --version

Output attendu (minimum requis) :

OpenClaw 1.4.0 (gateway 2.1+)

Version gateway compatible

La gateway doit être en version 2.1 ou supérieure. Les versions antérieures ne supportent pas le rechargement dynamique des plugins et nécessitent une mise à jour complète.

openclaw gateway version

Droits administrateur sur le workspace

L'activation d'un plugin modifie la configuration globale de la gateway. Vous devez disposer du rôle admin sur le workspace cible. Vérifiez votre rôle :

openclaw workspace whoami

Output attendu :

user: alice@example.com  role: admin  workspace: mon-workspace

Si votre rôle est member ou viewer, contactez l'administrateur de votre organisation avant de continuer.

---

Installer OpenProse pas à pas

Deux méthodes officielles coexistent. La Méthode 1 utilise la CLI intégrée d'OpenClaw — idéale si vous travaillez déjà dans un terminal connecté à votre workspace. La Méthode 2 passe par ClawHub, le gestionnaire de plugins communautaire — utile pour les environnements CI/CD ou les scripts d'automatisation.

Méthode 1 — OpenClaw CLI

Étape 1 : activer le plugin

Depuis n'importe quel répertoire, lancez :

openclaw plugins enable open-prose

Output attendu :

Resolving plugin: open-prose@latest...
Downloading open-prose v0.9.4...
Installing dependencies...
Plugin open-prose installed successfully.
Restart the gateway to apply changes.

Piège courant : si vous obtenez Error: plugin not found, vérifiez que votre registre est à jour avec openclaw registry sync avant de relancer la commande.

Étape 2 : vérifier l'installation en attente

Avant le redémarrage, confirmez que le plugin figure dans la liste des plugins installés mais non encore chargés :

openclaw plugins list

Output attendu :

PLUGIN          VERSION   STATUS
open-prose      0.9.4     pending-restart

Étape 3 : configurer l'allowlist

OpenProse a besoin de quatre permissions pour fonctionner. Ajoutez-les dans la configuration du workspace :

openclaw workspace allowlist add sessions_spawn read write web_fetch

Output attendu :

Permissions added: sessions_spawn, read, write, web_fetch

Piège courant : si vous oubliez sessions_spawn, le plugin s'installe mais échoue silencieusement à l'exécution des agents parallèles. Vous verrez une erreur SpawnError: permission denied au premier /prose run.

Étape 4 : redémarrer la gateway

openclaw gateway restart

Output attendu :

Stopping gateway...
Loading plugins: open-prose v0.9.4 ✓
Gateway started on port 8080.

Piège courant : un redémarrage oublié est la cause numéro un des questions "le plugin est installé mais /prose help ne répond pas". Le rechargement à chaud n'est pas supporté pour les plugins qui modifient le routage de commandes.

---

Méthode 2 — ClawHub CLI

ClawHub est le gestionnaire de plugins universel compatible avec plusieurs environnements d'orchestration. Il s'installe à la volée via npx, sans dépendance globale.

Étape 1 : installer le plugin via ClawHub

npx clawhub@latest install open-prose

Output attendu :

clawhub v1.2.0
Fetching open-prose from clawhub registry...
open-prose v0.9.4 downloaded.
Detected runtime: OpenClaw 1.4.0
Injecting plugin into OpenClaw workspace...
Done. Run `openclaw gateway restart` to apply.

Note : ClawHub détecte automatiquement le runtime (OpenClaw, ClawEdge, etc.) et adapte le chemin d'installation. Si la détection échoue, précisez le runtime avec le flag --runtime openclaw.

Étape 2 : configurer l'allowlist

Même si vous passez par ClawHub, la configuration des permissions reste une étape manuelle dans OpenClaw :

openclaw workspace allowlist add sessions_spawn read write web_fetch

Étape 3 : redémarrer la gateway

openclaw gateway restart

---

Vérification de l'installation

Quelle que soit la méthode choisie, validez l'installation avec :

openclaw plugins list

Le statut doit être active (et non plus pending-restart) :

PLUGIN          VERSION   STATUS
open-prose      0.9.4     active

Testez ensuite directement dans le chat OpenClaw :

/prose help

Output attendu :

OpenProse v0.9.4 — Moteur d'orchestration multi-agents
Commandes disponibles :
  /prose run <fichier|handle|url>   Exécuter un programme .prose
  /prose compile <fichier>          Vérifier la syntaxe sans exécuter
  /prose examples                   Lister les 50 exemples fournis
  /prose help                       Afficher cette aide

Commandes disponibles après installation

Commande	Description
/prose run mon-programme.prose	Exécute un fichier .prose local
/prose run <handle/slug>	Exécute depuis le registre public
/prose run https://.../mon_programme.prose	Charge et exécute depuis une URL
/prose compile fichier.prose	Vérifie la syntaxe sans exécuter
/prose examples	Liste les 50 exemples fournis
/prose help	Affiche l'aide complète

Le plugin crée automatiquement le répertoire .prose/ à la racine de votre workspace. Chaque exécution génère un sous-répertoire horodaté dans .prose/runs/{timestamp}/ avec un fichier state.md qui trace l'état des agents.

Checklist de validation

Avant de passer à la suite, confirmez chaque point :

• openclaw plugins list affiche open-prose en statut active
• /prose help répond avec la liste des commandes
• L'allowlist contient sessions_spawn, read, write, web_fetch
• Le répertoire .prose/ existe à la racine du workspace
• Aucune erreur dans les logs de la gateway (openclaw gateway logs --tail 20)

---

Exemple concret

Créons et exécutons un premier programme .prose minimal pour valider l'ensemble de la chaîne.

Étape 1 : créer le fichier

Dans votre workspace, créez un fichier exemple.prose :

@agent résumeur {
  role: "Tu résumes des textes en 3 points maximum."
}

@session principale {
  agents: [résumeur]

  task: "Résume ce paragraphe en 3 points :
  L'intelligence artificielle transforme le développement logiciel.
  Les agents autonomes peuvent désormais lire du code, exécuter des tests
  et proposer des correctifs sans intervention humaine."
}

Étape 2 : vérifier la syntaxe

Avant d'exécuter, compilez le fichier pour détecter les erreurs de syntaxe :

/prose compile exemple.prose

Output attendu :

Compiling exemple.prose...
✓ Syntax valid — 1 agent, 1 session, 0 errors.

Étape 3 : exécuter le programme

/prose run exemple.prose

Output attendu :

[prose] Starting session: principale
[résumeur] Analyzing task...
[résumeur] Response:
1. L'IA révolutionne le développement logiciel.
2. Les agents autonomes lisent du code et exécutent des tests seuls.
3. Des correctifs peuvent être proposés sans intervention humaine.
[prose] Session completed. State saved to .prose/runs/20260321-143022/state.md

Étape 4 : inspecter le fichier d'état

cat .prose/runs/20260321-143022/state.md

Ce fichier contient l'historique complet des messages échangés entre agents, utile pour le débogage ou la reprise d'une session interrompue.

Pour aller plus loin dans la structure des fichiers .prose (agents parallèles, contrôle de flux, boucles), consultez l'article Syntaxe .prose : agents, sessions et contrôle de flux.

---

Bonnes pratiques

Gérer les permissions avec précision

N'accordez que les permissions strictement nécessaires. Si votre workflow n'accède pas au web, retirez web_fetch de l'allowlist. Principe du moindre privilège : chaque permission supplémentaire élargit la surface d'attaque en cas de programme .prose malveillant chargé depuis une URL externe.

Choisir le bon backend d'état

Trois backends sont disponibles :

• filesystem (défaut) : fichiers Markdown dans .prose/runs/. Simple, lisible, recommandé pour le développement et les projets solo.
• SQLite : base de données locale, meilleure performance pour les sessions longues avec de nombreux agents.
• PostgreSQL (expérimental) : pour les équipes qui partagent un workspace distant. Instable en production — attendez la GA.

Configurez le backend dans openclaw.yaml :

plugins:
  open-prose:
    state_backend: sqlite   # filesystem | sqlite | postgresql

Versionner vos fichiers .prose

Ajoutez .prose/runs/ à votre .gitignore (données d'exécution, potentiellement volumineuses) mais committez vos fichiers .prose sources. Cela permet la revue de code sur les workflows d'agents comme sur n'importe quel code.

Surveiller les sessions parallèles

Les workflows avec plusieurs agents concurrents consomment rapidement les quotas de tokens. Utilisez /prose examples pour explorer les modèles d'orchestration fournis et consultez Agents parallèles avec OpenProse avant de passer en production.

---

Questions fréquentes

Comment installer OpenProse dans OpenClaw sans droits admin ?

Ce n'est pas possible directement. L'activation d'un plugin modifie la configuration globale de la gateway, ce qui requiert le rôle admin. Demandez à votre administrateur workspace de lancer openclaw plugins enable open-prose ou de vous déléguer temporairement les droits.

Pourquoi /prose help ne répond pas après l'installation ?

La cause la plus fréquente est un redémarrage de gateway oublié. Lancez openclaw gateway restart puis retestez. Si le problème persiste, vérifiez que le plugin est en statut active (et non pending-restart) avec openclaw plugins list.

Quelle est la différence entre openclaw plugins enable et npx clawhub install ?

Les deux installent le même plugin. openclaw plugins enable passe par le registre officiel d'OpenClaw et est recommandé pour les installations manuelles. npx clawhub install est préférable dans les pipelines CI/CD car il ne nécessite pas d'OpenClaw CLI installé globalement — npx télécharge ClawHub à la volée.

OpenProse est-il compatible avec OpenClaw Edge (version cloud) ?

Oui, mais la procédure diffère légèrement : les plugins s'activent depuis le tableau de bord web d'OpenClaw Edge, sans passer par la CLI. La gestion de l'allowlist reste identique.

Peut-on utiliser le backend PostgreSQL en production ?

Le backend PostgreSQL est marqué expérimental dans la version actuelle (0.9.4). Il peut présenter des problèmes de concurrence sur les sessions longues. Utilisez SQLite pour la production single-node et attendez l'annonce de la GA avant de déployer PostgreSQL en production.

---

Articles liés

Pour approfondir votre maîtrise d'OpenProse, trois ressources complémentaires s'imposent. Le guide complet OpenProse couvre l'architecture complète du moteur d'orchestration, les concepts de session et le système de types. Une fois le plugin installé, passez immédiatement à Syntaxe .prose : agents, sessions et contrôle de flux pour écrire des workflows réels. Enfin, Agents parallèles avec OpenProse vous montrera comment tirer parti de la concurrence pour accélérer vos pipelines d'agents en production.

---

Plugin installé ? Découvrez la syntaxe .prose pour écrire votre premier workflow multi-agents.