Saltar al contenido principal

​
openclaw agents

Administra agentes aislados (espacios de trabajo + autenticación + enrutamiento). Relacionado:

​
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

​
Asociaciones de enrutamiento

Usa asociaciones de enrutamiento para fijar el tráfico entrante de canales a un agente específico. Si también quieres diferentes Skills visibles por agente, configura agents.defaults.skills y agents.list[].skills en openclaw.json. Consulta Configuración de Skills y Referencia de configuración. Listar asociaciones: 
openclaw agents bindings
openclaw agents bindings --agent work
openclaw agents bindings --json
Añadir asociaciones: 
openclaw agents bind --agent work --bind telegram:ops --bind discord:guild-a
Si omites accountId (--bind <channel>), OpenClaw lo resuelve a partir de los valores predeterminados del canal y de los hooks de configuración del plugin cuando están disponibles. Si omites --agent en bind o unbind, OpenClaw apunta al agente predeterminado actual.

​
Comportamiento del alcance de asociación

  • Una asociación sin accountId coincide solo con la cuenta predeterminada del canal.
  • accountId: "*" es el respaldo para todo el canal (todas las cuentas) y es menos específico que una asociación de cuenta explícita.
  • Si el mismo agente ya tiene una asociación de canal coincidente sin accountId, y después haces una asociación con un accountId explícito o resuelto, OpenClaw actualiza esa asociación existente en su lugar en vez de añadir un 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 esa asociación queda limitado a telegram:ops. Si también quieres el enrutamiento de la cuenta predeterminada, añádelo explícitamente (por ejemplo --bind telegram:default). Eliminar asociaciones: 
openclaw agents unbind --agent work --bind telegram:ops
openclaw agents unbind --agent work --all
unbind acepta --all o uno o más valores --bind, pero no ambos.

​
Superficie del comando

​
agents

Ejecutar openclaw agents sin subcomando equivale a openclaw agents list.

​
agents list

Opciones:
  • --json
  • --bindings: incluye reglas completas de enrutamiento, no solo recuentos/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 indicador explícito de add cambia el comando a la ruta no interactiva.
  • El modo no interactivo requiere tanto un nombre de agente como --workspace.
  • main está reservado y no puede usarse como nuevo ID de agente.

​
agents bindings

Opciones:
  • --agent <id>
  • --json

​
agents bind

Opciones:
  • --agent <id> (usa de forma predeterminada el agente actual)
  • --bind <channel[:accountId]> (repetible)
  • --json

​
agents unbind

Opciones:
  • --agent <id> (usa de forma predeterminada el agente actual)
  • --bind <channel[:accountId]> (repetible)
  • --all
  • --json

​
agents delete <id>

Opciones:
  • --force
  • --json
Notas:
  • main no puede eliminarse.
  • Sin --force, se requiere confirmación interactiva.
  • Los directorios del espacio de trabajo, el estado del agente y la transcripción de sesión se mueven a la Papelera, no se eliminan de forma permanente.

​
Archivos de identidad

Cada espacio de trabajo del agente puede incluir un IDENTITY.md en la raíz del espacio de trabajo:
  • Ruta de ejemplo: ~/.openclaw/workspace/IDENTITY.md
  • set-identity --from-identity lee desde la raíz del espacio de trabajo (o desde un --identity-file explícito)
Las rutas de avatar se resuelven de forma relativa a la raíz del espacio de trabajo.

​
Establecer identidad

set-identity escribe campos en agents.list[].identity:
  • name
  • theme
  • emoji
  • avatar (ruta relativa al espacio de trabajo, URL http(s) o URI de datos)
Opciones:
  • --agent <id>
  • --workspace <dir>
  • --identity-file <path>
  • --from-identity
  • --name <name>
  • --theme <theme>
  • --emoji <emoji>
  • --avatar <value>
  • --json
Notas:
  • Se puede usar --agent o --workspace para seleccionar el agente de destino.
  • Si dependes de --workspace y varios agentes comparten ese espacio de trabajo, el comando falla y te pide que pases --agent.
  • Cuando no se proporcionan campos de identidad explícitos, el comando lee los datos de identidad desde IDENTITY.md.
Cargar desde IDENTITY.md: 
openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity
Anular 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",
        },
      },
    ],
  },
}