Exécution de plusieurs instances OpenClaw : Guide de configuration multi-agents

Présentation

La plupart des utilisateurs d’OpenClaw commencent avec une seule instance : un assistant IA gérant tous leurs besoins. Mais que se passe-t-il si vous souhaitez exécuter plusieurs instances ? Peut-être souhaitez-vous des assistants séparés pour le travail et la vie personnelle, ou souhaitez-vous vous cloner en plusieurs agents spécialisés. Ce guide avancé vous montre comment configurer et gérer plusieurs instances OpenClaw simultanément.

Un utilisateur, Brosef, s’est cloné dans trois instances OpenClaw distinctes, chacune avec des personnalités et des capacités différentes. Cette approche multi-agents débloque des flux de travail puissants dans lesquels différents assistants gèrent différents aspects de votre vie.

Pourquoi exécuter plusieurs instances ?

Avant de plonger dans la configuration technique, explorons pourquoi vous pourriez vouloir plusieurs instances OpenClaw :

Contextes séparés

Chaque instance conserve sa propre mémoire et son propre contexte. Cela signifie :

• Work Assistant : mémorise les préférences, les projets et les contacts liés au travail
• Assistant personnel – Gère les tâches personnelles, le suivi de la santé et les loisirs
• Assistant de développement — Se concentre sur le codage, GitHub et les flux de travail techniques

Différentes personnalités

Vous pouvez configurer chaque instance avec une personnalité différente :

• Un assistant professionnel et formel pour les communications d’entreprise
• Un assistant décontracté et convivial pour les discussions personnelles
• Un assistant technique axé sur le code pour les tâches de développement

Gestion des ressources

L’exécution de plusieurs instances vous permet de :

• Utiliser différents modèles d’IA pour différentes tâches (Claude pour l’écriture, GPT pour le codage)
• Répartir la charge entre les instances
• Isoler les échecs (si une instance plante, les autres continuent)

Organisation multicanal

Avec plusieurs instances, vous pouvez :

• Attribuez différents robots Discord à différents serveurs
• Utilisez des numéros WhatsApp distincts à des fins différentes
• Organiser les robots Telegram par fonction

Prérequis

Avant de configurer plusieurs instances, assurez-vous d’avoir :

• OpenClaw installé (voir notre guide d’installation)
• Compréhension de base des opérations en ligne de commande
• Ressources système suffisantes (chaque instance utilise de la mémoire et du CPU)
• Plusieurs clés API si vous utilisez différents modèles d’IA

Méthode 1 : Clonage du référentiel

L’approche la plus simple consiste à cloner OpenClaw dans des répertoires distincts, chacun avec sa propre configuration.

Étape 1 : Cloner plusieurs répertoires

# Clone first instance (default)
git clone https://github.com/openclaw/openclaw.git openclaw-personal
cd openclaw-personal
npm install

# Clone second instance
cd ..
git clone https://github.com/openclaw/openclaw.git openclaw-work
cd openclaw-work
npm install

# Clone third instance (optional)
cd ..
git clone https://github.com/openclaw/openclaw.git openclaw-dev
cd openclaw-dev
npm install

Étape 2 : Configurer des répertoires de données distincts

Chaque instance a besoin de son propre répertoire de données pour éviter les conflits. Modifiez le fichier de configuration dans chaque instance :

# In openclaw-personal/.env or config
DATA_DIR=/Users/yourname/.openclaw/personal

# In openclaw-work/.env or config
DATA_DIR=/Users/yourname/.openclaw/work

# In openclaw-dev/.env or config
DATA_DIR=/Users/yourname/.openclaw/dev

Étape 3 : Configurer différents ports

Si vous exécutez des instances simultanément, attribuez différents ports :

# Instance 1
PORT=3000

# Instance 2
PORT=3001

# Instance 3
PORT=3002

Étape 4 : Configurer différents ponts de discussion

Configurez chaque instance pour vous connecter à différentes plateformes de chat ou comptes :

Instance personnelle (WhatsApp) :

WHATSAPP_ENABLED=true
WHATSAPP_SESSION_PATH=/Users/yourname/.openclaw/personal/whatsapp

Instance de travail (Discord) :

DISCORD_ENABLED=true
DISCORD_BOT_TOKEN=your_work_bot_token
DISCORD_GUILD_ID=your_work_server_id

Instance de développement (télégramme) :

TELEGRAM_ENABLED=true
TELEGRAM_BOT_TOKEN=your_dev_bot_token

Méthode 2 : Utiliser des variables d’environnement

Au lieu de cloner plusieurs fois, vous pouvez exécuter une seule installation avec différentes configurations d’environnement.

Créer des scripts de lancement

Créez des scripts de lancement distincts pour chaque instance :

lancement-personnel.sh :

#!/bin/bash
export DATA_DIR=/Users/yourname/.openclaw/personal
export PORT=3000
export OPENCLAW_PERSONA="You are a friendly personal assistant..."
export ANTHROPIC_API_KEY=your_personal_key
npm start

lancement-work.sh :

#!/bin/bash
export DATA_DIR=/Users/yourname/.openclaw/work
export PORT=3001
export OPENCLAW_PERSONA="You are a professional business assistant..."
export ANTHROPIC_API_KEY=your_work_key
npm start

Rendre les scripts exécutables :

chmod +x launch-personal.sh launch-work.sh

Créer différentes personnalités

Chaque instance peut avoir une personnalité unique définie dans sa configuration. Voici comment personnaliser les personnages :

Persona de l’assistant personnel

persona: |
  You are a friendly, casual personal assistant named Alex.
  You help with daily tasks, health tracking, and personal projects.
  You're warm, encouraging, and use emojis occasionally.
  You remember personal preferences and adapt to the user's lifestyle.

Persona d’assistant de travail

persona: |
  You are a professional business assistant named Morgan.
  You handle work communications, calendar management, and business tasks.
  You're efficient, detail-oriented, and maintain professional boundaries.
  You prioritize work-related context and business relationships.

Assistant de développement Persona

persona: |
  You are a technical development assistant named Dev.
  You focus on coding, GitHub workflows, and technical problem-solving.
  You're precise, code-focused, and prefer technical explanations.
  You integrate with development tools and understand software architecture.

Configuration multi-bots DiscordL’exécution de plusieurs robots Discord à partir du même serveur nécessite une configuration minutieuse.

Étape 1 : Créer plusieurs applications Discord

1. Accédez au Portail des développeurs Discord
2. Créez des applications distinctes pour chaque bot :
   • Bot personnel
   • Bot de travail
   • Bot de développement

Étape 2 : Générer des jetons de robot

Chaque application reçoit son propre jeton de bot. Conservez-les en toute sécurité :

# .env for personal instance
DISCORD_BOT_TOKEN=personal_bot_token_here

# .env for work instance
DISCORD_BOT_TOKEN=work_bot_token_here

Étape 3 : Configurer les identifiants de guilde

Si vous voulez des robots sur différents serveurs :

# Personal bot in personal server
DISCORD_GUILD_ID=personal_server_id

# Work bot in work server
DISCORD_GUILD_ID=work_server_id

Étape 4 : Inviter des robots sur des serveurs

Utilisez le générateur d’URL OAuth2 de Discord pour inviter chaque bot avec les autorisations appropriées :

• Lire les messages
• Envoyer des messages
• Gérer les messages (si nécessaire)
• Lire l’historique des messages

Gestion des instances simultanées

Utilisation des gestionnaires de processus

Pour les configurations de production, utilisez un gestionnaire de processus tel que PM2 :

npm install -g pm2

# Start personal instance
cd openclaw-personal
pm2 start npm --name "openclaw-personal" -- start

# Start work instance
cd ../openclaw-work
pm2 start npm --name "openclaw-work" -- start

# List all instances
pm2 list

# View logs
pm2 logs openclaw-personal
pm2 logs openclaw-work

Utilisation de Docker Compose

Pour les déploiements conteneurisés :

docker-compose.yml :

version: '3.8'
services:
  openclaw-personal:
    build: .
    environment:
      - DATA_DIR=/data/personal
      - PORT=3000
      - DISCORD_BOT_TOKEN=${PERSONAL_BOT_TOKEN}
    volumes:
      - ./data/personal:/data/personal

  openclaw-work:
    build: .
    environment:
      - DATA_DIR=/data/work
      - PORT=3001
      - DISCORD_BOT_TOKEN=${WORK_BOT_TOKEN}
    volumes:
      - ./data/work:/data/work

Exemple concret : configuration de Brosef

Brosef s’est cloné en trois instances :

1. Personal Brosef — Gère les tâches quotidiennes, le suivi de la santé et les communications personnelles
2. Work Brosef — Gère les communications professionnelles, le calendrier et les projets de travail
3. Dev Brosef — Se concentre sur GitHub, les révisions de code et les flux de travail techniques

Chaque instance :

• Utilise différentes plateformes de chat (WhatsApp, Discord, Telegram)
• A une mémoire et un contexte distincts
• Gère différentes compétences et intégrations
• Fonctionne de manière indépendante

Cette configuration permet à Brosef de conserver des contextes séparés tout en exploitant les mêmes capacités d’IA sous-jacentes.

meilleures pratiques

Gestion des ressources

• Surveiller l’utilisation du processeur et de la mémoire sur toutes les instances
• Envisagez d’utiliser différents modèles d’IA pour différentes instances (modèles plus légers pour des tâches simples)
• Utilisez des gestionnaires de processus pour redémarrer automatiquement les instances ayant échoué

Isolement des données

• Gardez les répertoires de données complètement séparés
• Utilisez différentes clés API pour différentes instances
• Sauvegardez régulièrement les données de chaque instance indépendamment

Sécurité

• Utilisez des informations d’identification différentes pour chaque instance
• Limiter l’accès au système de fichiers par instance
• Utiliser des variables d’environnement pour la configuration sensible

Surveillance

• Configurer la journalisation pour chaque instance
• Surveiller l’utilisation de l’API par instance
• Suivre les mesures de performance séparément

Dépannage

Conflits de ports

Si les instances ne parviennent pas à démarrer, recherchez les conflits de ports :

lsof -i :3000
lsof -i :3001

Problèmes de mémoire

Plusieurs instances consomment plus de mémoire. Surveiller l’utilisation :

# macOS
top -o mem

# Linux
htop

Conflits de pont de discussion

Assurez-vous que chaque instance utilise différents :

• Fichiers de sessions WhatsApp
• Jetons de robot Discord
• Jetons de robot Telegram
• Jetons d’espace de travail Slack

Avancé : mémoire partagée entre instances

Bien que les instances soient généralement isolées, vous pouvez créer de la mémoire partagée pour des cas d’utilisation spécifiques :

// Shared memory file
const sharedMemory = {
  userPreferences: {},
  globalContext: {}
};

// Each instance can read/write to shared file
// Useful for cross-instance coordination

Conclusion

L’exécution de plusieurs instances OpenClaw débloque des flux de travail puissants dans lesquels différents assistants gèrent différents aspects de votre vie. Que vous souhaitiez des assistants professionnels et personnels séparés, ou des agents spécialisés pour différentes tâches, la configuration multi-instance vous offre flexibilité et organisation.

Commencez avec deux instances (une personnelle, une professionnelle) et développez-les selon vos besoins. La clé est une bonne isolation : des répertoires de données séparés, des ports différents et des ponts de discussion distincts.

Pour des configurations plus avancées, consultez notre guide des compétences et notre page d’intégrations. Si vous rencontrez des problèmes, consultez notre FAQ ou explorez d’autres tutoriels.