Conceder a un agente autónomo acceso directo a la terminal del desarrollador puede corromper librerías locales tras una sola actualización fallida. Dentro del ecosistema de agentes de IA de código abierto de noviembre de 2026, los equipos que construyen soluciones de inteligencia artificial empresariales adoptan OpenHands porque el aislamiento en contenedores define el núcleo de su ejecución.
¿Qué es OpenHands? OpenHands (evolución de OpenDevin y All-Hands-AI) es una plataforma autónoma de ingeniería de software de código abierto con licencia MIT e independiente de proveedores. Crea sandboxes aislados en Docker o Kubernetes donde modifica múltiples archivos, instala dependencias, ejecuta pruebas y corrige fallos de forma iterativa sin comprometer el sistema anfitrión.
Importante
Resumen Ejecutivo — Pilares Técnicos de OpenHands
- Licencia MIT sin Bloqueo de Proveedor: Plataforma central, Software Agent SDK, CLI y banco de evaluación bajo licencia MIT, compatibles con APIs comerciales y modelos autoalojados.
- Edición Multiarchivo en Sandbox: Docker Runtime por defecto y Kubernetes Remote Runtime confinan dependencias, compilaciones y ciclos de pruebas en contenedores efímeros.
- SDK V1 Modular y Gobernanza: Incluye
EventStreamdeterminista, políticas (AlwaysConfirm,ConfirmRisky,NeverConfirm),--llm-approve, Microagents y soporte nativo MCP con OAuth.
Arquitectura Modular V1 de OpenHands y EventStream
OpenHands evolucionó hacia una arquitectura V1 desacoplada entre el repositorio oficial de OpenHands en GitHub y el Software Agent SDK, permitiendo que la interfaz web y la automatización headless en CI compartan el mismo motor.
Paquetes Desacoplados V1
openhands.sdk: DefineLLM,Agent,Conversation,Eventy políticas de seguridad. Su compatibilidad con LiteLLM permite cambiar de proveedor o pasarela interna mediante variables de entorno.openhands.tools: Aporta herramientas tipadas:TerminalToolpara comandos shell,FileEditorToolpara parches multiarchivo precisos yTaskTrackerToolpara planificar subtareas.openhands.workspace: Abstrae la frontera entre carpeta local, contenedor Docker efímero o entorno remoto.openhands.agent_server: Expone estado y eventos vía REST y WebSocket para Agent Canvas (navegador) y la CLI de OpenHands.
Registro Determinista EventStream
En lugar de guardar chats sin estructura, OpenHands persiste cada paso de planificación, comando, parche de archivo y traza de error en un EventStream ordenado. Esto proporciona depuración reproducible ante bloqueos, trazabilidad auditable para seguridad y reanudación fiable en refactorizaciones extensas.
Edición Multiarchivo en Sandbox y Ciclos Autónomos de Pruebas
Corregir un defecto en producción implica ajustar esquemas, servicios, rutas API y pruebas conjuntamente. OpenHands combina edición coordinada con aislamiento estricto.
Docker Runtime, Kubernetes Remote Runtime y Local Runtime
Por defecto, Docker Runtime inicia un contenedor efímero por sesión para aislar instalaciones y compilaciones; al cerrar la tarea el contenedor desaparece y el anfitrión permanece intacto. Para CI a gran escala y evaluaciones paralelas, Remote Runtime programa pods independientes en Kubernetes. Para trabajos ligeros en carpeta directa sigue disponible Local Runtime.
Verificación en Bucle Cerrado Hasta Superar las Pruebas
En el sandbox, el agente planifica con TaskTrackerTool, edita módulos relacionados mediante FileEditorTool, instala dependencias y lanza suites unitarias y de integración con TerminalTool. Si una prueba falla, lee la traza desde EventStream, diagnostica la causa raíz, ajusta el código y repite el ciclo hasta obtener verde. En desarrollo de software a medida, este bucle reduce deuda de pruebas y acelera migraciones con evidencia verificable.
Instalación, CLI Headless, Contenedor Docker y SDK Python
La referencia completa figura en docs.openhands.dev y openhands.dev, con tres rutas de despliegue: CLI local, Docker o SDK V1 en Python.
Instalación CLI, Modo Headless y Comandos MCP
Instale mediante uv con Python 3.12 (o pip install openhands-ai), inicie Agent Canvas con --mount-cwd (y --gpu opcional), ejecute tareas headless con --llm-approve y gestione servidores MCP:
uv tool install openhands --python 3.12
openhands serve --mount-cwd
openhands --headless --llm-approve \
--task "Corregir la condición de carrera en tokens de auth y pasar pytest"
openhands mcp add docs-internos --url https://mcp.example.internal/sse
openhands mcp list
Lanzamiento del Sandbox en Docker
Ejecute la aplicación con la imagen aislada agent-server y registro completo de eventos:
docker run -it --rm --pull=always \
-e AGENT_SERVER_IMAGE_REPOSITORY=ghcr.io/openhands/agent-server \
-e AGENT_SERVER_IMAGE_TAG=1.26.0-python \
-e LOG_ALL_EVENTS=true \
-v /var/run/docker.sock:/var/run/docker.sock \
-v ~/.openhands:/.openhands \
-v $(pwd):/workspace:rw \
-p 3000:3000 \
--add-host host.docker.internal:host-gateway \
--name openhands-app \
docker.openhands.dev/openhands/openhands:1.8
Advertencia
Límite del Socket Docker: Montar /var/run/docker.sock permite crear contenedores hermanos por tarea con control sobre el host. No active NeverConfirm en equipos con credenciales productivas o llaves SSH personales; reserve ejecuciones desatendidas para runners CI endurecidos o Kubernetes Remote Runtime.
Orquestación Programática con el SDK V1 en Python
Los equipos de plataforma incrustan flujos de reparación autónoma mediante openhands.sdk:
import os
from openhands.sdk import LLM, Agent, Conversation, Tool
from openhands.sdk.security.confirmation_policy import ConfirmRisky
from openhands.tools.file_editor import FileEditorTool
from openhands.tools.task_tracker import TaskTrackerTool
from openhands.tools.terminal import TerminalTool
llm = LLM(
model=os.getenv("LLM_MODEL", "anthropic/claude-sonnet-4-5-20250929"),
api_key=os.getenv("LLM_API_KEY"),
base_url=os.getenv("LLM_BASE_URL"),
)
agent = Agent(
llm=llm,
tools=[
Tool(name=TerminalTool.name),
Tool(name=FileEditorTool.name),
Tool(name=TaskTrackerTool.name),
],
)
conversation = Conversation(agent=agent, workspace=os.getcwd())
conversation.set_confirmation_policy(ConfirmRisky())
conversation.send_message(
"Corregir el redondeo de céntimos en facturación y validar pruebas unitarias."
)
conversation.run()
Políticas de Seguridad, Microagents y Soporte MCP
El contenedor protege el sistema anfitrión, mientras las políticas de seguridad controlan qué comandos se aprueban y qué reglas del repositorio se respetan.
Políticas de Confirmación y Analizador LLM
AlwaysConfirm: Exige aprobación explícita antes de cada comando y parche de archivo.ConfirmRisky: Modo equilibrado por defecto; ejecuta lecturas y pruebas seguras automáticamente y pausa ante acciones de riesgo.NeverConfirm: Ejecución continua sin pausas, restringida a sandboxes CI efímeros con credenciales acotadas.
Con --llm-approve, el analizador de seguridad basado en LLM revisa la semántica de cada orden antes de ejecutarse para bloquear borrados destructivos, fugas de secretos o descargas no autorizadas.
Microagents y MCP Nativo con OAuth
Los equipos versionan reglas de arquitectura como Microagents en ~/.openhands/microagents/ (con compatibilidad hacia .agents/skills/), cargándose automáticamente según rutas o palabras clave. El soporte nativo MCP (openhands mcp add, openhands mcp list) admite servidores corporativos protegidos con OAuth. Para auditoría de binarios o protocolos heredados, las herramientas de nuestra guía de arquitectura MCP de REA (Reverse Engineer Anything) se conectan directamente al sandbox de OpenHands para convertir hallazgos en código probado.
Consejo
Consejo de Implantación: Inicie cada repositorio nuevo con ConfirmRisky, --llm-approve y Microagents en Git. Audite EventStream tras el primer sprint para ajustar los umbrales con evidencia real antes de pasar tareas recurrentes a CI headless.
Comparativa Arquitectónica: OpenHands, OpenCode, Goose y Agentes Propietarios
| Criterio | OpenHands | OpenCode | Goose | Agentes Propietarios Nube / IDE |
|---|---|---|---|---|
| Modelo de Ejecución | Bucle autónomo (Agent Canvas, CLI, Headless, SDK V1 Python) | Sesión interactiva nativa en terminal (TUI) | App de escritorio, CLI y recetas API | Extensión cerrada de IDE o nube propietaria |
| Aislamiento Sandbox | Docker Runtime efímero y Kubernetes Remote (+ Local) | Directorio local y shell del desarrollador | Entorno local; contenedor externo opcional | Variable; nube del proveedor o IDE local |
| Pruebas Multiarchivo | Dependencias, pruebas completas y parches iterativos en contenedor | Edición asistida multiarchivo y verificación en terminal | Cadenas multipaso basadas en extensiones y recetas | Irregular; compilación y tests suelen limitarse |
| Bloqueo de Modelo | Ninguno — Licencia MIT, modelos comerciales o locales vía LiteLLM | Ninguno — Multiproveedor y endpoints locales | Ninguno — Código abierto multimodelo | Alto — Atado al modelo o suscripción cerrada |
| MCP y Extensibilidad | MCP nativo (openhands mcp add, OAuth), Microagents, SDK V1 | Amplia integración de servidores MCP y herramientas | Ecosistema MCP y recetas YAML reutilizables | Conectores limitados al catálogo del fabricante |
Quienes buscan agilidad interactiva desde teclado aprovechan la guía de OpenCode como agente de terminal de código abierto, mientras los equipos que unifican escritorio, CLI y recetas API evalúan la guía de Goose para escritorio, CLI y API. Cuando priman el aislamiento en contenedores efímeros, las pruebas autónomas multiarchivo y la auditoría EventStream en CI, OpenHands sobresale con claridad.
Gobernanza en Producción y Práctica de Kling Digital
Llevar OpenHands de pruebas individuales a un estándar de ingeniería corporativa exige aplicar cuatro controles operativos:
- Filtrado Estricto de Salida de Red (Egress): Limitar el tráfico saliente de los contenedores sandbox exclusivamente a espejos internos de paquetes y a la pasarela LLM autorizada.
- Aislamiento de Credenciales Efímeras: Mantener claves API y tokens Git fuera del directorio montado, emitiendo credenciales temporales de privilegio mínimo limitadas a la rama activa.
- Archivo Inmutable de EventStream: Enviar los registros de
LOG_ALL_EVENTS=truea almacenamiento centralizado de observabilidad para conservar la trazabilidad completa de cada pull request. - Revisión Humana Obligatoria y Controles SAST: Tratar las pruebas verdes del sandbox como evidencia de verificación y nunca como permiso directo de fusión; cada cambio debe superar revisión humana y análisis estático.
Kling Digital diseña entornos autónomos de codificación neutrales respecto al proveedor, clústeres Kubernetes Remote Runtime e integraciones MCP con OAuth. Coordina una revisión de arquitectura OpenHands V1 con nuestros especialistas en contacto de Kling Digital.




