SSD Nodes Learn Hosting plans →
Guías Matt ConnorPor Matt Connor

Alojar KiroCrew en un VPS con Docker y systemd

Mantén KiroCrew activo en un VPS con Docker y systemd: conserva memoria y trabajos tras reinicios, accede por SSH y restaura copias o versiones anteriores.

Por qué alojar KiroCrew en un VPS en lugar de un portátil

Alojar KiroCrew por cuenta propia sólo resulta útil en una máquina que nunca entre en suspensión. Por eso, un VPS es el lugar adecuado y un portátil no lo es. KiroCrew guarda en disco el historial de sesiones, la memoria semántica, las tareas programadas y la cola de aprobaciones. Vuelve a cargar todos esos datos cuando se reinicia el proceso. Nada de eso sirve si el proceso no está en ejecución a las 03:00, cuando debe ejecutarse una tarea programada. Un portátil cerrado no puede ejecutarlo.

KiroCrew es un espacio de trabajo de agentes de código abierto del equipo de Kiro, con licencia Apache 2.0, con 0.1.0 publicado el 22 de julio de 2026. Un proceso, denominado gateway, mantiene el estado y ofrece un panel web en el puerto 5476. Puede acceder al gateway desde el panel, desde la CLI de kirocrew o desde un canal de chat como Slack. El gateway es lo único que aloja por cuenta propia, así que esta guía trata sobre mantenerlo activo, mantenerlo fuera de Internet pública y poder restaurarlo después de una actualización defectuosa.

Debe conocer dos aspectos antes de empezar. Desde 0.11.0, las instalaciones nuevas de KiroCrew sin una selección de harness guardada usan KAS de forma predeterminada sin necesitar kiro-cli. Las selecciones explícitas existentes de Kiro CLI se conservan. La inferencia en los backends de Kiro usa su plan de Kiro, por lo que, a 1 de noviembre de 2026, esta configuración predeterminada no funciona sin conexión. El proyecto también es reciente y evoluciona rápido: sus versiones estables pasaron de 0.1.3 el 5 de agosto de 2026 a 0.10.0 el 25 de octubre de 2026. Entre ellas se publicaron 0.8.0 el 9 de octubre y 0.9.0 el 16 de octubre. Además, el 25 de octubre ya había una versión candidata 0.11.0 disponible como versión preliminar. Dé por hecho que en algún momento tendrá que revertir una actualización e instálelo de forma que pueda hacerlo. Si nunca ha ejecutado un agente en un servidor, ejecutar un agente de programación en un VPS explica los principios básicos en los que se basa esta guía. Si la parte de los agentes le resulta más nueva que la administración de servidores, lea primero qué son realmente el bucle de un agente, sus herramientas y su memoria. Así, las decisiones siguientes se entenderán como decisiones y no como instrucciones incomprensibles.

Qué necesita KiroCrew y dónde se almacena su estado

Una instalación nativa necesita Python 3.12 o posterior y Node.js 22.12.0 o posterior si compila el panel desde el código fuente (el proyecto recomienda Node 24 LTS). El backend de Kiro CLI necesita kiro-cli, autenticado con kiro-cli login o con una clave de API para uso automatizado; desde 0.10.0, el motor KAS integrado funciona sin tener kiro-cli instalado, y 0.11.0 lo convirtió en la opción predeterminada para las instalaciones nuevas que no tienen una selección de harness guardada. La instalación en contenedor no necesita nada de eso en el host. Necesita Docker. Esta es la razón principal para preferirla.

El estado se almacena en ~/.kiro/crew, y la variable de entorno KIROCREW_HOME permite trasladarlo a otra ubicación. Su contenido incluye:

  • config.json: configuración de la puerta de enlace y credenciales de los canales de chat.
  • .env: secretos.
  • workspace/memory/: preferencias, notas de proyectos e historial de chat.
  • memory.db y memory_index.db: índices semánticos y de texto completo.
  • models/: modelo de embeddings, descargado durante la primera ejecución.
  • security_events.jsonl: registro de eventos de seguridad.

Ese directorio es la instalación. Cópielo a un VPS nuevo y habrá trasladado su agente. Por eso la sección de copias de seguridad que aparece más adelante es más importante que la sección de instalación.

Planifique el almacenamiento en disco, no la RAM. La puerta de enlace es un proceso de Python; lo que realmente carga el equipo es lo que ejecute el agente, una compilación o una suite de pruebas. El directorio de estado crece con el historial de chat, y el modelo de embeddings se descarga durante el primer arranque. Por tanto, mídalo en su propio equipo con du -sh ~/.kiro/crew después de unas semanas, en lugar de confiar en cualquier cifra publicada durante los primeros meses de un proyecto. Compárelo con un entorno de ejecución que proporciona a cada worker su propio contenedor y su propio navegador. En ese caso, alojar los compañeros de IA de OpenBot convierte la capacidad de RAM en la primera cuestión, antes que el espacio en disco.

Qué ruta de instalación de las cuatro debe usar

El proyecto publica cuatro: aplicación de escritorio, instalador de una línea, código fuente y Docker. El instalador de una línea descarga un wheel y crea un lanzador kirocrew. Si su directorio no está incluido en PATH, muestra instrucciones para añadirlo:

curl -fsSL https://download.crew.kiro.dev/cli.sh | sh

Acepta un indicador de canal y un indicador de versión:

curl -fsSL https://download.crew.kiro.dev/cli.sh | sh -s -- --channel insider
curl -fsSL https://download.crew.kiro.dev/cli.sh | sh -s -- --version 0.8.0

La imagen del contenedor se publica en ghcr.io/kirodotdev/kirocrew, para linux/amd64 y linux/arm64 con cada etiqueta. La compilación desde el código fuente requiere git clone y make build, y está destinada a quienes modifican el código, no a quienes lo ejecutan.

Use el contenedor. Una instalación nativa desde el código fuente coloca los paquetes de Python y Node en el mismo host que ejecuta los demás servicios, además de kiro-cli al usar el backend de Kiro CLI. Por tanto, si una actualización falla, tendrá que deshacer esos cambios manualmente. El contenedor mantiene el entorno de ejecución en una sola imagen y el estado en un solo volumen. Así, una reversión sólo requiere cambiar la etiqueta y reiniciar.

Fije la imagen en una etiqueta de versión, no en stable

El ejemplo del propio proyecto usa la etiqueta stable:

docker run -d --name kirocrew \
  -p 127.0.0.1:5476:5476 \
  -v kirocrew-home:/home/kirocrew \
  ghcr.io/kirodotdev/kirocrew:stable

stable es una etiqueta mutable, al igual que latest, que apunta a la misma versión. Apunta a la versión estable más reciente disponible. Por eso, la siguiente extracción puede cambiar la versión que está ejecutando sin que usted la elija, y la etiqueta no registra qué versión era. Las etiquetas de versión son inmutables; use una de ellas. La versión estable más reciente a 1 November 2026 es 0.11.1, publicada el 31 October 2026 como parche urgente para corregir problemas de integridad de memoria y KAS en 0.11.0. El ejemplo de 0.8.0 siguiente usa Kiro CLI. También existen las etiquetas insider y nightly; nightly sigue las compilaciones de main.

Escriba /opt/kirocrew/compose.yaml:

services:
  kirocrew:
    image: ghcr.io/kirodotdev/kirocrew:0.8.0
    container_name: kirocrew
    restart: unless-stopped
    ports:
      - "127.0.0.1:5476:5476"
    volumes:
      - kirocrew-home:/home/kirocrew

volumes:
  kirocrew-home:

Inícielo y compruebe el endpoint de estado que la propia imagen también usa para su HEALTHCHECK:

cd /opt/kirocrew
docker compose up -d
docker compose ps
curl -s http://127.0.0.1:5476/api/health

docker compose ps debería informar de que el contenedor está en buen estado al cabo de aproximadamente un minuto. /api/health responde sin token, al igual que /api/live y /api/ready, lo que permite usarlos como sondas. Si el estado permanece en starting, lea docker logs kirocrew antes de cambiar nada. La primera ejecución descarga el modelo de embeddings en segundo plano. Hasta que termine, la búsqueda en memoria usa coincidencias por palabras clave.

Manténgalo en ejecución con systemd

restart: unless-stopped vuelve a iniciar el contenedor después de un fallo y después de reiniciar el sistema, siempre que Docker se inicie durante el arranque. Un archivo de unidad hace explícita esa dependencia y proporciona un único comando para detener toda la pila antes de una copia de seguridad. Iniciar una pila de Docker Compose durante el arranque explica el patrón general. Esta es la estructura para KiroCrew, en /etc/systemd/system/kirocrew.service:

[Unit]
Description=KiroCrew gateway
Requires=docker.service
After=docker.service

[Service]
Type=oneshot
RemainAfterExit=yes
WorkingDirectory=/opt/kirocrew
ExecStart=/usr/bin/docker compose up -d
ExecStop=/usr/bin/docker compose down
TimeoutStartSec=0

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now kirocrew
systemctl status kirocrew

systemctl status kirocrew debería mostrar active (exited), que es el resultado correcto para esta unidad. Type=oneshot con RemainAfterExit=yes es correcto en este caso porque docker compose up -d devuelve el control en cuanto se inicia el contenedor: systemd supervisa que la pila esté activa, no un proceso en primer plano. Escriba Type=simple en su lugar y systemd verá que el comando termina inmediatamente, marcará el servicio como detenido y después se rendirá o entrará en un bucle de reinicios, según la configuración de Restart=. En una instalación nativa, el proyecto incluye su propio equivalente, kirocrew service install, que escribe /etc/systemd/system/kirocrew.service y ejecuta el gateway con su usuario. No ejecute ambas unidades. Encontrará una explicación más amplia en servicios y temporizadores de systemd en un VPS. Una unidad que no vuelve a iniciarse permanece silenciosa a menos que haga que informe del fallo, así que añada un controlador OnFailure= que envíe una alerta a su propio servidor ntfy y sabrá desde el teléfono que el gateway está caído, en lugar de enterarse mediante una tarea programada que nunca se ejecutó.

Primera ejecución: iniciar sesión y obtener un token del panel

El contenedor inicia la puerta de enlace, pero el entorno de ejecución predeterminado de Kiro CLI en la imagen 0.8.0 fijada todavía necesita autenticación. Inicie sesión dentro del contenedor o pase KIRO_API_KEY mediante el entorno del contenedor para usarlo de forma automatizada:

docker exec -it kirocrew kiro-cli login

El comando muestra un código de dispositivo y una URL que debe abrir en su propio navegador. Después, genere un token para el panel:

docker exec kirocrew kirocrew token --ttl 2h

La URL del panel es http://localhost:5476/?token=<the token>. Los tokens caducan: el enlace mostrado debe abrirse en un plazo de cinco minutos desde su generación, y este comando solicita una cookie de acceso válida durante dos horas; veinte horas es el máximo documentado. El navegador también recibe una cookie de actualización con una ventana de inactividad deslizante de 30 días, por lo que una sesión activa se renueva sin necesidad de otro enlace. Si el panel se carga en blanco o le devuelve directamente a la pantalla de inicio de sesión, normalmente se debe a que el token ha caducado. Genere otro y ábralo inmediatamente. Nunca pegue un token en un ticket ni en un mensaje de chat, porque quien lo tenga controla su agente.

Acceda al panel mediante SSH y no publique nunca el puerto 5476

Vuelva a revisar la dirección de enlace del ejemplo del proyecto: -p 127.0.0.1:5476:5476. Dentro del contenedor, la puerta de enlace escucha en 0.0.0.0 porque debe ser accesible mediante la asignación de puertos, pero la asignación sólo publica el puerto en loopback del host. Elimine el prefijo 127.0.0.1: y la puerta de enlace quedará expuesta en Internet pública para cualquiera que analice ese puerto. Una regla de ufw tampoco le protegerá: Docker publica los puertos escribiendo reglas DNAT que encaminan el tráfico antes de que se apliquen las reglas de ufw, por lo que ufw deny 5476 no tiene ningún efecto sobre un puerto publicado. Con el backend iptables predeterminado de Docker, la propia solución de Docker consiste en colocar las reglas de filtrado en su cadena DOCKER-USER. Funciona, pero esas reglas ven la dirección y el puerto internos del contenedor, salvo que use la extensión conntrack para la coincidencia. Por eso, mantener el enlace en loopback sigue siendo el control más sencillo y menos propenso a errores. El backend nftables de Docker usa tablas nftables y cadenas base independientes para el filtrado personalizado. Puertos de Docker que omiten ufw explica este mecanismo.

Reenvíe el puerto mediante SSH desde su portátil:

ssh -N -L 5476:127.0.0.1:5476 you@your-server.example.com

Deje ese proceso en ejecución y abra http://localhost:5476/?token=<the token> localmente. Para activar el reenvío automáticamente en cada conexión, añádalo a ~/.ssh/config:

Host your-server.example.com
    LocalForward 5476 127.0.0.1:5476

Si el puerto 5476 ya está en uso en su portátil, cambie sólo el número de la izquierda: ssh -N -L 45476:127.0.0.1:5476 you@your-server.example.com y, después, abra http://localhost:45476/?token=.... No necesita ninguna configuración adicional del puerto de loopback ni recrear el contenedor: el origen loopback coincide con el Host de la propia petición, por lo que la comprobación CSRF la acepta. Empezará a encadenar reenvíos de este tipo en cuanto un segundo agente comparta el equipo, porque alojar open-kritt para análisis de seguridad coloca otro panel limitado a loopback en el mismo servidor, en el puerto 5173.

Dos comportamientos documentados determinan qué opciones puede cambiar desde el panel. Primero, la puerta de enlace trata como remota cualquier petición que incluya cabeceras de reenvío (Forwarded, X-Forwarded-* o X-Real-IP), y sus endpoints de escritura de configuración y revelación de secretos rechazan esas peticiones. Un proxy inverso añade esas cabeceras; un reenvío ssh -L simple no añade ninguna, por lo que se considera local y no se rechaza por ese motivo. Segundo, en la imagen del contenedor, las páginas de credenciales de canal y las vistas que revelan secretos son de sólo lectura para cualquier navegador que no sea directamente local, y la imagen no incluye ningún editor de texto. Si una credencial de canal no se puede guardar desde el panel, se debe a esto, no a un error. Edite la configuración en el host:

docker cp kirocrew:/home/kirocrew/.kiro/crew/config.json .
# edit config.json here
docker cp config.json kirocrew:/home/kirocrew/.kiro/crew/config.json
docker exec -u 0 kirocrew chown kirocrew:kirocrew /home/kirocrew/.kiro/crew/config.json
docker restart kirocrew

Para acceder desde el teléfono, el proyecto recomienda tailscale serve de Tailscale, que mantiene el panel dentro de su propia tailnet en lugar de publicarlo con un nombre de host público. Prefiera esta opción a un proxy inverso público. El token viaja en la URL, y la URL se escribe en cada registro de acceso de su recorrido. Esta regla se refiere a lo que hay detrás del puerto, no al puerto en sí: algo como Halcyon, que reconstruye una biblioteca de Jellyfin como una videoteca navegable de los años 90 está pensado para que otras personas lo abran y es un candidato adecuado para un proxy inverso, mientras que una puerta de enlace que puede ejecutar comandos en su servidor no lo es.

Asigne al agente el menor radio de impacto posible

El contenedor comprueba si hay compatibilidad con el aislamiento en su primer arranque. El resultado determina si los agentes pueden ejecutar algo. Si el aislamiento mediante espacios de nombres está disponible, los subprocesos de los agentes se ejecutan de forma aislada. Si no está disponible y KIROCREW_ALLOW_UNSANDBOXED=1 no está definido, la ejecución se rechaza en lugar de ejecutarse sin aislamiento. Por eso, cuando una pasarela parece estar operativa pero todas las tareas se bloquean, esta suele ser la causa. La decisión se guarda en docker logs kirocrew durante esa primera ejecución. El proyecto también publica un perfil de seccomp (modo de computación segura) que puede aplicar:

curl -fsSL https://raw.githubusercontent.com/kirodotdev/KiroCrew/main/docker/seccomp/kirocrew-seccomp.json \
  -o /opt/kirocrew/kirocrew-seccomp.json
    security_opt:
      - seccomp:./kirocrew-seccomp.json

En un host con AppArmor habilitado, la guía de Docker del proyecto considera que el perfil de seccomp sólo cubre la mitad del cambio, porque Docker también asocia su perfil de AppArmor docker-default y combina el perfil con apparmor=unconfined. Esa opción sólo desactiva las reglas de AppArmor específicas del contenedor. El perfil de seccomp, las capacidades retiradas y el usuario que no es root siguen aplicándose.

Si define KIROCREW_ALLOW_UNSANDBOXED=1, deje claro qué ha cambiado: el contenedor pasa a ser la única frontera entre el agente y su servidor. Conviene repetir íntegramente la advertencia del proyecto. No monte rutas del host que no entregaría directamente al agente. En la práctica, esto descarta el socket de Docker, cualquier bind mount de / y cualquier directorio que contenga datos de otro servicio.

El resto es el marco que se aplica a todos los agentes autorizados a ejecutar comandos. Limite sus credenciales al único repositorio o al único bucket que necesite. No use nunca un token personal con permisos para toda la cuenta. Ejecútelo como un usuario dedicado cuyo directorio personal no contenga nada más. Para eso sirve usar usuarios con privilegios mínimos en un VPS. Cuando el agente escriba código y después lo ejecute, asígnele una máquina que pueda dejar inutilizable: una VM desechable para agentes de programación ofrece una frontera más sólida que cualquier opción de este archivo compose, porque puede eliminarla en lugar de limpiarla. El mismo razonamiento se aplica a ejecutar OpenClaw de forma segura en un VPS y a alojar el agente Hermes en un VPS. Las herramientas también forman parte del radio de impacto: si entrega al agente acceso a búsquedas web, cada página que consulte se convierte en entrada no confiable. Por eso, dirigirlo a su propia instancia de SearXNG es una decisión relacionada con la inyección de prompts tanto como con la configuración de red. Los trabajos programados también consumen dinero mientras duerme, porque la inferencia en los backends de Kiro utiliza su plan de Kiro. Establezca los límites descritos en controlar el coste de un agente de IA en un VPS antes de añadir una tarea nocturna.

Haga una copia de seguridad del volumen de estado antes de cada actualización

Primero, busque el nombre real del volumen. Compose antepone el nombre del proyecto a los volúmenes con nombre. De forma predeterminada, usa el nombre del directorio. Por tanto, el volumen declarado como kirocrew-home en /opt/kirocrew/compose.yaml se crea como kirocrew_kirocrew-home:

docker volume ls

Detenga el gateway antes de copiar cualquier archivo. memory.db y memory_index.db son bases de datos SQLite. Copiar una base de datos mientras se está escribiendo puede capturar una transacción a medio escribir y restaurarla como un archivo dañado. Las instrucciones de migración del propio proyecto indican lo mismo: mueva la memoria sólo mientras los gateways estén detenidos. Esta regla de detener primero no es exclusiva de KiroCrew. Si un servidor de fotos comparte el equipo, la comparación entre PhotoPrism e Immich incluye los comandos de copia de seguridad exactos que necesita cada uno de ellos.

sudo systemctl stop kirocrew
docker run --rm -v kirocrew_kirocrew-home:/data:ro -v "$PWD":/backup \
  alpine tar czf /backup/kirocrew-2026-08-06.tgz -C /data .
sudo systemctl start kirocrew

Copie el archivo comprimido fuera del equipo. La restauración usa el mismo comando, con el contenedor detenido y tar xzf en lugar de tar czf:

sudo systemctl stop kirocrew
docker run --rm -v kirocrew_kirocrew-home:/data -v "$PWD":/backup \
  alpine tar xzf /backup/kirocrew-2026-08-06.tgz -C /data
sudo systemctl start kirocrew

Migrar a un host nuevo es una tarea distinta de restaurar en el mismo host, y el proyecto especifica cómo hacerlo. El historial de chat y las notas del proyecto almacenados en workspace/memory/ se conservan. También se conservan los dos archivos de base de datos y config.json. Los archivos PID, el registro de eventos de seguridad y .env están vinculados al host antiguo. No los copie y vuelva a introducir los secretos en el equipo nuevo.

Cómo revertir una actualización fallida

La actualización es breve y solo es segura porque fijó una versión. Realice primero la copia de seguridad y, a continuación, cambie la etiqueta:

sudo systemctl stop kirocrew
# take the backup here, as above
sudo nano /opt/kirocrew/compose.yaml   # set the new image tag
sudo systemctl start kirocrew
docker compose -f /opt/kirocrew/compose.yaml ps
curl -s http://127.0.0.1:5476/api/health

docker compose up -d descarga la imagen si aún no está en el equipo, por lo que la edición de la etiqueta constituye toda la actualización. Revertir es la misma secuencia con el número antiguo, lo que le devuelve exactamente la imagen que tenía antes, ya que las etiquetas de versión son inmutables.

El binario se revierte de forma limpia. El estado es la parte que podría no hacerlo. Una puerta de enlace más reciente puede sobrescribir config.json o migrar las bases de datos en memoria a un formato que una puerta de enlace antigua no puede leer, y no existe una ruta de degradación documentada para el estado a fecha de 12 de octubre de 2026. La guía de instalación es directa sobre un caso: los datos movidos fuera del directorio raíz heredado ~/.kirocrew no tienen reversión, y una versión anterior a ~/.kiro/crew arrancaría vacía. Por tanto, si la imagen antigua arranca y luego se comporta de forma extraña, no intente depurarla. Deténgala, restaure la copia de seguridad que realizó antes de la actualización y comience de nuevo. Esa es la razón principal por la que la copia de seguridad es lo primero, y es por lo que el hábito de actualizar ahora y hacer la copia de seguridad después falla en un proyecto tan reciente.

Lo que no está probado aquí

Sea honesto sobre la antigüedad de este software. La versión 0.1.3 se lanzó el 5 de agosto de 2026 y, para el 12 de octubre de 2026, la línea estable había alcanzado la 0.8.0. La mayoría de las notas de versión siguen siendo registros de cambios automatizados; las notas de la 0.8.0 están redactadas manualmente pero no incluyen una sección de migración, y el historial de lanzamientos públicos tiene una duración de aproximadamente tres meses. Nada en esta guía es un resultado a largo plazo, así que considere el crecimiento de la memoria, el tamaño de la base de datos y la fiabilidad del programador como aspectos que debe medir en su propio equipo, en lugar de darlos por sentados.

Vale la pena probar dos comportamientos por su cuenta antes de depender de ellos. Primero, si una degradación de versión puede leer el estado escrito por una versión más reciente: pruébelo en una copia del volumen cuando no sea crítico, no durante una interrupción. Segundo, qué hace la pasarela cuando la sesión de inicio de Kiro expira mientras hay una tarea programada pendiente. Ambos son el tipo de asperezas que un proyecto joven elimina discretamente entre lanzamientos, y ambos son fáciles de verificar ahora.

FAQ

¿Por qué no se abre el panel de KiroCrew en la IP pública de mi servidor?

Porque el ejemplo publicado enlaza el puerto con loopback. -p 127.0.0.1:5476:5476 asigna el puerto del contenedor sólo a la dirección loopback del host, de forma deliberada. Acceda mediante el reenvío del puerto por SSH con ssh -N -L 5476:127.0.0.1:5476 you@your-server y, después, abra http://localhost:5476/?token=<token> en su portátil. Eliminar el prefijo 127.0.0.1: para hacerlo accesible expone el gateway a Internet pública. ufw no lo contendrá, porque las reglas DNAT de los puertos publicados por Docker encaminan el tráfico antes de que se apliquen las reglas de ufw. Use la cadena DOCKER-USER de Docker con su backend de iptables, o cadenas base independientes de nftables con su backend de nftables, para filtrar los puertos publicados. Mantener el enlace con loopback es más sencillo.

¿Dónde almacena KiroCrew sus datos y qué debo respaldar?

Todo se encuentra en ~/.kiro/crew, que corresponde a /home/kirocrew/.kiro/crew dentro de la imagen del contenedor, y KIROCREW_HOME lo reubica. Haga una copia de seguridad de todo el directorio o de todo el volumen de Docker, con el gateway detenido. memory.db y memory_index.db son bases de datos SQLite, por lo que una copia realizada mientras el gateway escribe puede ser incoherente. Al migrar a un host nuevo, workspace/memory/, los dos archivos de base de datos y config.json se trasladan, mientras que los archivos PID, el registro de eventos de seguridad y .env pertenecen al host antiguo.

¿Debo usar la etiqueta stable o una etiqueta de versión?

Use una etiqueta de versión. stable cambia cada vez que se publica una versión, por lo que la versión que ejecuta puede cambiar en la siguiente extracción, y la propia etiqueta no indica qué se está ejecutando. Las etiquetas de versión, como 0.8.0, son inmutables. Eso es precisamente lo que permite una reversión: restaura el número anterior y obtiene la misma imagen. A fecha de 1 November 2026, la versión estable más reciente es 0.11.1.

¿Por qué mi agente se niega a ejecutar comandos?

El contenedor comprueba la compatibilidad con el sandbox durante su primer arranque. Si no puede aislar los subprocesos del agente y KIROCREW_ALLOW_UNSANDBOXED=1 no está definido, se niega a ejecutarlos en lugar de ejecutarlos sin aislamiento. Por eso el gateway parece estar operativo mientras todas las tareas se quedan bloqueadas. docker logs kirocrew muestra la decisión sobre el sandbox tomada durante esa primera ejecución. Al definir la variable, el contenedor se convierte en el único límite entre el agente y el host. Por tanto, si la define, no monte nada que no entregaría directamente al agente.

¿Necesito una cuenta de Kiro para alojar KiroCrew por mi cuenta?

Para los backends de Kiro, sí, a fecha de 1 November 2026. KiroCrew es software libre bajo Apache 2.0, pero la inferencia en esos backends utiliza su plan de Kiro. El contenedor 0.8.0 fijado usa Kiro CLI: ejecute docker exec -it kirocrew kiro-cli login y apruebe el código del dispositivo en el navegador, o pase KIRO_API_KEY mediante el entorno del contenedor para usarlo de forma automatizada. Hasta que configure la autenticación, el gateway arranca y el panel se carga, pero su harness predeterminado no tiene ningún modelo con el que comunicarse. Desde 0.10.0 también existe un motor KAS integrado que no necesita tener instalado kiro-cli. 0.11.0 convirtió KAS en el predeterminado para las instalaciones nuevas sin una selección de harness guardada, y mantiene las selecciones explícitas de Kiro CLI. KAS utiliza el inicio de sesión propio de Crew en lugar de kiro-cli login. La guía de backends personalizados del proyecto permite que un harness claude envíe las interacciones principales con el modelo a un endpoint compatible con Anthropic que usted elija, pero el inicio de sesión de kiro-cli sigue siendo necesario para las funciones específicas de Kiro.

¿Te resultó útil este artículo?