Skip to content

Endurecimiento de seguridad (1): control de acceso e identidad ​

Objetivo en una frase: esta es la primera lección del endurecimiento de seguridad de OpenClaw, y te ayuda a reducir la superficie de acceso: reconocer el límite de confianza del Gateway, controlar quién puede conectarse y hacer que cada aprobación se vincule a una persona exacta.

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". Aunque la política de herramientas ya prohíba ejecutar comandos y escribir archivos, la herramienta openclaw aún podía escribir en la configuración persistente sin aprobación, lo que permitía a un agent restringido habilitar 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: 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: establece tools.exec.mode en ask y rechaza cambios de delegación que no sean de confianza.

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 versiones. Texto original del aviso: https://github.com/openclaw/openclaw/security/advisories/GHSA-pw3x-g8v8-fvj2

Preparación ​

  • Tener OpenClaw instalado (v2026.8.1 o superior, es decir, OpenClaw 2.0; al momento de escribir, la versión del repositorio es 2026.10.9), Node 24.16.0+ o 26.1.0+.
  • Gateway funcionando en tu propia máquina, con al menos un canal conectado (uno de los más de 20+ canales: Telegram, Slack, Discord, etc.).
  • Se recomienda revisar primero Manual avanzado: Skills y endurecimiento de seguridad.

Primero establece una idea clara: OpenClaw es una pasarela autoalojada, sin servicio gestionado; el estado, la memoria y las credenciales permanecen en tu propio hardware; un proceso de Gateway es todo el límite de confianza, y los modelos y el agent harness (Claude, Codex, modelos locales) son solo complementos reemplazables. Endurecer la seguridad significa reducir la superficie de exposición de este límite hacia el exterior.

Hazlo conmigo ​

Paso 1: reconoce el límite de confianza y controla las entradas de canales con dmPolicy y la lista blanca ​

Primero dibuja el enlace en la máquina donde corre el Gateway: «usuario → canal → Gateway → modelo». Cada canal que conectas (Telegram, Slack, Discord...) añade una entrada más que puede alcanzar el límite de confianza. La primera compuerta para controlar las entradas de mensajes privados es dmPolicy, presente en cada canal que admite chats privados:

dmPolicy ValorComportamiento
pairing (por defecto)los remitentes desconocidos reciben un código de emparejamiento y sus mensajes se ignoran hasta ser aprobados; el código de emparejamiento expira en 1 hora y cada canal admite como máximo 3 solicitudes de emparejamiento pendientes
allowlistlos remitentes desconocidos se rechazan directamente, sin negociación de emparejamiento
opencualquiera puede chatear en privado; requiere que la lista blanca de canales incluya "*" para surtir efecto (activación explícita)
disabledignora todos los mensajes privados entrantes

El valor por defecto pairing ya es bastante sólido: los desconocidos no pueden comunicarse antes de que los apruebes. Cuando alguien envíe un mensaje privado a tu asistente, gestiona el emparejamiento con estos dos comandos:

bash
openclaw pairing list <channel>              # <channel> 换成渠道名,如 telegram
openclaw pairing approve <channel> <code>    # 批准后,对方才能与助手对话

La segunda compuerta es la lista blanca, con dos niveles:

  • Nivel de chats privados: allowFrom (como channels.discord.allowFrom, channels.slack.allowFrom) determina quién puede chatear en privado con el asistente; quienes pasan por la aprobación de emparejamiento se guardan en la base de datos compartida (por defecto ~/.openclaw/state/openclaw.sqlite) y se combinan con la lista blanca de configuración.
  • Nivel de grupos: channels.whatsapp.groups, channels.telegram.groups, etc., determinan qué grupos acepta el asistente, y se puede configurar requireMention por grupo (debe ser mencionado con @ para responder); si configuras groups, este también actúa como lista blanca de grupos; para conservar todos los grupos escribe "*". groupPolicy: "allowlist" más groupAllowFrom permite además restringir quién puede activarlo dentro del grupo (canales como WhatsApp/Telegram/Signal/iMessage/Teams).

💡 ¿Varias personas comparten el asistente? Aísla las sesiones de chat privado

Por defecto, todos los chats privados convergen en la misma sesión principal. Si varias personas pueden chatear en privado con el asistente (lista blanca multiusuario o open), configura session.dmScope: "per-channel-peer" en ~/.openclaw/openclaw.json para que cada «canal + remitente» obtenga una sesión aislada; openclaw security audit también da la misma recomendación al detectar chats privados multiusuario.

Resultado esperado: obtienes una lista de entradas que permite responder con claridad «quiénes y por qué canales pueden hablar hoy con mi asistente»; los remitentes desconocidos quedan por defecto retenidos en el paso de emparejamiento y se ignoran hasta ser aprobados.

Paso 2: reduce la superficie de exposición de red de OpenClaw ​

Con las entradas de canales controladas, revisa dónde escucha el propio Gateway: usa un puerto que ejecuta a la vez WebSocket y HTTP, con puerto por defecto 18789 (para cambiarlo usa gateway.port, --port o la variable de entorno OPENCLAW_GATEWAY_PORT). La dirección de escucha la determina gateway.bind:

  • "loopback": valor por defecto en hosts convencionales; solo los clientes locales pueden conectarse.
  • "auto": valor por defecto cuando se omite esta configuración en contenedores; se resuelve como 0.0.0.0, lo que facilita el reenvío de puertos y el acceso desde redes de contenedores.
  • "lan" / "tailnet" / "custom": hacen el Gateway accesible a más clientes; deben ir acompañados obligatoriamente de autenticación y un firewall real.

La regla es estricta: un arranque no loopback debe tener autenticación configurada, de lo contrario el Gateway se niega a iniciar. Para el acceso remoto, prioriza Tailscale Serve (el Gateway permanece en loopback y Tailscale gestiona el acceso) en lugar de vincularlo a la LAN; nunca expongas un Gateway sin autenticación en 0.0.0.0.

La autenticación es obligatoria por defecto: sin una ruta de autenticación válida, el Gateway rechaza las conexiones WebSocket; el onboarding genera por defecto un token, y los clientes locales también deben autenticarse. Hay tres modos de autenticación, configurados en gateway.auth:

  • token: token compartido de tipo bearer, la opción recomendada para la mayoría de los despliegues.
  • password: se recomienda configurarlo mediante la variable de entorno OPENCLAW_GATEWAY_PASSWORD.
  • trusted-proxy: confía en un proxy inverso con autenticación de identidad.
json5
// ~/.openclaw/openclaw.json
{
  gateway: {
    bind: "loopback",
    auth: { mode: "token", token: "replace-with-long-random-token" },
  },
}

Este gateway token se genera con openclaw doctor --generate-gateway-token, o puedes crear uno tú mismo con openssl rand -hex 32. Ten en cuenta: el arranque rechaza tokens vacíos, los literales undefined/null y cadenas de ejemplo de marcador de posición; openclaw security audit emite una alerta para tokens de menos de 24 caracteres.

Resultado esperado: el Gateway solo escucha en las ubicaciones de red que permites, y la conexión exige autenticación; al escanear tu máquina desde la red pública, no se encuentra ningún Gateway en el puerto 18789.

Paso 3: haz que las aprobaciones se vinculen a identidades exactas ​

Haz que el asistente ejecute un comando sensible que requiera aprobación y observa la información vinculada en el aviso de aprobación. El modelo de seguridad de OpenClaw 2.0 vincula la aprobación a la solicitud, el comando, la sesión y la persona exactos: confirma manualmente uno por uno los comandos sensibles provenientes de sesiones desconocidas; no los apruebes de forma general.

Resultado esperado: en cada aprobación puedes ver de qué sesión y de qué persona proviene y a qué comando corresponde; no existe «una persona aprueba y todos pasan».

Verificación ​

  1. Envía un mensaje privado al asistente desde una cuenta desconocida: con la configuración predeterminada dmPolicy: "pairing", la otra parte debería recibir un código de emparejamiento y ser ignorada hasta que tú lo apruebes; si un desconocido obtiene acceso completo directamente, vuelve a los pasos 1 y 2 para reforzar la configuración.
  2. Ejecuta openclaw pairing list <channel>; deberías ver las solicitudes de emparejamiento pendientes; solo después de aprobarlas con openclaw pairing approve <channel> <code> la otra parte podrá conversar con el asistente.
  3. Escanea tu IP pública desde una red externa (por ejemplo, nmap -sT -p 1-65535 <公网IP> --open); los puertos abiertos deberían ser únicamente los servicios que expusiste intencionadamente, sin que se vea el Gateway en el puerto 18789.
  4. Dispara un comando que requiera aprobación y verifica que la información de aprobación muestre la solicitud, el comando, la sesión y la persona exactos.
  5. Verifica el comportamiento predeterminado de conexiones externas: OpenClaw por defecto solo realiza una comprobación diaria de versión, y las estadísticas anónimas requieren que actives el opt-in explícitamente; para desactivar la comprobación de versión, configura update.checkOnStart: false.

Errores comunes ​

  • Colgar el Gateway en la red pública como si fuera un chatbot cualquiera. El Gateway es un límite de confianza; exponer su puerto equivale a exponer también las credenciales y la memoria.
  • Por comodidad, configurar dmPolicy como open. open permite que cualquier persona envíe mensajes privados al asistente, y además debes establecer explícitamente la lista blanca de canales en "*" para que surta efecto; oficialmente se posiciona como «una elección deliberada y consciente», no como la postura predeterminada.
  • Suponer que los datos están en la nube. El estado, la memoria y las credenciales están en tu propio hardware; si la máquina no es segura, el asistente tampoco lo es.
  • Conectar cada vez más canales sin actualizar la lista de entradas. Cada vez que conectes un canal nuevo, deberías volver al paso 1 para actualizar la lista.
  • Seguir usando una versión anterior a 2.0. «La aprobación se vincula a la solicitud/comando/sesión/persona exactos» es el modelo de seguridad introducido en v2026.8.1; con versiones antiguas, actualiza primero antes de hablar de refuerzo de seguridad.

Próxima lección ​

El control de acceso y la identidad son la primera puerta de seguridad de OpenClaw: los desconocidos no superan la etapa de emparejamiento, el Gateway no queda expuesto desnudo en la red pública y cada aprobación corresponde a una persona exacta. La próxima lección Endurecimiento de seguridad (II): permisos de herramientas y sandbox aborda «qué se puede hacer una vez dentro»: restringir los permisos de herramientas y aislar el entorno de ejecución con un sandbox.

Lecturas relacionadas: Refuerzo de seguridad (III): defensa contra inyección de prompts y auditoría de seguridad, Integración con WeCom corporativo: coloca el asistente de IA en los grupos de trabajo.

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.