Ejecución de múltiples instancias de OpenClaw: Guía de configuración de múltiples agentes

Introducción

La mayoría de los usuarios de OpenClaw comienzan con una sola instancia: un asistente de IA que se encarga de todas sus necesidades. Pero ¿qué pasa si quieres ejecutar varias instancias? Quizás desee asistentes separados para el trabajo y la vida personal, o desee clonarse en varios agentes especializados. Esta guía avanzada le muestra cómo configurar y administrar múltiples instancias de OpenClaw simultáneamente.

Un usuario, Brosef, se clonó a sí mismo en tres instancias distintas de OpenClaw, cada una con diferentes personalidades y capacidades. Este enfoque de múltiples agentes desbloquea poderosos flujos de trabajo en los que diferentes asistentes manejan diferentes aspectos de su vida.

¿Por qué ejecutar varias instancias?

Antes de profundizar en la configuración técnica, exploremos por qué es posible que desee varias instancias de OpenClaw:

Contextos separados

Cada instancia mantiene su propia memoria y contexto. Esto significa:

• Asistente de trabajo: recuerda preferencias, proyectos y contactos relacionados con el trabajo
• Asistente personal: se encarga de tareas personales, seguimiento de la salud y pasatiempos.
• Asistente de desarrollo: se centra en codificación, GitHub y flujos de trabajo técnicos.

Diferentes personas

Puedes configurar cada instancia con una personalidad diferente:

• Un asistente profesional y formal para comunicaciones comerciales.
• Un asistente informal y amigable para conversaciones personales.
• Un asistente técnico centrado en el código para tareas de desarrollo.

Gestión de recursos

La ejecución de varias instancias le permite:

• Utilice diferentes modelos de IA para diferentes tareas (Claude para escribir, GPT para codificar)
• Distribuir la carga entre instancias.
• Aislar fallas (si una instancia falla, otras continúan)

Organización multicanal

Con varias instancias, puedes:

• Asigna diferentes bots de Discord a diferentes servidores
• Utilice números de WhatsApp separados para diferentes propósitos
• Organizar los bots de Telegram por función

Requisitos previos

Antes de configurar varias instancias, asegúrese de tener:

• OpenClaw instalado (consulte nuestra guía de instalación)
• Comprensión básica de las operaciones de línea de comandos.
• Recursos suficientes del sistema (cada instancia utiliza memoria y CPU)
• Múltiples claves API si se utilizan diferentes modelos de IA

Método 1: clonar el repositorio

El método más sencillo es clonar OpenClaw en directorios separados, cada uno con su propia configuración.

Paso 1: clonar varios directorios

# 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

Paso 2: Configurar directorios de datos separados

Cada instancia necesita su propio directorio de datos para evitar conflictos. Edite el archivo de configuración en cada caso:

# 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

Paso 3: Configurar diferentes puertos

Si ejecuta instancias simultáneamente, asigne diferentes puertos:

# Instance 1
PORT=3000

# Instance 2
PORT=3001

# Instance 3
PORT=3002

Paso 4: configurar diferentes puentes de chat

Configure cada instancia para conectarse a diferentes plataformas o cuentas de chat:

Instancia personal (WhatsApp):

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

Instancia de trabajo (Discord):

DISCORD_ENABLED=true
DISCORD_BOT_TOKEN=your_work_bot_token
DISCORD_GUILD_ID=your_work_server_id

** Instancia de desarrollo (Telegram): **

TELEGRAM_ENABLED=true
TELEGRAM_BOT_TOKEN=your_dev_bot_token

Método 2: uso de variables de entorno

En lugar de clonar varias veces, puede ejecutar una única instalación con diferentes configuraciones de entorno.

Crear scripts de lanzamiento

Cree scripts de lanzamiento separados para cada instancia:

lanzamiento-personal.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

lanzamiento-trabajo.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

Hacer que los scripts sean ejecutables:

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

Creando diferentes personas

Cada instancia puede tener una personalidad única definida en su configuración. A continuación se explica cómo personalizar las personas:

Asistente personal Persona

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 del asistente de trabajo

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.

Persona del asistente de desarrollo

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.

Configuración de múltiples robots de DiscordLa ejecución de varios bots de Discord desde el mismo servidor requiere una configuración cuidadosa.

Paso 1: Crear múltiples aplicaciones de Discord

1. Vaya al Portal para desarrolladores de Discord
2. Cree aplicaciones separadas para cada bot:
   • Robot personal
   • Robot de trabajo
   • Robot de desarrollo

Paso 2: Generar tokens de bot

Cada aplicación obtiene su propio token de bot. Guárdelos de forma segura:

# .env for personal instance
DISCORD_BOT_TOKEN=personal_bot_token_here

# .env for work instance
DISCORD_BOT_TOKEN=work_bot_token_here

Paso 3: Configurar ID de gremio

Si quieres bots en diferentes servidores:

# Personal bot in personal server
DISCORD_GUILD_ID=personal_server_id

# Work bot in work server
DISCORD_GUILD_ID=work_server_id

Paso 4: invitar bots a los servidores

Utilice el generador de URL OAuth2 de Discord para invitar a cada bot con los permisos adecuados:

• Leer mensajes
• Enviar mensajes
• Administrar mensajes (si es necesario)
• Leer el historial de mensajes

Gestión de instancias simultáneas

Uso de administradores de procesos

Para configuraciones de producción, utilice un administrador de procesos como 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

Usando Docker Compose

Para implementaciones en contenedores:

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

Ejemplo del mundo real: configuración de Brosef

Brosef se clonó a sí mismo en tres instancias:

1. Personal Brosef: maneja las tareas diarias, el seguimiento de la salud y las comunicaciones personales.
2. Work Brosef: gestiona las comunicaciones comerciales, el calendario y los proyectos de trabajo.
3. Dev Brosef: se centra en GitHub, revisiones de código y flujos de trabajo técnicos.

Cada instancia:

• Utiliza diferentes plataformas de chat (WhatsApp, Discord, Telegram)
• Tiene memoria y contexto distintos.
• Ejecuta diferentes habilidades e integraciones.
• Funciona de forma independiente

Esta configuración permite a Brosef mantener contextos separados mientras aprovecha las mismas capacidades subyacentes de IA.

Mejores prácticas

Gestión de recursos

• Monitorear el uso de CPU y memoria en todas las instancias.
• Considere el uso de diferentes modelos de IA para diferentes instancias (modelos más livianos para tareas simples)
• Utilice administradores de procesos para reiniciar instancias fallidas automáticamente

Aislamiento de datos

• Mantenga los directorios de datos completamente separados
• Utilice diferentes claves API para diferentes instancias
• Realice copias de seguridad periódicas de los datos de cada instancia de forma independiente

Seguridad

• Utilice credenciales diferentes para cada instancia
• Limitar el acceso al sistema de archivos por instancia
• Utilice variables de entorno para configuraciones sensibles

Monitoreo

• Configurar el registro para cada instancia
• Monitorear el uso de API por instancia
• Realice un seguimiento de las métricas de rendimiento por separado

Solución de problemas

Conflictos portuarios

Si las instancias no pueden iniciarse, verifique si hay conflictos de puertos:

lsof -i :3000
lsof -i :3001

Problemas de memoria

Varias instancias consumen más memoria. Monitorear el uso:

# macOS
top -o mem

# Linux
htop

Conflictos del puente de chat

Asegúrese de que cada instancia utilice diferentes:

• Archivos de sesión de WhatsApp
• Fichas de bot de Discord
• Fichas de bot de Telegram
• Fichas de espacio de trabajo flojo

Avanzado: Memoria compartida entre instancias

Si bien las instancias suelen estar aisladas, puedes crear memoria compartida para casos de uso específicos:

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

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

Conclusión

La ejecución de múltiples instancias de OpenClaw desbloquea poderosos flujos de trabajo donde diferentes asistentes manejan diferentes aspectos de su vida. Ya sea que desee asistentes personales y de trabajo separados, o agentes especializados para diferentes tareas, la configuración de instancias múltiples le brinda flexibilidad y organización.

Comience con dos instancias (una personal y otra laboral) y amplíelas según sea necesario. La clave es un aislamiento adecuado: directorios de datos separados, diferentes puertos y distintos puentes de chat.

Para configuraciones más avanzadas, consulte nuestra guía de habilidades y la página de integraciones. Si tiene problemas, visite nuestras Preguntas frecuentes o explore otros tutoriales.