Agents

`openclaw agents`

Administrar agentes aislados (espacios de trabajo + autenticación + enrutamiento).

Relacionado:

Enrutamiento multiagente
Espacio de trabajo del agente
Configuración de habilidades: configuración de visibilidad de habilidades.

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

Enlaces de enrutamiento

Utilice los enlaces de enrutamiento para fijar el tráfico del canal entrante a un agente específico.

Si también desea diferentes habilidades visibles por agente, configure agents.defaults.skills y agents.list[].skills en openclaw.json. Consulte Configuración de habilidades y Referencia de configuración.

Listar enlaces:

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

Agregar enlaces:

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

Si omite accountId (--bind <channel>), OpenClaw lo resuelve desde los valores predeterminados del canal y los enlaces de configuración del complemento cuando están disponibles.

Si omite --agent para bind o unbind, OpenClaw apunta al agente predeterminado actual.

Comportamiento del ámbito del enlace

Un enlace sin accountId coincide solo con la cuenta predeterminada del canal.
accountId: "*" es la alternativa para todo el canal (todas las cuentas) y es menos específico que un enlace de cuenta explícito.
Si el mismo agente ya tiene un enlace de canal coincidente sin accountId, y luego lo vincula con un accountId explícito o resuelto, OpenClaw actualiza ese enlace existente en su lugar en lugar de agregar 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 ese enlace se limita a telegram:ops. Si también desea el enrutamiento de cuenta predeterminado, agréguelo explícitamente (por ejemplo, --bind telegram:default).

Eliminar enlaces:

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 de comandos

`agents`

Ejecutar openclaw agents sin un subcomando es equivalente a openclaw agents list.

`agents list`

Opciones:

--json
--bindings: incluir reglas de enrutamiento completas, 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 flag de ad explícita 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 se puede utilizar como el nuevo id de agente.
En modo interactivo, la propagación de autenticación (auth seeding) copia solo perfiles estáticos portátiles (api_key y token estático por defecto). Los perfiles de token de actualización de OAuth permanecen disponibles solo por herencia de lectura directa (read-through) desde el almacenamiento real del agente main. Si el agente predeterminado configurado no es main, inicie sesión por separado para los perfiles de OAuth en el nuevo agente.

`agents bindings`

Opciones:

--agent <id>
--json

`agents bind`

Opciones:

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

`agents unbind`

Opciones:

--agent <id> (el valor predeterminado 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 espacio de trabajo, el estado del agente y las transcripciones de sesión se mueven a la Papelera, no se eliminan permanentemente.
Cuando se puede acceder a la Gateway, la eliminación se envía a través de la Gateway para que la limpieza de la configuración y el almacén de sesiones compartan el mismo escritor que el tráfico de tiempo de ejecución. Si no se puede acceder a la Gateway, la CLI recurre a la ruta local sin conexión.
Si el área de trabajo de otro agente es la misma ruta, está dentro de esta área de trabajo o contiene esta área de trabajo, el área de trabajo se conserva y --json informa workspaceRetained, workspaceRetainedReason y workspaceSharedWith.

Archivos de identidad

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

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

Las rutas de los avatares se resuelven en relación con la raíz del área de trabajo.

Establecer identidad

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

name
theme
emoji
avatar (ruta relativa al área 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 confía en --workspace y varios agentes comparten esa área de trabajo, el comando falla y le pide que pase --agent.
Cuando no se proporcionan campos de identidad explícitos, el comando lee los datos de identidad de 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",
        },
      },
    ],
  },
}