Comandos CLI

agents

Gestiona agentes aislados (espacio de trabajo + autenticación + enrutamiento). Relacionado:

Enrutamiento multi-agente: Enrutamiento Multi-Agente
Espacio de trabajo del agente: Espacio de trabajo del agente

Ejemplos

openclaw agents list
openclaw agents add work --workspace ~/.openclaw/workspace-work
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

Enlaces de enrutamiento

Usa enlaces de enrutamiento para dirigir el tráfico entrante de un canal a un agente específico. Lista los enlaces:

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

Añade enlaces:

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 los hooks de configuración del plugin cuando están disponibles.

Comportamiento del alcance del enlace

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

Ejemplo:

# enlace inicial solo para el canal
openclaw agents bind --agent work --bind telegram

# actualización posterior a un enlace con alcance de cuenta
openclaw agents bind --agent work --bind telegram:ops

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

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

Archivos de identidad

Cada espacio de trabajo de 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 los avatares se resuelven relativas 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)

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",
        },
      },
    ],
  },
}

agent approvals