Enrutamiento Multi-Agent con OpenClaw

¿Alguna vez has intentado ejecutar varios agentes de IA al mismo tiempo y has terminado con un lío de archivos de configuración o sesiones mezcladas? Mantener la identidad de cada bot separada mientras usas diferentes cuentas de mensajería suele ser un problema técnico que complica el escalado de tus proyectos.

Tener un sistema donde cada agente tenga su propio “cerebro” y reglas claras de a quién responder es fundamental para evitar que los datos de un usuario terminen en el contexto de otro. Aquí te explico cómo manejar múltiples agentes en un solo Gateway de forma limpia.

Requisitos previos

• Una instancia de Gateway en ejecución.
• Acceso al archivo de configuración openclaw.json.

Inicio rápido

Para añadir un nuevo agente aislado de forma rápida, usa el asistente integrado:

1. Ejecuta el comando para crear el agente:

   openclaw agents add work

2. Define los bindings para dirigir los mensajes entrantes.
3. Verifica que todo esté correcto con:

   openclaw agents list --bindings

Conceptos clave

Un agent en OpenClaw es un cerebro totalmente independiente que incluye:

• Workspace: Sus propios archivos (AGENTS.md, SOUL.md, notas locales).
• State directory (agentDir): Perfiles de autenticación y configuración específica.
• Session store: Historial de chat y estado de enrutamiento en ~/.openclaw/agents/<agentId>/sessions.

Es importante que no reutilices el agentDir entre diferentes agentes, ya que esto causará colisiones en la autenticación y en las sesiones. Si necesitas compartir credenciales, copia el archivo auth-profiles.json al agentDir del otro agente.

Reglas de enrutamiento

El Gateway decide a qué agente enviar un mensaje siguiendo un orden determinista donde la regla más específica siempre gana:

1. Coincidencia por peer (ID exacto de DM, grupo o canal).
2. guildId (en el caso de Discord).
3. teamId (en el caso de Slack).
4. Coincidencia por accountId de un canal.
5. Coincidencia a nivel de canal (accountId: "*").
6. Agente por defecto (el marcado como default o el primero de la lista).

Ejemplo: Dos cuentas de WhatsApp para dos agentes

Si tienes una cuenta personal y otra de trabajo en el mismo Gateway, puedes usar este archivo ~/.openclaw/openclaw.json:

{
  agents: {
    list: [
      {
        id: "home",
        default: true,
        name: "Home",
        workspace: "~/.openclaw/workspace-home",
        agentDir: "~/.openclaw/agents/home/agent",
      },
      {
        id: "work",
        name: "Work",
        workspace: "~/.openclaw/workspace-work",
        agentDir: "~/.openclaw/agents/work/agent",
      },
    ],
  },

  bindings: [
    { agentId: "home", match: { channel: "whatsapp", accountId: "personal" } },
    { agentId: "work", match: { channel: "whatsapp", accountId: "biz" } },

    {
      agentId: "work",
      match: {
        channel: "whatsapp",
        accountId: "personal",
        peer: { kind: "group", id: "1203630...@g.us" },
      },
    },
  ],

  tools: {
    agentToAgent: {
      enabled: false,
      allow: ["home", "work"],
    },
  },

  channels: {
    whatsapp: {
      accounts: {
        personal: {},
        biz: {},
      },
    },
  },
}

Sandbox y herramientas por agente

Desde la versión v2026.1.6, puedes definir restricciones de seguridad y herramientas específicas para cada agente. Esto te permite tener un agente con acceso total y otro limitado para invitados o grupos públicos.

{
  agents: {
    list: [
      {
        id: "personal",
        workspace: "~/.openclaw/workspace-personal",
        sandbox: {
          mode: "off",
        },
      },
      {
        id: "family",
        workspace: "~/.openclaw/workspace-family",
        sandbox: {
          mode: "all",
          scope: "agent",
          docker: {
            setupCommand: "apt-get update && apt-get install -y git curl",
          },
        },
        tools: {
          allow: ["read"],
          deny: ["exec", "write", "edit", "apply_patch"],
        },
      },
    ],
  },
}

Solución de problemas

• Colisiones de sesión: Si notas que un agente responde con el contexto de otro, revisa que no estén compartiendo el mismo agentDir. Cada agentId debe tener su propia ruta de estado.
• Mensajes que no llegan: Verifica el orden de tus bindings. Recuerda que el Gateway usa el primer match que encuentra; pon las reglas de peer específicas arriba de las reglas generales de canal.

¿Necesitas ayuda para configurar tus agentes? Prueba el AI Setup Assistant.

Próximos pasos

• Sandboxing en el Gateway
• Skills: por agente vs compartidas