Comment utiliser OpenClaw

Un guide pratique pour tirer le meilleur parti de l'agent IA autonome de RoqueOS.

---

Interface de l'Agent

L'application Agent IA est divisée en deux zones principales :

• Panneau de Chat (à gauche) — où vous envoyez des messages et suivez les réponses
• Aperçu du Bureau (à droite) — flux en direct de ce que l'agent fait dans le conteneur

Panneau des Étapes

Sous le chat, un panneau des Étapes en Temps Réel affiche chaque action que l'agent effectue : naviguer vers une URL, cliquer sur un élément, exécuter une commande, etc.

---

Créer une Session

Chaque conversation avec l'agent crée une session — un conteneur Docker isolé avec un bureau Linux exclusif. Pour commencer :

1. Ouvrez l'application Agent IA dans le Launchpad.
2. Cliquez sur Nouvelle Session.
3. Le conteneur s'initialisera (cela peut prendre 10 à 30 secondes la première fois).
4. Lorsque le bureau apparaît dans le panneau de droite, l'agent est prêt.

---

Envoyer des Tâches

Bonnes Pratiques pour les Prompts

Soyez spécifique et objectif lors de la description de la tâche. Plus vous fournissez de contexte, meilleur sera le résultat.

❌ Vague :

Fais des recherches sur Docker

✅ Spécifique :

Recherche les 5 principales différences entre Docker Compose v2 et v3,
crée un fichier markdown résumant les points, et sauvegarde-le dans /home/user/docker-comparison.md

Exemples de Tâches

Recherche et documentation :

Va sur le site hetzner.com, trouve les plans VPS disponibles,
et crée un tableau comparatif avec les prix et caractéristiques en CSV.

Automatisation de formulaires :

Remplis le formulaire d'inscription sur [URL] avec les données suivantes :
nom : Jean Dupont, email : jean@exemple.com, plan : basique

Développement :

Crée un script Python qui extrait les titres d'actualités
de Hacker News et sauvegarde les 10 premiers dans un fichier JSON.

Analyse de site web :

Va sur ce dépôt GitHub [URL], lis le README, et explique-moi
ce que fait le projet et quels sont les prérequis d'installation.

---

Actions que l'Agent peut effectuer sur RoqueOS

OpenClaw peut interagir directement avec votre RoqueOS en dehors du conteneur isolé :

Action	Description
Notification	Envoyer une alerte à votre bureau RoqueOS
Ouvrir App	Ouvrir une application spécifique dans le Launchpad
Ouvrir URL	Ouvrir une URL dans le navigateur RoqueOS

Exemple d'utilisation : à la fin d'une tâche longue, l'agent peut envoyer une notification automatique pour vous informer qu'il a terminé.

---

Gérer les Sessions

Sessions Actives

Toutes les sessions actives sont listées en haut de l'application. Vous pouvez :

• Reprendre une session précédente en cliquant dessus
• Terminer une session pour libérer les ressources du serveur

Limite de Sessions Simultanées

Par défaut, le serveur autorise jusqu'à 3 sessions simultanées (configurable via AGENT_MAX_SESSIONS). Terminez les sessions que vous n'utilisez plus pour économiser de la RAM.

---

Capture d'écran et Plein Écran

• Capture d'écran — cliquez sur l'icône appareil photo pour capturer l'état actuel du bureau de l'agent
• Plein écran — étendez la vue du bureau en plein écran pour mieux suivre les tâches visuelles

---

Limites Connues

• L'agent opère dans un environnement isolé — il n'a pas d'accès direct à vos fichiers locaux à moins que vous ne fournissiez les informations via le chat.
• Les tâches nécessitant des connexions à des comptes (email, réseaux sociaux) nécessitent que vous fournissiez les identifiants pendant la conversation.
• Le délai d'expiration par défaut est de 30 minutes d'inactivité — les tâches très longues peuvent nécessiter une interaction périodique.

---

Dépannage

L'agent ne répond pas

1. Vérifiez si le serveur est en ligne : curl http://localhost:27021/health
2. Confirmez que la clé API est configurée correctement.
3. Terminez la session actuelle et créez-en une nouvelle.

Le bureau n'apparaît pas dans le panneau

Le conteneur est peut-être encore en cours d'initialisation. Attendez 30 secondes et rechargez l'application.

Réponses lentes ou incomplètes

Il s'agit peut-être d'un problème de limite de requêtes (rate limit) du fournisseur IA. Attendez quelques instants et réessayez, ou réduisez la complexité de la tâche.