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.modeenasky 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
openclawen 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
openclaw secrets audit --checkComprueba 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
- Reinicia el Gateway y confirma que todos los canales y modelos funcionan con normalidad: las credenciales ya se cargan desde SecretRef.
- Vuelve a ejecutar
openclaw secrets audit --check; el resultado debe ser que no hay restos. - 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.jsony olvidar.envy el generadoagents/*/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.