openclaw agents

Gestiona agentes aislados (workspaces + autenticación + enrutamiento).

Relacionado:

• Enrutamiento multi-agente: Multi-Agent Routing
• Workspace de agente: Agent workspace

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

Bindings de enrutamiento

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

Listar bindings:

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

Agregar bindings:

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

Si omites accountId (--bind <channel>), OpenClaw lo resuelve desde los valores por defecto del canal y los hooks de configuración de plugins cuando estén disponibles.

Comportamiento del alcance de bindings

• Un binding sin accountId solo coincide con la cuenta por defecto del canal.
• accountId: "*" es el fallback de todo el canal (todas las cuentas) y es menos específico que un binding de cuenta explícito.
• Si el mismo agente ya tiene un binding de canal coincidente sin accountId, y luego haces un bind con un accountId explícito o resuelto, OpenClaw actualiza ese binding existente en su lugar en vez de agregar un duplicado.

Ejemplo:

# binding inicial solo por canal
openclaw agents bind --agent work --bind telegram

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

Después de la actualización, el enrutamiento para ese binding tiene alcance a telegram:ops. Si también quieres enrutamiento de cuenta por defecto, agrégalo explícitamente (por ejemplo --bind telegram:default).

Eliminar bindings:

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

Archivos de identidad

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

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

Las rutas de avatar se resuelven relativas a la raíz del workspace.

Configurar identidad

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

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

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