Configuration OpenClaw

Ce guide explique comment installer et configurer l'agent OpenClaw sur votre Serveur RoqueOS.

---

Prérequis

PRÉREQUIS

• Serveur RoqueOS installé et en cours d'exécution (voir installation)
• Docker avec accès au socket (/var/run/docker.sock)
• Clé API d'un fournisseur IA (OpenAI ou Anthropic)
• Minimum de 4 Go de RAM sur le serveur (8 Go recommandés)

---

1. Télécharger l'Image OpenClaw

OpenClaw fonctionne comme un conteneur Docker séparé. Téléchargez l'image officielle :

docker pull roqueribeiro1988/roqueos-openclaw:latest

L'image comprend :

• Ubuntu 22.04
• Bureau XFCE
• TigerVNC + noVNC
• Navigateur Chromium
• Node.js 20
• Agent OpenClaw

---

2. Configurer la Clé API

Dans le fichier docker-compose.yml de votre Serveur RoqueOS, ajoutez les variables d'environnement pour votre clé IA :

OpenAI

services:
  roqueos-server:
    image: roqueribeiro1988/roqueos-server:latest
    environment:
      - TZ=America/Sao_Paulo
      - OPENAI_API_KEY=sk-votre-cle-ici

Anthropic

services:
  roqueos-server:
    image: roqueribeiro1988/roqueos-server:latest
    environment:
      - TZ=America/Sao_Paulo
      - ANTHROPIC_API_KEY=sk-ant-votre-cle-ici

SÉCURITÉ

Ne commitez jamais vos clés API dans des dépôts publics. Utilisez un fichier .env pour stocker les secrets et référencez-le avec env_file: .env dans le fichier compose.

Exemple avec un fichier .env :

# .env (ne pas commiter sur git !)
OPENAI_API_KEY=sk-votre-cle-ici

# docker-compose.yml
services:
  roqueos-server:
    env_file:
      - .env

---

3. Vérifier la Configuration

Après avoir redémarré le serveur avec docker compose down && docker compose up -d, vérifiez que le module de l'agent est accessible :

curl http://localhost:27021/agent/sessions

Réponse attendue :

[]

---

4. Accéder à l'Agent dans le Frontend

1. Ouvrez RoqueOS et assurez-vous d'être connecté au serveur.
2. Dans le Launchpad, cherchez l'application Agent IA (icône OpenClaw).
3. L'application s'ouvrira avec l'interface de chat et le panneau d'aperçu du bureau.

---

Ports Utilisés

Port	Protocole	Description
27021	HTTP/WS	API et WebSocket du Serveur RoqueOS
5901	VNC	VNC du bureau du conteneur OpenClaw
6080	HTTP	noVNC (accès web au bureau)

Les ports 5901 et 6080 sont gérés en interne par le serveur et n'ont pas besoin d'être exposés en externe.

---

Variables d'Environnement Disponibles

Variable	Description	Par défaut
OPENAI_API_KEY	Clé API OpenAI	—
ANTHROPIC_API_KEY	Clé API Anthropic	—
AGENT_MAX_SESSIONS	Nombre maximum de sessions simultanées	3
AGENT_TIMEOUT	Délai d'expiration de la session en minutes	30

---

Prochaines Étapes

• Comment utiliser OpenClaw — Guide pratique et exemples