Skip to content

Endurecimiento de seguridad (3): defensa contra la inyección de prompts y auditoría de seguridad ​

Objetivo en una frase: frenar la inyección de prompts: controlar las entradas no confiables que llegan al Gateway, eliminar las credenciales en texto plano y pasar una auditoría de seguridad con openclaw secrets audit --check.

Aviso de seguridad GHSA-pw3x-g8v8-fvj2: la versión de referencia de esta lección 2026.10.9 está afectada; actualice 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 todavía 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 a 2026.11.3. Esta lección está escrita según 2026.10.9, que está dentro del rango afectado.
  • Versiones corregidas: el canal stable se actualiza a 2026.11.4 o posterior; el canal extended-stable se actualiza a 2026.10.33.
  • Mitigación temporal antes de actualizar: establezca tools.exec.mode en ask y rechace cambios de delegación no confiables.

Primero use openclaw --version para ver su versión. Para saber cómo elegir un canal, cómo actualizar y revertir, consulte Actualización y canales de versión. Texto original del aviso: https://github.com/openclaw/openclaw/security/advisories/GHSA-pw3x-g8v8-fvj2

Requisito previo: completa primero «Endurecimiento de seguridad (1): control de acceso e identidad»; para permisos de herramientas y sandbox, consulta «Endurecimiento de seguridad (2)».

Preparación ​

  • OpenClaw 2.0 (v2026.8.1) o superior; este tutorial se basa en la versión del repositorio 2026.10.9.
  • Una configuración del Gateway que arranque con normalidad: canales conectados y al menos un proveedor de modelos configurado.
  • Poder ejecutar el CLI openclaw en la terminal.

Sígueme paso a paso ​

Paso 1: inventariar la superficie de inyección ​

Operación: enumera todas las fuentes de entrada que llegan al contexto del Gateway: mensajes de canales, skills, contenido devuelto por herramientas MCP y páginas web capturadas por el navegador. Marca cada una como «confiable / no confiable». Recuerda un principio: el proceso del Gateway es el único límite de confianza; el modelo y el harness del agente son complementos intercambiables, y todo lo que devuelva un complemento se trata como entrada no confiable.

Resultado esperado: una lista de «fuente de entrada → nivel de confianza → herramientas que puede activar». Para toda herramienta que pueda ser activada por una fuente no confiable, vuelve a la lección anterior y ajusta los permisos.

Paso 2: migrar credenciales y eliminar el texto plano ​

Operación: las credenciales en texto plano pueden esconderse en cuatro lugares: openclaw.json, .env, archivos JSON de auth-profile retirados y el generado agents/*/agent/models.json. Reescríbelas una a una como SecretRef: se admiten cuatro tipos de bloques provider (env, file, exec, store); exec puede conectarse directamente a 1Password, Bitwarden, Vault, pass y sops. Coloca las claves compartidas del equipo en un secret store SQLite compartido y haz que el tráfico de salida para obtener claves pase por la allowlist del egress proxy.

Resultado esperado: ya no aparecen API keys en texto plano en los archivos anteriores. Ten en cuenta que SecretRef se activa por credencial (opt-in) y no migra automáticamente.

Paso 3: ejecutar la auditoría ​

Operación: ejecuta

bash
openclaw secrets audit --check

Comprueba si queda texto plano. Para los elementos de auditoría completos de hardened-baseline y sus parámetros de comando correspondientes, remítete a la documentación oficial de security. @@I18N_KEEP_000019@@

Resultado esperado: el informe muestra que no hay plaintext residue. Si hay restos, sigue los archivos señalados por el informe y vuelve al paso 2 para continuar la migración.

Verificación ​

  1. Reinicia el Gateway y confirma que todos los canales y modelos funcionan con normalidad: las credenciales ya se cargan desde SecretRef.
  2. Vuelve a ejecutar openclaw secrets audit --check; el resultado debe ser que no hay restos.
  3. Envía un mensaje de inducción en un canal de prueba (por ejemplo, pidiendo leer .env) y confirma que la aprobación se vincula a la solicitud, el comando, la sesión y la persona exactos, y no se aprueba silenciosamente: este es el comportamiento central del modelo de seguridad de 2.0.

Errores comunes ​

  • Limpiar solo openclaw.json y olvidar .env y el generado agents/*/agent/models.json: la auditoría seguirá reportando texto plano.
  • Creer que activar SecretRef lo resuelve todo: se activa por credencial, cada credencial debe migrarse por separado hasta que el informe de audit esté limpio.
  • Incorporar directamente al contexto la salida de skills o herramientas MCP: esto amplía la superficie de inyección y debe combinarse con el etiquetado de confianza del paso 1 y los permisos de herramientas de la lección anterior.
  • Pendiente de completar, tras verificar la documentación oficial, la lista concreta de elementos de configuración predeterminados recomendados por hardened-baseline. @@I18N_KEEP_000020@@

Próxima lección ​

Una vez que la línea base de seguridad funciona, lo último es mantener la versión al día con las correcciones de seguridad: la próxima lección Actualización y canales de versión explica cómo elegir entre stable, extended-stable y beta, y cómo actualizar y revertir cuando aparece un aviso de seguridad. Los comandos y opciones de configuración más usados en la operación diaria se resumen en Referencia rápida de comandos y configuración de la CLI.

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.