Перейти к содержанию
Публикация AiManual

ClawDOS: как ИИ-агент пишет и компилирует код на IBM PC под DOS

ClawDOS - открытый ИИ-агент, который на IBM PC 5160 с процессором 8088 пишет код, компилирует его через Turbo C и сам разбирает вывод программ. Разбираем HARNES

Коротко

Что будет в материале

  1. 01

    Что такое ClawDOS и что именно сделал Рич Акоста

  2. 02

    Архитектура: что делает 8088, а что - «мост» и API

  3. 03

    Как агент компилирует код при жёстком лимите памяти

  4. 04

    Пример PRIMES.C: что именно сгенерировал агент и сколько это заняло

ClawDOS - открытый проект ИИ-агента, который пишет, компилирует и запускает программы прямо в среде DOS. Проект представил разработчик Рич Акоста совместно с Claude; описание опубликовано на Habr. Основная программа HARNESS.EXE занимает 176 КБ и работает на оригинальном IBM PC 5160 с процессором 8088 на частоте 4,77 МГц.

Запуск выглядит привычно для 1980-х: в командной строке C:\> набирается CLAWDOS, дальше можно ставить задачи Claude. Агент читает и редактирует файлы на диске, пишет исходники, компилирует их через Turbo C, запускает и разбирает то, что программы выводят на экран. История каждого диалога сохраняется на диске, поэтому контекст переходит из сеанса в сеанс и работу можно продолжить с того места, где вы остановились.

Массовым продуктом ClawDOS не назвать. Это инженерный эксперимент с конкретным вопросом: на что способен ИИ-агент в условиях, далёких от современных стандартов, и сможет ли созданный им продукт создать что-то ещё. По словам автора, весь код репозитория написала нейросеть Claude, за исключением текста описания.

Одна деталь, которую стоит держать в голове: скриншот проекта получен на IBM PC 5160 с тактовой частотой 4,77 МГц, эмулируемой в 86Box, при этом обмен шёл с реальным API.

Что такое ClawDOS и что именно сделал Рич Акоста

Схема простая: 8088-машина держит на себе агентский цикл, а тяжёлую сетевую часть отдаёт наружу. Всё, что происходит между запросом пользователя и готовой программой, крутится на железе 1980-х. Модель при этом современная, доступ к ней идёт по сети.

Автор не случайно взялся именно за IBM PC 5160. У него собрана коллекция винтажной техники, и центральное место в ней занимает максимально укомплектованный IBM PC 5160: жёсткий диск на 20 МБ в нём исправен, но отключён в пользу модуля PicoMEM, который эмулирует диск через SD-карту. IBM PC был и первым компьютером в семье автора: он учился печатать и работать в DOS, чтобы запускать развивающие игры, и немного освоил BASIC. Проект вырос из этой истории, но задачи у него инженерные, а не ностальгические.

Ключевые характеристики проекта в одном месте

ПараметрЗначение
НазваниеClawDOS, открытый проект
АвторРич Акоста, при участии Claude
Основная программаHARNESS.EXE, 176 КБ
ПлатформаIBM PC 5160, процессор 8088, 4,77 МГц
Операционная системаDOS
КомпиляторTurbo C
Связь с модельюAPI сообщений Claude
TLSпромежуточный компьютер-«мост»
Память при сборкеагент выгружается, Turbo C получает около 450 КБ
Контекстистория диалогов хранится на диске, сохраняется между сеансами
ЛицензияGPLv3
Запусккоманда CLAWDOS в C:\>

Архитектура: что делает 8088, а что - «мост» и API

Вся логика агента умещается в HARNESS.EXE. Программа формирует запросы к API сообщений Claude, разбирает поступающие ответы, запускает нужные инструменты и сохраняет историю каждого диалога на диске. Процессор 8088 при этом выполняет все задачи, за исключением работы с протоколом TLS.

Инструменты, доступные агенту, укладываются в короткий список:

  • чтение файлов на диске;
  • правка и создание файлов, включая исходники;
  • компиляция программ через Turbo C;
  • запуск собранной программы и анализ того, что она вывела на экран.

История диалога лежит на диске, и это ключевая деталь конструкции. Агент не держит всю переписку в оперативной памяти, которой у 8088 критически мало. По всей видимости, сохранённые сообщения подставляются в следующий запрос к API, а ответ дописывается в тот же файл. Отсюда и сохранение контекста между сеансами: сессию можно закрыть, а на следующий день продолжить с той же точки. Формат хранения истории в описании проекта не раскрыт.

Почему TLS не отдать 8088

TLS требует асимметричной криптографии для рукопожатия, вычислений с большими числами, симметричного шифрования потока, хеширования и разбора цепочки сертификатов. У 8088 нет ни удобных 32-битных регистров, ни быстрого умножения: операции, которые на современном процессоре укладываются в такты, здесь разворачиваются в десятки и сотни машинных инструкций. Добавьте буферы под сертификаты и сессионные ключи, и станет понятно, почему в описании сказано прямо: с этой задачей процессор 8088 попросту не смог бы справиться.

Отсюда схема с промежуточным компьютером-«мостом», который берёт TLS на себя. 8088-коду остаётся незашифрованный обмен с мостом, а тот говорит с API по защищённому каналу. Мост - внешнее звено, а не часть DOS-программы; какие именно протоколы и софт он использует, в описании проекта не уточняется.

Как агент компилирует код при жёстком лимите памяти

Классический лимит реального режима DOS - 640 КБ оперативной памяти на всё сразу: ядро системы, драйверы, резидентные программы и прикладной код. В эту же память должны поместиться агент и компилятор с его рабочими буферами. Компромисс найден радикальный: на время сборки ClawDOS сохраняет текущее состояние и выгружается из памяти, предоставляя Turbo C около 450 КБ свободного пространства.

Последовательность в этом случае выглядит так:

  1. Агент получает от модели исходник и записывает его в файл на диске.
  2. Сохраняет текущее состояние и освобождает память: на время сборки в ней остаётся компилятор, а не агент.
  3. Запускает Turbo C, который получает около 450 КБ и собирает программу.
  4. По завершении работы программы возвращается в исходный контекст, уже имея на руках полученный результат, и разбирает вывод компилятора или собранной программы.

Магии ИИ в этом нет: приём целиком из арсенала DOS-программирования, где резидентные модули, оверлеи и запуск внешних процессов с освобождением памяти были нормой. Интерес в другом. Языковая модель ставит задачу, а инфраструктура под неё вынуждена решать вопросы, о которых в современных харнесах мало кто думает: гигабайты памяти снимают проблему целиком. Как выглядят харнесы для многодневной автономной работы на современном железе, разбираем в отдельном материале про харнес и память в файлах.

Пример PRIMES.C: что именно сгенерировал агент и сколько это заняло

Пример, на котором видно весь цикл, - PRIMES.C. Запрос в описании проекта выглядит так: «Напиши PRIMES.C: выведи простые числа меньше 100. Скомпилируй с помощью Turbo…». Цитата в доступном фрагменте обрывается, поэтому полный текст задачи и вывод программы по описанию не восстановить.

Сам цикл повторяет схему из предыдущего раздела: модель отдаёт код, HARNESS.EXE пишет его на диск, сохраняет состояние и выгружается из памяти, вызывает Turbo C, возвращается с результатом и анализирует его. Судя по механике, пользователь видит на экране пошаговый лог: что агент делает, чем закончилась сборка и что программа напечатала. Для задачи на простые числа меньше 100 результат проверяется глазами: 2, 3, 5, 7 и далее до 97. Доверять модели на слово здесь не требуется.

По времени честная рамка такая: конкретных замеров в доступном описании нет, поэтому подставлять свои цифры бессмысленно. Понятно другое: узкие места не в модели. Время цикла складывается из задержки API, отрисовки текста на 4,77 МГц и компиляции на 8088, где даже небольшой файл собирается заметно дольше, чем на современной машине. Скорость здесь не цель, а цена демонстрации принципиальной возможности.

Сохранение контекста превращает разовый запуск в итеративную разработку: программу можно попросить доработать, не пересказывая заново всю постановку. Похожий цикл, где модель пишет, а запуск проверяет, разобран в материале про сканер NTFS без IDE: там код тоже правился по результатам реальных прогонов, а не по красоте диффа.

Демонстрационный проект в духе WarGames

В описании проекта представлен демонстрационный сценарий в духе фильма WarGames 1983 года: ClawDOS написала эту дань уважения фильму на самом ПК. В неё входят векторная карта мира, ракеты, пролетающие над полюсом, эндшпиль в виде крестиков-ноликов и партитура для динамика ПК или карты AdLib.

Отсылка к фильму читается сразу: компьютер WOPR ведёт диалог с человеком, предлагает сыграть и в финальной сцене перебирает партии в крестики-нолики вместо симуляции ядерной войны. Для агента, который сам пишет и запускает код на IBM PC, это узнаваемая витрина.

Роль такого демо понятна и без подробностей реализации. Оно связывает исходную мотивацию автора, «сможет ли созданный продукт создать что-то ещё», с понятным ретро-контекстом, где машина разговаривает с человеком и что-то делает сама. Как именно устроены отдельные элементы сценария и сколько времени заняла его разработка, в описании проекта не раскрыто.

Как запустить ClawDOS на современной машине

Повторять эксперимент на IBM PC 5160 не обязательно. Для запуска проекта понадобится компьютер (Mac или Windows) с установленным Python 3, а также API-ключ Anthropic. Смысл в том, чтобы отладить поведение агента в привычной среде: цикл запросов проходит быстрее, ошибки разбора ответов видно сразу, файлы и логи лежат под рукой. После этого те же сценарии переносятся на ретро-железо или в эмулятор.

Точные команды установки, имена переменных окружения и список зависимостей в описании проекта не приведены, их нужно брать из README репозитория. Если конфигурация расходится с README, доверять стоит актуальному файлу в репозитории, а не пересказам в сторонних материалах.

Офлайн-режим через mockapi

Если ключа нет, можно запустить python3 tunnel/mockapi.py, чтобы эмулировать API в офлайн-режиме: введите CLAWDOS 10.0.2.2:18023 и отправьте команду !help. Запросы наружу при этом не уходят. Режим полезен для трёх вещей: проверить цикл «запрос - ответ - инструмент» без расхода токенов, отладить разбор ответов и убедиться, что агент корректно читает и правит файлы. Граница простая: mockapi не показывает, насколько хорошо модель пишет код. Он проверяет механику харнеса, а качество генерации придётся смотреть на реальных запросах с ключом.

Эмуляция IBM PC 5160 в 86Box

Скриншот проекта получен на IBM PC 5160 с частотой 4,77 МГц, эмулируемой в 86Box, при работе с реальным API. Для повторения нужны эмулятор и образ DOS. Плюс в воспроизводимости: конфигурацию можно зафиксировать и раздать, не разыскивая работающий IBM PC 5160 с модулем PicoMEM. Минус в том, что эмуляция не заменяет железо. Тайминги дисковых операций и поведение видеоадаптера могут отличаться, а часть ощущений от оригинала теряется.

Лицензия GPLv3 и ограничения на образы с Turbo C

Правовых слоёв здесь два, и путать их не стоит.

Первый - лицензия самого ClawDOS. Проект распространяется как свободное программное обеспечение на условиях GNU General Public License версии 3; в состав HARNESS.EXE включён пакет mTCP, который также распространяется по GPLv3. Код можно изучать, менять и распространять, но производные работы нужно выпускать под той же лицензией и предоставлять исходники. Практический эффект для форка: изменения не получится закрыть, а уведомления об авторстве и текст лицензии должны остаться в репозитории.

Второй слой - Turbo C. Это сторонний проприетарный компилятор, и создаваемые пользователями образы дисков содержат стороннее ПО: FreeDOS, mTCP, а также Turbo C, если используются собственные дискеты с этим компилятором. Образы, содержащие Turbo C, распространять не следует. Отсюда рабочая схема: распространяются код и инструкция, а компилятор пользователь получает сам.

Юридических гарантий здесь быть не может. Конкретные условия зависят от версии Turbo C и способа, которым она получена, поэтому сверяйтесь с текстом лицензий и файлом LICENSE в репозитории, а спорные случаи обсуждайте с правообладателем.

Кому нужен ClawDOS и какие у него ограничения

Польза проекта в двух вещах. Первая: наглядная демонстрация агентского цикла в среде, где нет ни гигабайтов памяти, ни готового TLS-стека. Вторая: компактный пример харнеса, который целиком помещается в 176 КБ и при этом умеет вести диалог, вызывать инструменты и хранить историю. Для тех, кто делает своих агентов, это редкий случай посмотреть на минимализм без обёрток в сотни мегабайт.

Ограничения стоит назвать прямо:

  • скорость: 8088 на 4,77 МГц и медленный диск растягивают цикл из нескольких шагов;
  • память: агент и компилятор не живут в ней одновременно, отсюда выгрузка и потолок около 450 КБ для Turbo C;
  • зависимость от внешнего моста и API: без промежуточного компьютера и доступа к Claude конструкция не работает;
  • проприетарный Turbo C с ограничениями на распространение образов;
  • узкая применимость: для повседневной разработки это не замена современным инструментам.

Кому будет полезно: разработчикам агентов и харнесов, ретро-энтузиастам с коллекцией техники, преподавателям, которым нужен живой пример ограничений реального режима. Кому нет: тем, кто ищет рабочий инструмент для ежедневного кодинга. Как выглядит такой инструмент сегодня, разбираем в обзоре Claude Code как CLI-агента; про цикл «написание - ревью - правки» между моделями есть отдельный разбор skill-подхода.

Что в итоге показывает ClawDOS

ClawDOS показывает не производительность, а проверку гипотезы: ИИ-агент способен работать там, где стандарты отличаются от современных на десятилетия, и создавать работающие программы. В конструкции сходятся несколько решений: HARNESS.EXE на 176 КБ, 8088 на 4,77 МГц, TLS на промежуточном мосту, Turbo C с примерно 450 КБ памяти, история диалогов на диске и GPLv3 на сам код.

Каждое из них по отдельности не новость. Интересна сборка: она отвечает на вопрос, что останется от современного агента, если убрать гигабайты памяти и быстрый процессор. Останется цикл «запрос - инструмент - проверка результата», который и делает агента агентом.

Следующий шаг простой: открыть описание проекта и репозиторий по ссылке из него, посмотреть, как устроен HARNESS.EXE, и запустить агента на современной машине с Python 3 и ключом Anthropic либо офлайн через mockapi. После этого станет понятно, нужен ли вам IBM PC 5160 в качестве полигона.

Подписаться на канал