Endurecimiento de seguridad (2): permisos de herramientas y sandbox
Objetivo en una frase: cambiar los agent que procesan contenido no confiable de «acceso total por defecto» a «mínimo privilegio + aprobación manual + sandbox de OpenClaw», de modo que las herramientas de alto riesgo ni siquiera puedan invocarse.
Aviso de seguridad GHSA-pw3x-g8v8-fvj2: la versión base de esta lección, 2026.10.9, está afectada; actualiza primero
2026-11-19, OpenClaw publicó un aviso de gravedad alta (CVSS 8.8): "delegation could skip approval for restricted agents". Incluso cuando la política de herramientas ya prohíbe ejecutar comandos y escribir archivos, la herramienta openclaw aún podía escribir configuración persistente sin aprobación, lo que permitía a un agente restringido abrir la ejecución de comandos en el host.
- Versiones afectadas: ≥ 2026.9.2 y < 2026.10.33, además de 2026.11.1 ~ 2026.11.3. Esta lección está escrita según 2026.10.9, que está dentro del rango afectado.
- Versiones corregidas: en el canal stable, actualiza a 2026.11.4 o superior; en el canal extended-stable, actualiza a 2026.10.33.
- Mitigación temporal antes de actualizar: establece
tools.exec.modeenasky rechaza cambios de delegación no confiables.
Usa primero openclaw --version para ver tu versión. Para saber cómo elegir un canal, actualizar y revertir, consulta actualización y canales de versión. Texto original del aviso: https://github.com/openclaw/openclaw/security/advisories/GHSA-pw3x-g8v8-fvj2
Preparación
- Haber completado la lección anterior«Endurecimiento de seguridad (1): control de acceso e identidad», con el Gateway funcionando con normalidad.
- Poder editar el archivo de configuración del Gateway y saber con claridad qué agent entrarán en contacto con contenido externo (mensajes de chat, páginas web, archivos). Los agent que usan control del navegador (véase «Control del navegador: deja que Claw navegue y opere por ti») cuentan especialmente.
- Distinguir dos tipos de límites:
denyes una denegación directa; la aprobación es otra capa dentro del modo restringido, y ambas se aplican de forma acumulativa.
Sígueme paso a paso
Paso 1: denegar por defecto herramientas de alto riesgo
Para cualquier agent o superficie (surface) que entre en contacto con contenido no confiable, añade una lista deny en la configuración:
{
tools: {
deny: ["gateway", "cron", "sessions_spawn", "sessions_send"],
},
}La razón viene de la documentación oficial: gateway puede leer la configuración (posiblemente exponiendo secretos y la topología de hosts), iniciar actualizaciones, reiniciar y limpiar copias de reversión; las tareas programadas creadas por cron siguen ejecutándose después de que termine la sesión original; sessions_spawn y sessions_send implican derivación entre sesiones y transmisión de mensajes.
Resultado esperado: cuando ese agent invoque estas cuatro herramientas, se le deniega directamente, sin siquiera entrar en el flujo de aprobación.
Paso 2: cerrar las entradas de comandos de reinicio y actualización
En la configuración, pon commands.restart en false para bloquear también a nivel de comandos:
{
commands: {
restart: false,
},
}Resultado esperado: /restart, /update, las acciones de actualización/reinicio del gateway desde chats externos y las solicitudes externas de reinicio vía SIGUSR2 quedan todas inutilizadas. Nota: la limpieza (cleanup) no detiene el Gateway ni depende de este interruptor; pasa por las puertas de owner/operator y de política de herramientas.
Paso 3: poner las ejecuciones restringidas en el sandbox de OpenClaw
El sandbox de OpenClaw está desactivado por defecto: si no se configura agents.defaults.sandbox (global) ni agents.entries.*.sandbox (para un agent individual), la ejecución de herramientas corre directamente en la máquina host. Al activarlo, el proceso del Gateway permanece en el host y solo la ejecución de herramientas se traslada al backend del sandbox. La documentación oficial también aclara que no es un límite de seguridad perfecto, pero puede limitar de forma sustancial su acceso al sistema de archivos y a los procesos cuando el modelo comete errores.
Primero añade una configuración mínima de activación:
{
agents: {
defaults: {
sandbox: {
mode: "non-main", // 群/渠道等非主会话进沙箱
scope: "session", // 沙箱环境按会话隔离
workspaceAccess: "none", // 沙箱对 agent workspace 无访问权限
},
},
},
}¿Solo quieres activarlo para un agent que toca contenido no confiable? Escribe el mismo bloque sandbox bajo agents.entries.<id>.sandbox.
Hay que distinguir la relación entre las dos capas: la política de herramientas se aplica antes que las reglas del sandbox, así que las herramientas denegadas en el paso 1 no reviven por entrar en el sandbox; a la inversa, tools.elevated es una vía de escape explícita que permite que exec se ejecute fuera del sandbox; no lo actives en ese tipo de agent.
El sandbox y la aprobación también se acumulan: si pones el modo de permisos de sesión de ese agent en restringido (restricted, es decir, modos como read-only, guarded o workspace, distintos de Full Access), sus solicitudes de cambios en la configuración persistente o en el ciclo de vida requerirán aprobación manual; los cambios permitidos bajo Full Access (incluido Default) se ejecutan directamente sin aprobación.
Las cuatro categorías de restricciones (herramientas, sistema de archivos, sandbox y operaciones) son independientes entre sí y se aplican de forma acumulativa; además, el host vuelve a validar los permisos en tiempo real antes de ejecutar.
Los backends de sandbox de @@I18N_KEEP_000022@@ incluyen docker, podman, ssh, openshell, crabbox, etc.; las opciones de configuración concretas y los niveles de aislamiento de cada backend quedan fuera del alcance de esta recopilación, así que consulta la página correspondiente del sandbox en docs.openclaw.ai (docs/gateway/sandboxing/ y sus subpáginas).
Una vez configurado, confirma con la CLI que el sandbox realmente funciona:
openclaw sandbox list # 列出沙箱容器、状态与对应会话/agent
openclaw sandbox explain --agent <agent-id> # 查看生效的沙箱模式、workspace 与工具策略Resultado esperado: la ejecución de herramientas de ese agent ocurre dentro del sandbox, con acceso restringido al sistema de archivos y a los procesos del host; sus solicitudes de cambios en la configuración persistente o en el ciclo de vida muestran una aprobación manual; con openclaw sandbox list puedes ver el contenedor de sandbox correspondiente. Aunque alguna capa de restricción se omita, las demás siguen en pie.
Verificación
Prueba uno por uno:
- Haz que un agent restringido invoque
gatewaypara leer la configuración → denegado directamente por la lista deny. - Envía
/restart→ aparece un aviso de que está deshabilitado o no hay respuesta. - Haz que un agent restringido solicite un cambio en la configuración persistente → aparece una aprobación manual en lugar de ejecutarse directamente.
- Haz que ese agent ejecute una herramienta en una sesión de grupo/canal (por ejemplo, capturar una página web) y luego ejecuta
openclaw sandbox list→ en la lista aparecen su contenedor de sandbox y su estado.
Errores comunes
- Tratar deny como «requiere aprobación»: deny es una denegación dura; la aprobación solo ocurre dentro de lo permitido en modo restringido, no las mezcles.
- Creer que desactivar
commands.restartbloquea las actualizaciones: las acciones de mantenimiento como la limpieza (cleanup) no dependen de este interruptor ni detienen el Gateway; siguen controladas por owner/operator y por la política de herramientas. - Pensar que un agent en Full Access por defecto es seguro: los cambios permitidos bajo Full Access (incluido Default) no muestran aprobación; la lista deny del paso 1 es el verdadero límite duro.
- Creer que activar el sandbox permite retirar la lista deny: la política de herramientas se aplica antes que las reglas del sandbox, y las herramientas denegadas no se restauran por el sandbox; además, la vía de escape
tools.elevatedhace queexeccorra directamente fuera del sandbox. No retires la denegación dura del paso 1 con el argumento de que «total, hay sandbox».
Próxima lección
Los permisos de herramientas controlan «qué puede hacer Claw», y el sandbox de OpenClaw controla «dónde se ejecuta y a qué puede acceder»; la próxima lección «Endurecimiento de seguridad (3): defensa contra inyección de prompts y auditoría de seguridad» pasa a «qué puede inducir el contenido a que haga Claw».