OpenShell explicado: límites de actuación de un agente
Primeros pasos con OpenShell: instalador y sandbox vacío
Prueba el ciclo de vida local sin confundir la instalación del CLI con un agente listo.
Qué aprenderás
- Revisar el host
- Crear un sandbox sin agente
- Conservar pruebas de fallo
Antes de empezar
- Una carga desechable y un runtime soportado
- Permiso para revisar política y proveedores
Convierte los controles descritos en un informe acotado que otro operador pueda revisar.
Conclusiones clave
- La imagen inicial no incluye agente.
- WSL 2 figura como experimental en la matriz fijada.
- Instalación y disponibilidad del gateway son pruebas diferentes.
Revisar el host
La matriz fijada admite Linux amd64 y arm64 y macOS Apple Silicon con Docker Desktop. Windows con WSL 2 figura como experimental. También hace falta un runtime de contenedores o virtualización.
Lee el instalador de la misma revisión antes de ejecutarlo. Para producción, la matriz recomienda artefactos estables. Este artículo no ejecutó el instalador remoto ni confirmó los requisitos de una máquina concreta.
Crear un sandbox sin agente
La guía usa `openshell sandbox create --name demo`. La imagen predeterminada contiene un Ubuntu mínimo y ningún agente de IA; completar la creación verifica el ciclo de vida, no el comportamiento de un agente.
Después inspecciona el estado y compara política base y efectiva. El tutorial del primer agente añade OpenCode y un proveedor de inferencia más tarde, una prueba distinta que incluye credenciales y red.
Conservar pruebas de fallo
Registra versiones de CLI y gateway, runtime del host, imagen y resultado de creación. Ante un error, identifica si apareció en instalación, arranque del gateway, driver de cómputo o selección de política.
Retira el sandbox desechable después de guardar los resultados, comprobando el alcance del comando de borrado. Esta serie propone la prueba; no instaló OpenShell ni creó un sandbox.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Comprobar matriz de soporte e instalador.
- 2
Crear un sandbox de prueba con versión fijada.
- 3
Revisar política seleccionada y guardar resultados.
Ejemplo para copiar
openshell sandbox create --name demo
openshell policy get demo --base
openshell policy get demo --fullPreguntas frecuentes
¿La guía inicia un modelo de IA?
No. La imagen inicial no trae agente; el tutorial del primer agente es separado.
¿Conviene un build dev flotante en producción?
La matriz recomienda usar versiones estables en producción.
Fuentes
- OpenShell / README.mdFuente verificada 2026-10-04
- OpenShell / docs/about/installation.mdxFuente verificada 2026-10-04
- OpenShell / docs/about/support-matrix.mdxFuente verificada 2026-10-04
- OpenShell / docs/how-it-works/policies/default-policy.mdxFuente verificada 2026-10-04