Cambiar tema

OpenClaw 2026.3 avanzado: funciones clave y mejores prácticas

Easton editorial illustration: recovery checkpoint console

OpenClaw 2026.3 (v2026.3.7-beta.1) corrige más de 200 bugs; el CHANGELOG oficial ronda las quince mil palabras. Antes, las tareas de enrutamiento multi-modelo fallaban una y otra vez en la configuración de permisos del sandbox; en la nueva versión pasaron a la primera. Las novedades clave incluyen el motor ContextEngine (uso de contexto ~30% menor), el sistema de plugins reestructurado en Bundle + Provider + Plugin, y tres nuevos backends de sandbox: OpenShell y SSH.

Este artículo es el número 34 de la serie OpenClaw y concentra los puntos prácticos de 2026.3: cómo usar ContextEngine, configurar la arquitectura de tres capas y elegir el backend de sandbox. Si vienes de una versión anterior, te ayudará a localizar rápido los puntos de migración.

1. Panorama de la versión — qué trae 2026.3

Empecemos por los datos. Solo v2026.3.7-beta.1 corrige más de 200 bugs, sin contar los parches posteriores. El CHANGELOG oficial tiene casi quince mil palabras; tras leerlo, resumo estas direcciones:

200+
Correcciones de bugs
Solo v2026.3.7-beta.1

Mejora del motor ContextEngine. Antes, la gestión de contexto de OpenClaw era bastante «rígida»: le dabas lo que fuera y lo consumía todo; si aguantaba dependía del modelo. La nueva versión añade un mecanismo de «recorte inteligente» que identifica qué información necesita realmente la tarea actual y aparta el resto temporalmente. En mis pruebas, con una tarea compleja de 50 turnos, el uso de contexto bajó ~30%.

Reestructuración del sistema de plugins. El cambio más grande: de Skills de una sola capa a Bundle + Provider + Plugin. En pocas palabras, plugins más modulares. Antes, migrar una skill de Codex a Claude podía exigir reconfigurar mucho; ahora basta cambiar el Provider y la lógica central no se toca. El capítulo 3 explica la configuración.

Backends de sandbox diversificados. Antes casi todo dependía de Docker; ahora hay OpenShell (modos mirror y remote) y SSH sandbox. Si usas Mac o no quieres instalar Docker, el modo mirror de OpenShell es buena opción: usa el shell local y arranca mucho más rápido.

Flujo humano-en-el-bucle reforzado. La nueva versión ya no apuesta solo por la automatización total, sino por human-in-the-loop: la IA se detiene a mitad de camino y pregunta «¿está bien así?»; tú confirmas y continúa. Al principio me pareció prescindible, pero tras usarlo unas veces — efectivamente evita errores.

Un detalle fácil de pasar por alto: detección automática de SELinux. En CentOS o RHEL, antes la configuración del sandbox podía dar problemas de permisos; ahora detecta y sugiere ajustes.

2. Nuevas funciones clave en detalle

2.1 /btw — preguntas laterales

Al principio no le di importancia; parecía solo una «bifurcación de conversación». Pero al usarlo — vale la pena.

El escenario: OpenClaw te ayuda a refactorizar un componente React complejo; la tarea lleva más de diez turnos y el contexto ya es enorme. De repente quieres preguntar algo no relacionado, como «¿cómo escribo esta expresión regular?». Antes abrías otra sesión o lo metías en la conversación actual (y el contexto explotaba).

Ahora escribes /btw tu pregunta y OpenClaw responde en un «canal lateral» sin afectar el contexto de la tarea principal. Al terminar, vuelve automáticamente a la tarea principal.

# Ejemplo de pregunta lateral
/btw Ayúdame a escribir una regex para validar email

# Salida de ejemplo
# [Pregunta lateral] Regex email: ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$
# [Tarea principal continúa] Refactorizando componente...

En serio, esto resuelve un problema que me molestaba: cómo «interrumpir» una tarea larga sin romper el contexto.

2.2 Backends de sandbox intercambiables

Los cambios en sandbox son más técnicos. Antes solo Docker; ahora hay tres:

Modo mirror de OpenShell: usa tu shell local, pero las ejecuciones se «reflejan» y registran. Ventajas: arranque rápido y poco consumo; inconveniente: menos aislamiento que Docker. Ideal para desarrollo local.

Modo remote de OpenShell: se conecta al shell de un servidor remoto. Si tienes una máquina dedicada a tareas, OpenClaw ejecuta allí y localmente solo controlas. Útil para equipos o entornos unificados.

Backend SSH sandbox: similar a remote, pero más «nativo», sin protocolo propio de OpenClaw. Para infraestructura SSH existente.

Ejemplo de configuración (OpenShell mirror). Nota: la configuración principal en tiempo de ejecución es ~/.openclaw/openclaw.json (JSON); el YAML siguiente solo ilustra la jerarquía; las claves y la estructura real deben tomarse de Gateway configuration y la versión actual.

# Solo ilustrativo; no usar como configuración autoritativa
sandbox:
  type: openshell
  mode: mirror
  options:
    shell: /bin/bash  # o /bin/zsh
    timeout: 300      # timeout por comando (segundos)

Si no quieres instalar Docker, mirror es una opción ligera. Lo probé en MacBook Air: la memoria era la mitad que con Docker.

2.3 Integración Firecrawl

El scraping web siempre fue un punto débil de OpenClaw: el enfoque anterior era algo «bruto» — curl y parsear HTML; ante anti-scraping o renderizado dinámico, se quedaba corto.

Con Firecrawl mejora mucho. Firecrawl es un servicio especializado: renderizado JavaScript, paginación automática y salida Markdown estructurada. OpenClaw lo encapsula como herramienta integrada.

# Habilitar Firecrawl
tools:
  web_scraping:
    engine: firecrawl
    api_key: ${FIRECRAWL_API_KEY}  # recomendado: variable de entorno

En pruebas, capturar una SPA compleja (por ejemplo un sitio de documentación React) antes requería varios prompts; ahora suele bastar un paso.

2.4 Flujo de Secrets

Resuelve la gestión segura de claves API. Antes las hardcodeabas en config o usabas variables de entorno y las subías a Git por error.

El flujo Secrets de la nueva versión soporta CRUD completo:

# Añadir clave
/secrets set OPENAI_API_KEY "sk-xxx"

# Listar claves (solo nombres, no valores)
/secrets list

# Eliminar clave
/secrets delete OPENAI_API_KEY

Las claves se almacenan cifradas en ~/.openclaw/secrets/; Git ignora ese directorio. En configs compartidas de equipo, puedes exportarlas como variables de entorno e inyectarlas en CI/CD.

3. Sistema de plugins reestructurado en la práctica

Es la parte que más cambió en 2026.3 y donde muchos usuarios veteranos se pierden. Me llevó un fin de semana entender la arquitectura.

3.1 De Skills a tres capas

Antes los plugins se llamaban Skills: módulos independientes. Instalabas un Skill, lo configurabas y listo. Simple, pero con problemas:

  • Conflictos de dependencias entre Skills
  • Al migrar a otro modelo de IA, revisar compatibilidad uno a uno
  • Personalizar un Skill existente casi equivalía a reescribirlo

La nueva arquitectura de tres capas:

Bundle (paquete de capacidades): capa superior, conjuntos como codex-bundle, claude-bundle. Un Bundle agrupa Plugins relacionados y la config por defecto del Provider. Piensa en «kits listos para usar».

Provider (proveedor de modelo): capa intermedia, conecta con modelos concretos. openrouter-provider accede a decenas de modelos vía OpenRouter; copilot-provider integra GitHub Copilot.

Plugin: capa inferior, lógica funcional. web-search-plugin para búsqueda web; code-review-plugin para revisión de código.

¿El beneficio? Migrar revisión de código de OpenAI a Claude: solo cambias el Provider; el Plugin no se toca.

3.2 Ejemplo de configuración Bundle

Con claude-bundle, la config sería así:

# bundles/claude-bundle.yaml
name: claude-bundle
version: 1.2.0
description: "Kit de capacidades Claude AI"

provider:
  name: anthropic
  model: claude-3-5-sonnet-20241022
  api_key: ${ANTHROPIC_API_KEY}

plugins:
  - name: code-generation
    enabled: true
  - name: code-review
    enabled: true
  - name: web-search
    enabled: false  # Claude ya tiene búsqueda web integrada

settings:
  max_tokens: 4096
  temperature: 0.7

Para habilitar el Bundle, referéncialo en la config principal:

# Estructura ilustrativa (config real: openclaw.json + docs oficiales)
bundles:
  - claude-bundle
  - dev-tools-bundle  # puedes habilitar varios a la vez

3.3 Provider como plugin

Si no quieres el Provider por defecto del Bundle, configúralo aparte. Por ejemplo OpenRouter para Claude (a veces más barato):

# providers/openrouter.yaml
name: openrouter
type: http
base_url: https://openrouter.ai/api/v1
api_key: ${OPENROUTER_API_KEY}

models:
  - id: anthropic/claude-3.5-sonnet
    alias: claude-sonnet
  - id: openai/gpt-4o
    alias: gpt4

Luego referencia ese Provider en el Bundle:

# bundles/custom-claude.yaml
provider:
  ref: openrouter
  model: claude-sonnet  # alias definido arriba

Muy útil para optimizar costos: modelos baratos para tareas simples, caros para las complejas. El artículo 26 de la serie, «Optimización de costos OpenClaw: estrategia de enrutamiento», lo detalla.

3.4 ClawHub — mercado de skills

El mercado oficial ClawHub es como la tienda de extensiones de VS Code. Busca e instala desde OpenClaw:

# Buscar skill
/hub search code-review

# Instalar skill
/hub install voltagent/code-review-enhanced

# Ver instalados
/hub list

Las skills en ClawHub pasan revisión comunitaria y tienen versionado. Para publicar la tuya: hub publish.

4. Guía de actualización y migración

4.1 Actualización fluida desde versiones antiguas

La actualización es sencilla: /update o deja que OpenClaw detecte actualizaciones:

# Opción 1: actualización manual
/update

# Opción 2: pedir a la IA en el chat
"Comprueba si hay una nueva versión"

Atención: antes de actualizar:

  1. Backup de la config: copia todo ~/.openclaw/
  2. Anota Skills instalados: el nuevo sistema de plugins no es compatible; hay que reinstalar
  3. Revisa claves API: si usas variables de entorno, confirma que estén bien

Tras actualizar, OpenClaw intenta migrar la config antigua, pero no siempre al 100%. Bundle y Provider pueden requerir ajuste manual.

4.2 Lista de compatibilidad post-actualización

Ejecuta esta comprobación tras actualizar:

ComprobaciónComandoResultado esperado
Versión--versionv2026.3.x
Lista de plugins/plugins listPlugins instalados
Estado Provider/providers statusProviders configurados
Estado sandbox/sandbox statusTipo y estado del sandbox
Almacén de claves/secrets listNombres de claves guardadas

Si algo falla, revisa el archivo de config correspondiente. Problemas frecuentes:

  • Skills desaparecidos: normal; reinstala el Bundle equivalente
  • Provider no conecta: revisa migración de claves API
  • Error de permisos sandbox: vuelve a ejecutar la inicialización del sandbox

4.3 Problemas frecuentes y soluciones

Problema 1: la config antigua de Skills no se reconoce

La nueva versión no soporta el formato Skills antiguo:

# Ver lista de Skills antiguos (solo nombres)
/legacy-skills list

# Convertir Skills al formato Plugin
/migrate-skills

La config convertida queda en ~/.openclaw/plugins/migrated/; puede requerir ajuste manual.

Problema 2: el sandbox Docker no arranca

Puede ser SELinux:

# Detectar y corregir SELinux
/sandbox fix-selinux

# O cambiar a OpenShell mirror
/config set sandbox.type openshell
/config set sandbox.mode mirror

Problema 3: se perdió la config de enrutamiento multi-modelo

Lo vi al actualizar: la nueva arquitectura Provider cambió el formato. Solución: reescribe la config Provider siguiendo el capítulo 3.

5. Escenarios prácticos y mejores prácticas

5.1 Escenario 1: optimización de costos con multi-modelo

Prioridad para muchos desarrolladores y equipos pequeños. El enrutamiento multi-modelo materializa «tareas simples con modelo barato, complejas con modelo potente».

Idea básica:

# router.yaml
rules:
  - name: simple-tasks
    condition: "tokens < 1000 and complexity < 0.3"
    provider: openrouter
    model: openai/gpt-3.5-turbo

  - name: complex-tasks
    condition: "tokens >= 1000 or complexity >= 0.3"
    provider: openrouter
    model: anthropic/claude-3.5-sonnet

  - name: code-review
    condition: "task_type == 'code_review'"
    provider: anthropic
    model: claude-3-5-sonnet-20241022
40%-60%
Reducción de costos
Datos medidos con la misma carga de trabajo

En pruebas, con la misma carga, el costo bajó 40%-60%, según la distribución de tareas.

5.2 Escenario 2: automatización del navegador mejorada

La nueva versión soporta «Live Chrome session attachment»: OpenClaw puede tomar una ventana de Chrome que ya tienes abierta.

Muy útil cuando:

  • Ya iniciaste sesión en un sitio con captcha
  • Necesitas alternar entre varias páginas
  • Quieres conservar cookies y sesión del navegador

Configuración:

# Estructura ilustrativa (claves según documentación oficial)
browser:
  mode: attach
  chrome_path: /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome
  user_data_dir: ~/.chrome-debug-profile
  debug_port: 9222

Arranca Chrome con parámetros de depuración:

# macOS
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir=~/.chrome-debug-profile

# Luego en OpenClaw:
"Toma el control de mi ventana de navegador actual"

5.3 Escenario 3: despliegue empresarial seguro

En entorno corporativo, la seguridad es ineludible. Varias funciones ayudan al cumplimiento:

1. Almacenamiento cifrado de Secrets

Todas las claves con AES-256; la clave maestra no se escribe en disco (solo en memoria).

2. Registro de auditoría

Con auditoría activada, se registran todas las solicitudes y respuestas de IA:

audit:
  enabled: true
  log_path: /var/log/openclaw/audit.log
  redact_secrets: true  # enmascara claves automáticamente

3. Control de tráfico saliente

Limita OpenClaw a dominios específicos:

network:
  allowlist:
    - api.anthropic.com
    - api.openai.com
    - openrouter.ai
  deny_all_others: true

4. Detección automática SELinux

En CentOS/RHEL, OpenClaw detecta SELinux y sugiere configuración:

# Sugerencia generada por OpenClaw
# Ejecuta para configurar política SELinux de Docker:
# semanage port -a -t docker_port_t -p tcp 2375-2376

Resumen

Si acabas de actualizar a 2026.3, prueba estas 5 funciones:

  1. /btw preguntas laterales: interrumpe sin romper el contexto en tareas largas
  2. Modo mirror OpenShell: si Docker te consumía demasiados recursos, pruébalo
  3. Scraping con Firecrawl: prueba con una SPA compleja; el efecto se nota
  4. ClawHub: explora qué aporta la comunidad
  5. Flujo Secrets: migra claves hardcodeadas; mejora mucho la seguridad

OpenClaw itera rápido; a veces hay versión nueva cada una o dos semanas. Si tienes problemas, busca en GitHub Issues: seguramente alguien ya pasó por lo mismo.

La serie ya cubre configuración, costos y arquitectura. Si es tu primer contacto con OpenClaw, empieza por «Guía de arquitectura OpenClaw: de principiante a experto».

Guía rápida OpenClaw 2026.3

Actualizar desde versión antigua a 2026.3 y configurar funciones clave

⏱️ Estimated time: 30 min

  1. 1

    Step 1: Backup y actualización

    Antes de actualizar, haz backup de la config:

    ```bash
    # Backup del directorio de config
    cp -r ~/.openclaw ~/.openclaw-backup

    # Disparar actualización
    /update
    ```

    Tras actualizar, ejecuta `--version` para confirmar.
  2. 2

    Step 2: Migrar Skills a Plugin

    La nueva versión no soporta el formato Skills antiguo:

    ```bash
    # Ver lista de Skills antiguos
    /legacy-skills list

    # Migración automática
    /migrate-skills
    ```

    Revisa el directorio `~/.openclaw/plugins/migrated/` tras migrar.
  3. 3

    Step 3: Configurar backend sandbox

    Recomendado: modo mirror OpenShell (ligero):

    ```yaml
    sandbox:
    type: openshell
    mode: mirror
    options:
    shell: /bin/bash
    timeout: 300
    ```

    O sigue usando Docker.
  4. 4

    Step 4: Configurar Bundle y Provider

    Crear o modificar config Bundle:

    ```yaml
    # bundles/claude-bundle.yaml
    provider:
    name: anthropic
    model: claude-3-5-sonnet-20241022
    api_key: ${ANTHROPIC_API_KEY}
    plugins:
    - name: code-generation
    enabled: true
    ```

    Habilitar en config principal: `bundles: [claude-bundle]`
  5. 5

    Step 5: Migrar claves a Secrets

    Migrar claves hardcodeadas a gestión segura:

    ```bash
    # Añadir clave
    /secrets set ANTHROPIC_API_KEY "your-key-here"

    # Verificar
    /secrets list
    ```

    Las claves se almacenan cifradas; Git las ignora.

FAQ

Tras actualizar a 2026.3, ¿sigue funcionando la config antigua de Skills?
No directamente. La nueva versión usa Bundle + Provider + Plugin y no es compatible con Skills antiguos. Usa `/migrate-skills` para migrar automáticamente y revisa `~/.openclaw/plugins/migrated/`.
¿Qué diferencia hay entre OpenShell mirror y el sandbox Docker?
OpenShell mirror usa el shell local: arranque más rápido y menos recursos, ideal para desarrollo. Docker ofrece mejor aislamiento, para producción o escenarios que lo exijan.

En MacBook Air: mirror usa ~la mitad de memoria que Docker.
¿/btw afecta el contexto de la tarea principal?
No. /btw crea un canal lateral independiente; tras responder vuelve a la tarea principal. Resuelve interrumpir tareas largas sin contaminar el contexto.
¿Cómo configuro enrutamiento multi-modelo para reducir costos?
Define reglas en router.yaml:

- Tareas simples (tokens <1000) -> GPT-3.5 barato
- Tareas complejas (tokens >=1000) -> Claude 3.5 Sonnet
- Tareas específicas (p. ej. code_review) -> modelo concreto

Costo medido: -40% a -60%. Ver artículo 26 de la serie sobre optimización de costos OpenClaw.
¿La integración Firecrawl tiene costo adicional?
Firecrawl es un servicio independiente con su propia tarifa. OpenClaw solo encapsula su API. Puedes usar la cuota gratuita (límite mensual) o pagar por uso. Configura la variable `FIRECRAWL_API_KEY`.
¿Recomendaciones de seguridad para despliegue empresarial?
Activa:

- Almacenamiento cifrado Secrets (AES-256)
- Registro de auditoría (todas las solicitudes/respuestas IA)
- Lista blanca de tráfico saliente
- Detección SELinux (CentOS/RHEL)

La config principal está en **~/.openclaw/openclaw.json** (JSON) y docs Gateway/seguridad; no asumas un único archivo config.yaml.

10 min de lectura · Publicado el: 18 mar 2026 · Actualizado el: 21 ago 2026

Comentarios

Inicia sesión con GitHub para dejar un comentario

Easton BlogEaston Blog