Configura tus agentes OpenClaw: Guía rápida de gestión

¿Alguna vez has sentido que gestionar varios agentes de IA es un caos? Mantener los espacios de trabajo separados, manejar diferentes autenticaciones y asegurarse de que cada mensaje llegue al agente correcto puede volverse complicado rápidamente.

Si necesitas organizar tus flujos de trabajo sin mezclar contextos, openclaw agents es la herramienta que te permite administrar agentes aislados, definiendo sus propios espacios de trabajo, autenticación y reglas de enrutamiento.

openclaw agents

Gestiona agentes aislados (workspaces + auth + routing).

Relacionado:

• Multi-agent routing: Multi-Agent Routing
• Agent workspace: Agent workspace
• Skill visibility config: Skills config

Ejemplos

openclaw agents list
openclaw agents list --bindings
openclaw agents add work --workspace ~/.openclaw/workspace-work
openclaw agents add ops --workspace ~/.openclaw/workspace-ops --bind telegram:ops --non-interactive
openclaw agents bindings
openclaw agents bind --agent work --bind telegram:ops
openclaw agents unbind --agent work --bind telegram:ops
openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity
openclaw agents set-identity --agent main --avatar avatars/openclaw.png
openclaw agents delete work

Vínculos de enrutamiento (Routing bindings)

Usa los vínculos de enrutamiento para fijar el tráfico de un canal entrante a un agente específico.

Si también quieres diferentes skills visibles por agente, configura agents.defaults.skills y agents.list[].skills en tu archivo openclaw.json. Consulta la Configuración de Skills y la Referencia de Configuración.

Listar vínculos:

openclaw agents bindings
openclaw agents bindings --agent work
openclaw agents bindings --json

Añadir vínculos:

openclaw agents bind --agent work --bind telegram:ops --bind discord:guild-a

Si omites el accountId (--bind <channel>), OpenClaw lo resuelve a partir de los valores predeterminados del canal y los hooks de configuración del plugin cuando están disponibles.

Si omites --agent para bind o unbind, OpenClaw se dirige al agente predeterminado actual.

Comportamiento del alcance de los vínculos

• Un vínculo sin accountId coincide solo con la cuenta predeterminada del canal.
• accountId: "*" funciona como un fallback para todo el canal (todas las cuentas) y es menos específico que un vínculo de cuenta explícito.
• Si el mismo agente ya tiene un vínculo de canal coincidente sin accountId y luego vinculas con un accountId explícito o resuelto, OpenClaw actualiza ese vínculo existente en su lugar en vez de añadir uno duplicado.

Ejemplo:

# initial channel-only binding
openclaw agents bind --agent work --bind telegram

# later upgrade to account-scoped binding
openclaw agents bind --agent work --bind telegram:ops

Después de la actualización, el enrutamiento para ese vínculo se limita a telegram:ops. Si también quieres enrutamiento para la cuenta predeterminada, añádelo explícitamente (por ejemplo, --bind telegram:default).

Eliminar vínculos:

openclaw agents unbind --agent work --bind telegram:ops
openclaw agents unbind --agent work --all

unbind acepta o bien --all o uno o más valores --bind, pero no ambos.

Interfaz de comandos (Command surface)

agents

Ejecutar openclaw agents sin ningún subcomando es equivalente a openclaw agents list.

agents list

Opciones:

• --json
• --bindings: incluye las reglas de enrutamiento completas, no solo los conteos o resúmenes por agente.

agents add [name]

Opciones:

• --workspace <dir>
• --model <id>
• --agent-dir <dir>
• --bind <channel[:accountId]> (repetible)
• --non-interactive
• --json

Notas:

• Pasar cualquier flag explícito de add cambia el comando a la ruta no interactiva.
• El modo no interactivo requiere tanto un nombre de agente como el flag --workspace.
• main está reservado y no puede usarse como un nuevo ID de agente.

agents bindings

Opciones:

• --agent <id>
• --json

agents bind

Opciones:

• --agent <id> (por defecto es el agente predeterminado actual)
• --bind <channel[:accountId]> (repetible)
• --json

agents unbind

Opciones:

• --agent <id> (por defecto es el agente predeterminado actual)
• --bind <channel[:accountId]> (repetible)
• --all
• --json

agents delete <id>

Opciones:

• --force
• --json

Notas:

• main no se puede eliminar.
• Sin --force, se requiere confirmación interactiva.
• Los directorios del workspace, el estado del agente y los transcritos de sesión se mueven a la Papelera, no se eliminan de forma permanente.

Archivos de identidad (Identity files)

Cada workspace de agente puede incluir un archivo IDENTITY.md en la raíz:

• Ejemplo de ruta: ~/.openclaw/workspace/IDENTITY.md
• set-identity --from-identity lee desde la raíz del workspace (o desde un --identity-file explícito).

Las rutas de los avatares se resuelven de forma relativa a la raíz del workspace.

Configurar identidad (Set identity)

set-identity escribe campos en agents.list[].identity:

• name
• theme
• emoji
• avatar (ruta relativa al workspace, URL http(s) o data URI)

Opciones:

• --agent <id>
• --workspace <dir>
• --identity-file <path>
• --from-identity
• --name <name>
• --theme <theme>
• --emoji <emoji>
• --avatar <value>
• --json

Notas:

• Puedes usar --agent o --workspace para seleccionar el agente objetivo.
• Si usas --workspace y varios agentes comparten ese mismo espacio, el comando fallará y te pedirá que pases el ID con --agent.
• Cuando no se proporcionan campos de identidad explícitos, el comando lee los datos desde IDENTITY.md.

Cargar desde IDENTITY.md:

openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity

Sobrescribir campos explícitamente:

openclaw agents set-identity --agent main --name "OpenClaw" --emoji "🦞" --avatar avatars/openclaw.png

Ejemplo de configuración:

{
  agents: {
    list: [
      {
        id: "main",
        identity: {
          name: "OpenClaw",
          theme: "space lobster",
          emoji: "🦞",
          avatar: "avatars/openclaw.png",
        },
      },
    ],
  },
}

Pasos siguientes

• Aprende más sobre el Enrutamiento Multi-Agente.
• Configura tus Skills para cada agente.

AI Setup Assistant