OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Modo elevado

Cuando un agente se ejecuta dentro de un entorno aislado, sus comandos exec quedan confinados al entorno aislado. El modo elevado permite que el agente salga de él y ejecute comandos fuera del entorno aislado, con controles de aprobación configurables.

Directivas

Controla el modo elevado por sesión con comandos de barra:

Directiva Qué hace
/elevated on Ejecuta fuera del entorno aislado en la ruta del host configurada y mantiene las aprobaciones
/elevated ask Igual que on (alias)
/elevated full Ejecuta fuera del entorno aislado en la ruta del host configurada y omite las aprobaciones cuando la política de aprobación del modo/host ya es permisiva
/elevated off Vuelve a la ejecución confinada al entorno aislado

También está disponible como /elev on|off|ask|full.

Envía /elevated sin argumentos para ver el nivel actual.

Cómo funciona

  • Comprobar la disponibilidad

    El modo elevado debe estar habilitado en la configuración y el remitente debe estar en la lista de permitidos:

    json5
    {  tools: {    elevated: {      enabled: true,      allowFrom: {        discord: ["user-id-123"],        whatsapp: ["+15555550123"],      },    },  },}

  • Establecer el nivel

    Envía un mensaje que solo contenga la directiva para establecer el valor predeterminado de la sesión:

    Code
    /elevated full

    O úsala en línea (se aplica únicamente a ese mensaje):

    Code
    /elevated on run the deployment script

  • Los comandos se ejecutan fuera del entorno aislado

    Con el modo elevado activo, las llamadas a exec salen del entorno aislado. El host efectivo es gateway de forma predeterminada, o node cuando el destino de ejecución configurado o de la sesión es node. En el modo full, las aprobaciones de ejecución se omiten cuando la política resuelta de aprobación del modo/host de ejecución ya es completamente permisiva (seguridad full, solicitud off); de lo contrario, se sigue aplicando la política de aprobación normal. En el modo on/ask, siempre se aplican las reglas de aprobación configuradas.

    • Orden de resolución

    1. Directiva en línea en el mensaje (se aplica únicamente a ese mensaje)
    2. Anulación de la sesión (se establece enviando un mensaje que solo contenga la directiva)
    3. Valor predeterminado global (agents.defaults.elevatedDefault en la configuración)

    Disponibilidad y listas de permitidos

    • Control global: tools.elevated.enabled (debe ser true)
    • Lista de remitentes permitidos: tools.elevated.allowFrom con listas por canal
    • Control por agente: agents.list[].tools.elevated.enabled (solo puede imponer más restricciones; tanto el control global como el control por agente deben ser true)
    • Lista de permitidos por agente: agents.list[].tools.elevated.allowFrom (el remitente debe coincidir tanto con la lista global como con la del agente)
    • Lista de permitidos alternativa proporcionada por el canal: los plugins de canal pueden proporcionar opcionalmente una lista de permitidos alternativa mediante un enlace de adaptador del SDK, que se utiliza cuando tools.elevated.allowFrom.<provider> no está configurado. Actualmente ningún canal incluido implementa este enlace, por lo que, en la práctica, hoy cada proveedor necesita una entrada explícita tools.elevated.allowFrom.<provider>.
    • Deben superarse todos los controles; de lo contrario, el modo elevado se considera no disponible

    Formatos de las entradas de la lista de permitidos:

    Prefijo Coincide con
    (ninguno) ID del remitente, E.164 o campo From
    name: Nombre mostrado del remitente
    username: Nombre de usuario del remitente
    tag: Etiqueta del remitente
    id:, from:, e164: Identidad especificada explícitamente

    Qué no controla el modo elevado

    • Política de herramientas: si la política de herramientas deniega exec, el modo elevado no puede anularla.
    • Política de selección del host: el modo elevado no convierte auto en una anulación libre entre hosts. Utiliza las reglas de destino de ejecución configuradas o de la sesión y elige node únicamente cuando el destino ya es node.
    • Independiente de /exec: la directiva /exec ajusta los valores predeterminados de ejecución por sesión (host, seguridad, solicitud, nodo) para remitentes autorizados y no requiere el modo elevado.

    Relacionado

    Herramienta Exec

    Ejecución de comandos de shell desde el agente.
    Aprobaciones de Exec

    Sistema de aprobación y listas de permitidos para exec.
    Aislamiento

    Configuración del entorno aislado a nivel del Gateway.
    Entorno aislado frente a política de herramientas frente a modo elevado

    Cómo se combinan los tres controles durante una llamada a una herramienta.
    Was this useful?
    On this page

    On this page