Un agente de IA corriendo en un IBM PC XT de 640K
ClawDOS es un agente de codificación con IA que funciona sobre DOS en un IBM PC XT 5160: un 8088 a 4.77 MHz, 640K de RAM y una tarjeta CGA. Se invoca escribiendo CLAWDOS en el prompt C:\> y, desde ahí, lee y edita archivos del disco, escribe programas, los compila con Turbo C, los ejecuta y observa lo que dibujan en pantalla.
Para un founder que hoy pelea por bajar el costo por token y la latencia de su agente, el experimento es más útil de lo que parece. Es un ejercicio de ingeniería bajo restricciones extremas, y las decisiones que tomó su autor son las mismas que separan a un agente que escala de uno que se cae en producción.
El proyecto nació de una historia personal: el IBM PC fue la primera computadora de su autor, la máquina de sus padres que usó desde muy chico. Ya estaba obsoleta cuando aprendió a tipear y a usar DOS para lanzar juegos de «aprender el alfabeto», y con BASIC apenas llegó a armar juegos de adivinanza de números. Años después conserva parte de las piezas originales y una colección de máquinas vintage, con su IBM PC 5160 como pieza central. El disco duro de 20 MB sigue funcionando, pero está desconectado en favor de una PicoMEM que emula un disco duro desde una tarjeta microSD.
Leíste lo que hace la IA. ¿Y en tu negocio?
Un agente de IA puede quedarse con parte de tu día: ordenar lo pendiente y pedirte el OK antes de actuar. El Kit «tu mano derecha con IA» trae un video de 11 minutos y una ficha para dejar al tuyo trabajando. CAR está cerrada por ahora; al anotarte, te avisamos cuando abra.
👥 Quiero el Kit →El detalle que más incomoda: el 100% del repositorio fue escrito por Claude, con la única excepción del texto de presentación. El autor construyó un agente de IA pidiéndole a un agente de IA que construyera un agente de IA.
Cómo funciona un agente de IA en hardware de 1980
La arquitectura resuelve un problema que el 8088 no puede resolver: TLS. El harness corre nativo en el PC, pero el cifrado queda afuera.
- HARNESS.EXE es un programa DOS de 176 KB que habla directamente la Claude Messages API: escribe los requests, parsea la respuesta en streaming, ejecuta las herramientas y guarda cada conversación en su propio archivo de disco. El 8088 hace todo menos TLS.
- CLAWDOS.EXE es el lanzador de 29 KB que el usuario invoca.
- mTCP con un packet driver maneja TCP/IP sobre FreeDOS 1.4, y sale por HTTP plano hacia un túnel TLS que corre en otra máquina (
tunnel/tunnel.py,socatostunnel). Ese túnel copia bytes entre un puerto plano yapi.anthropic.com:443, y puede quedarse con la API key, de modo que la clave nunca toca el disco del PC. - El código son 13.000 líneas de C y C++, compiladas con Open Watcom para el set de instrucciones 8086.
El agente expone 18 herramientas agrupadas por función: sysinfo, dir, read y search para mirar el sistema; write, edit, delete, mkdir y rename para tocar archivos; run para ejecutar programas DOS y archivos batch y leer lo que imprimieron, hasta doce comandos en una sola llamada y con captura de pantalla a pedido; peek, poke y port para memoria y puertos de E/S; play y textart para música del parlante y arte en CP437; y memory_list, memory_read, memory_write para sus propias notas.
En el disco hay además un kit de desarrollo: dos ensambladores (TINYASM y WASM), Bruce’s C, GW-BASIC, el debugger lDebug y Turbo C 2.0, instalado desde las imágenes de disquete del propio usuario.
Qué construyó la IA sola en un 8088
El caso más citado en la documentación es una sola instrucción: «Write PRIMES.C: print the primes below 100. Compile it with Turbo C and run it.» ClawDOS lee su guía de compiladores, escribe el código fuente, y en una única llamada de herramienta compila, enlaza y ejecuta. La respuesta está en pantalla 64 segundos después de Enter, de los cuales 26 se fueron en compilar, enlazar y correr.
Para lograrlo hay una decisión de diseño fina: el compilador se queda con la máquina. ClawDOS guarda su estado y se retira de memoria, Turbo C corre con unos 450K libres, y el harness vuelve sobre la misma conversación con el output del programa en mano. Un programa que ClawDOS ejecuta recibe 200K al lado del harness, o 450K cuando el harness se hace a un lado.
El segundo caso es un homenaje al film WarGames de 1983, escrito en el propio PC: un mapa vectorial del mundo, misiles que cruzan el polo, un final de tic-tac-toe y una banda sonora para el parlante del PC o una placa AdLib. Son cinco archivos de Turbo C, 15 KB de código fuente y un WG.EXE de menos de 10 KB. Cuando el usuario abre una conversación nueva y escribe «your WarGames demo», ClawDOS abre la nota que guardó en C:\MEMORY, encuentra el último build y recuerda el truco de paleta que la escena de guerra hace sobre la CGA.
También hay evidencia visual del ciclo completo: una llamada a run pidió una captura 25 segundos después de arrancar. Un hook del timer copia la memoria de video de la CGA en ese instante, el 8088 la codifica como PNG y la imagen viaja a Claude junto con el resultado de la herramienta. El archivo que produjo el PC es de 320×200 en cuatro colores, 16 KB.
Memoria, safe mode y flight recorder: tres patrones que puedes copiar
Más allá del mérito nostálgico, ClawDOS implementa tres patrones que cualquier equipo construyendo agentes debería mirar.
Memoria como archivos de texto plano. Las memories son lo que ClawDOS aprende en tu PC: qué construyeron juntos, qué funcionó, qué te gusta. Las skills son guías que vienen con el sistema, como las de herramientas de desarrollo y efectos de demo para CGA. Ambas son archivos de texto plano en el disco, listados en el system prompt de cada conversación y leídos cuando encajan con la tarea. Nada de una base vectorial opaca: texto que puedes abrir, editar y versionar.
Safe mode por defecto. Cualquier acción que cambie un archivo, una memoria o un puerto pregunta primero Allow...? (y/n). Viene activado y se apaga con F3. Es el principio de mínimo privilegio aplicado a un agente que tiene acceso directo al disco.
Flight recorder. CLAWDOS.LOG deja una línea por cada ronda: tiempo al primer token, tamaño y tiempo de subida, tokens de entrada y salida y lecturas de caché. La documentación muestra una línea real con ttft=2750, total=4015, up=165, in=2, out=221, cr=5543 y cw=739. También registra cuánto se ausentó el harness mientras el compilador trabajaba: 61,5 segundos de programa y 82,3 segundos de ClawDOS afuera.
¿Qué significa esto para tu startup?
El valor de este proyecto no está en el hardware, sino en el presupuesto de recursos. Si un agente puede operar con 640K de RAM y un enlace lento, tu agente en la nube no tiene excusa para ser ineficiente.
- Instrumenta tu agente desde el día uno. Copia el patrón del flight recorder: registra tiempo al primer token, tokens de entrada y salida, y lecturas de caché por cada ronda. Sin esos números no puedes optimizar costos ni diagnosticar por qué una tarea se siente lenta.
- Aprovecha el prompt caching de forma agresiva. En ClawDOS, el system prompt y las herramientas quedan cacheados por la API: después del primer request de una conversación, el PC sube solo lo nuevo, y un resultado de herramienta viaja en unos 500 bytes. Ese mismo diseño es el que baja tu factura cuando tu agente encadena decenas de llamadas.
- Diseña la memoria como archivos legibles, no como caja negra. Que el agente guarde sus notas en texto plano y las liste en el system prompt hace que el comportamiento sea auditable y corregible a mano. Es más fácil de depurar que un índice vectorial cuando algo sale mal.
- Pon confirmación humana en las acciones destructivas. El safe mode de ClawDOS es un recordatorio de que un agente con acceso a archivos, memoria y puertos necesita fricción deliberada antes de escribir.
- Separa lo que tu stack no puede hacer. El 8088 no puede con TLS, así que el autor movió el cifrado a otra máquina y dejó que el túnel se quede con la API key. El mismo razonamiento aplica a cualquier componente que tu aplicación no debería manejar directamente.
- Cuida la licencia de lo que empaquetas. ClawDOS es software libre bajo GPLv3 o posterior, y el propio autor advierte que las imágenes de disco que construyas incluyen software de terceros: FreeDOS, mTCP y Turbo C desde tus propios disquetes. No redistribuyas una imagen con Turbo C adentro. Si tu producto embebe binarios de terceros, revisa esa cadena antes de publicar.
Conclusión
ClawDOS es, en el papel, un chiste de ingeniería: un agente de IA que compila y ejecuta programas en una máquina de 4.77 MHz. En la práctica es un catálogo de decisiones correctas tomadas bajo presión extrema. Cuando el hardware no perdona, la arquitectura se vuelve explícita: qué corre en el cliente, qué se delega, qué se cachea, qué se registra y qué requiere confirmación humana.
La lección para un founder es incómoda y simple. Si tu agente consume demasiados tokens, tarda demasiado o hace cosas que no debería, probablemente no sea un problema de modelo, sino de diseño del harness. Un proyecto que corre en un IBM PC XT demuestra que el margen de optimización es mucho más grande de lo que parece.
No se encontraron datos adicionales verificables en las búsquedas realizadas para esta nota; el análisis se apoya en la documentación publicada del proyecto.
Fuentes
- ClawDOS – An AI coding agent for DOS (fuente original)
Leíste lo que hace la IA. ¿Y en tu negocio?
Un agente de IA puede quedarse con parte de tu día: ordenar lo pendiente y pedirte el OK antes de actuar. El Kit «tu mano derecha con IA» trae un video de 11 minutos y una ficha para dejar al tuyo trabajando. CAR está cerrada por ahora; al anotarte, te avisamos cuando abra.
👥 Quiero el Kit →













