Executando múltiplas instâncias OpenClaw: Guia de configuração multiagente

Introdução

A maioria dos usuários do OpenClaw começa com uma única instância – um assistente de IA que cuida de todas as suas necessidades. Mas e se você quiser executar várias instâncias? Talvez você queira assistentes separados para trabalho e vida pessoal, ou queira clonar-se em vários agentes especializados. Este guia avançado mostra como configurar e gerenciar várias instâncias do OpenClaw simultaneamente.

Um usuário, Brosef, clonou-se em três instâncias distintas do OpenClaw, cada uma com personalidades e capacidades diferentes. Essa abordagem multiagente desbloqueia fluxos de trabalho poderosos, onde diferentes assistentes lidam com diferentes aspectos da sua vida.

Por que executar múltiplas instâncias?

Antes de mergulhar na configuração técnica, vamos explorar por que você pode querer várias instâncias do OpenClaw:

Contextos separados

Cada instância mantém sua própria memória e contexto. Isso significa:

• Assistente de Trabalho — Lembra preferências, projetos e contatos relacionados ao trabalho
• Assistente Pessoal — Cuida de tarefas pessoais, monitoramento de saúde e hobbies
• Assistente de Desenvolvimento — Concentra-se em codificação, GitHub e fluxos de trabalho técnicos

Personas Diferentes

Você pode configurar cada instância com uma personalidade diferente:

• Um assistente profissional e formal para comunicações empresariais
• Um assistente casual e amigável para bate-papos pessoais
• Um assistente técnico focado em código para tarefas de desenvolvimento

Gerenciamento de recursos

A execução de várias instâncias permite:

• Use diferentes modelos de IA para diferentes tarefas (Claude para escrita, GPT para codificação)
• Distribuir carga entre instâncias
• Isolar falhas (se uma instância travar, outras continuam)

Organização multicanal

Com várias instâncias, você pode:

• Atribua diferentes bots Discord a diferentes servidores
• Use números separados do WhatsApp para finalidades diferentes
• Organize bots do Telegram por função

Pré-requisitos

Antes de configurar várias instâncias, certifique-se de ter:

• OpenClaw instalado (consulte nosso guia de instalação)
• Compreensão básica de operações de linha de comando
• Recursos de sistema suficientes (cada instância usa memória e CPU)
• Várias chaves de API se estiver usando diferentes modelos de IA

Método 1: Clonando o Repositório

A abordagem mais direta é clonar o OpenClaw em diretórios separados, cada um com sua própria configuração.

Etapa 1: clonar vários diretórios

# 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

Etapa 2: Configurar diretórios de dados separados

Cada instância precisa de seu próprio diretório de dados para evitar conflitos. Edite o arquivo de configuração em cada instância:

# 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

Etapa 3: Configurar portas diferentes

Se estiver executando instâncias simultaneamente, atribua portas diferentes:

# Instance 1
PORT=3000

# Instance 2
PORT=3001

# Instance 3
PORT=3002

Etapa 4: configurar diferentes pontes de bate-papo

Configure cada instância para se conectar a diferentes plataformas ou contas de chat:

Instância Pessoal (WhatsApp):

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

Instância de trabalho (Discord):

DISCORD_ENABLED=true
DISCORD_BOT_TOKEN=your_work_bot_token
DISCORD_GUILD_ID=your_work_server_id

Instância de desenvolvimento (Telegrama):

TELEGRAM_ENABLED=true
TELEGRAM_BOT_TOKEN=your_dev_bot_token

Método 2: usando variáveis de ambiente

Em vez de clonar diversas vezes, você pode executar uma única instalação com diferentes configurações de ambiente.

Criar scripts de lançamento

Crie scripts de inicialização separados para cada instância:

launch-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

launch-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

Torne os scripts executáveis:

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

Criando Personas Diferentes

Cada instância pode ter uma personalidade única definida em sua configuração. Veja como personalizar personas:

Personagem de assistente pessoal

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 de Assistente de Trabalho

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 Assistente de Desenvolvimento

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.

Configuração do Discord Multi-BotA execução de vários bots Discord no mesmo servidor requer uma configuração cuidadosa.

Etapa 1: Crie vários aplicativos Discord

1. Vá para Portal do desenvolvedor Discord
2. Crie aplicativos separados para cada bot:
   • Bot pessoal
   • Bot de trabalho
   • Desenvolvedor Bot

Etapa 2: Gerar tokens de bot

Cada aplicativo recebe seu próprio token de bot. Armazene-os com segurança:

# .env for personal instance
DISCORD_BOT_TOKEN=personal_bot_token_here

# .env for work instance
DISCORD_BOT_TOKEN=work_bot_token_here

Etapa 3: Configurar IDs de guilda

Se você quiser bots em servidores diferentes:

# Personal bot in personal server
DISCORD_GUILD_ID=personal_server_id

# Work bot in work server
DISCORD_GUILD_ID=work_server_id

Etapa 4: convidar bots para servidores

Use o gerador de URL OAuth2 do Discord para convidar cada bot com as permissões apropriadas:

• Ler mensagens
• Enviar mensagens
• Gerenciar mensagens (se necessário)
• Leia o histórico de mensagens

Gerenciando instâncias simultâneas

Usando gerenciadores de processos

Para configurações de produção, use um gerenciador de processos 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 implantações em contêineres:

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

Exemplo do mundo real: configuração de Brosef

Brosef se clonou em três instâncias:

1. Personal Brosef – Lida com tarefas diárias, monitoramento de saúde e comunicações pessoais
2. Work Brosef — Gerencia comunicações empresariais, calendário e projetos de trabalho
3. Dev Brosef — Concentra-se no GitHub, revisões de código e fluxos de trabalho técnicos

Cada instância:

• Utiliza diferentes plataformas de chat (WhatsApp, Discord, Telegram)
• Possui memória e contexto distintos
• Executa diferentes habilidades e integrações
• Opera de forma independente

Esta configuração permite que Brosef mantenha contextos separados enquanto aproveita os mesmos recursos subjacentes de IA.

Melhores práticas

Gerenciamento de recursos

• Monitore o uso de CPU e memória entre instâncias
• Considere usar diferentes modelos de IA para diferentes instâncias (modelos mais leves para tarefas simples)
• Use gerenciadores de processos para reiniciar instâncias com falha automaticamente

Isolamento de dados

• Mantenha os diretórios de dados completamente separados
• Use chaves de API diferentes para instâncias diferentes
• Faça backup regularmente dos dados de cada instância de forma independente

Segurança

• Use credenciais diferentes para cada instância
• Limitar o acesso ao sistema de arquivos por instância
• Use variáveis de ambiente para configuração sensível

Monitoramento

• Configure o registro para cada instância
• Monitore o uso da API por instância
• Acompanhe as métricas de desempenho separadamente

Solução de problemas

Conflitos portuários

Se as instâncias não puderem ser iniciadas, verifique se há conflitos de porta:

lsof -i :3000
lsof -i :3001

Problemas de memória

Várias instâncias consomem mais memória. Monitore o uso:

# macOS
top -o mem

# Linux
htop

Conflitos de ponte de bate-papo

Certifique-se de que cada instância use diferentes:

• Arquivos de sessão do WhatsApp
• Tokens de bot Discord
• Tokens de bot de telegrama
• Tokens de espaço de trabalho do Slack

Avançado: memória compartilhada entre instâncias

Embora as instâncias normalmente sejam isoladas, você pode criar memória compartilhada 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

Conclusão

A execução de várias instâncias do OpenClaw desbloqueia fluxos de trabalho poderosos, onde diferentes assistentes lidam com diferentes aspectos da sua vida. Se você deseja assistentes pessoais e de trabalho separados ou agentes especializados para tarefas diferentes, a configuração de várias instâncias oferece flexibilidade e organização.

Comece com duas instâncias – uma pessoal e uma profissional – e expanda conforme necessário. A chave é o isolamento adequado: diretórios de dados separados, portas diferentes e pontes de bate-papo distintas.

Para configurações mais avançadas, confira nosso guia de habilidades e página de integrações. Se você tiver problemas, visite nossas FAQ ou explore outros tutoriais.