跳到正文
Hacker News· Ricapar·· 13 小时前AI 评分50

ClawDOS:在 IBM PC XT 上运行的 DOS AI 编程智能体

ClawDOS – An AI coding agent for DOS

AI 导读

ClawDOS 是一个运行在 IBM PC XT(8088 4.77 MHz、640K 内存、CGA 显卡)上的 AI 编程智能体,整个 harness 为 176 KB 的 DOS 程序 HARNESS.EXE,直接调用 Claude Messages API,仅 TLS 由一台桥接 PC 处理。

正文 · AI 翻译

Ricapar/ClawDOS

ClawDOS

一个运行在 DOS 上的 AI 编程智能体。
它运行在一台 IBM PC XT 上:4.77 MHz 的 8088 处理器、640K 内存、一块 CGA 显卡。

一位(真正的)人类的说明:


背景故事:IBM PC 是我的第一台电脑。更准确地说,那是我父母的第一台个人电脑,而我在很小的时候就开始使用它了。

等我大到能使用它时,它早已过时,但在 5 岁的我眼里,它是一台神奇的设备——我只要输入不同的内容,就能让它做不同的事。

我学会了打字和使用 DOS,这样就能启动妈妈给我买的一些早期“学字母”游戏。我学了一些基础级别的 BASIC,但当时也就止步于做几个猜数字游戏和其他小项目。

从那以后,许多年过去了,但我仍然保留着那台 PC 的一些原装部件。我收藏了一批对我有意义的古董机器,其中完全满配的 IBM PC 5160 是我的收藏核心。它的 20 MB 硬盘仍然能用,但我把它断开了,改用 PicoMEM 从 SD 卡模拟硬盘,这让实验和把玩变得容易得多。

旧物遇见新物。新物遇见旧物:我喜欢新旧技术的交汇。还有什么比在原始硬件上、在 DOS 上构建一个 AI 编程智能体更好的方式来跨越两者呢?

当然,还有什么比用一个 AI 编程智能体来构建它更好的呢?

我(准确说是 Claude)做这个是为了自娱自乐。我想看看,在远离(现代)常规约束的条件下,我能把一个 AI 编程智能体推到什么程度去构建东西。另外,它构建出的东西还能再构建别的东西吗?这个仓库 100% 由 Claude 编写,除了这个方框里的文字。

如下文更详细说明的那样,这套运行框架运行在原生操作系统和硬件上,并依赖一台“桥接”PC 来处理 TLS——这超出了 8088 的处理能力。

The ClawDOS opening screen

在 C:\> 提示符下输入 CLAWDOS,就能和 Claude 对话。它会读取并编辑你磁盘上的文件,编写程序,用 Turbo C 编译它们,运行它们,并查看它们在屏幕上绘制的内容。它会在对话之间保存笔记,并从上次中断的地方继续。

整套运行框架都运行在这台 PC 上。HARNESS.EXE 是一个 176 KB 的 DOS 程序,它自己直接与 Claude Messages API 通信:它编写请求、解析流式回复、运行工具,并把每次对话保存在各自的磁盘上。除了 TLS,8088 什么都做。

看看它如何工作

下面的每一屏都来自一台在 86Box 中模拟的、运行频率 4.77 MHz 的 5160。对话是与实时 API 进行的。

从一句话到一个运行中的程序

ClawDOS writes, compiles and runs PRIMES.C

一条消息:“编写 PRIMES.C:打印 100 以内的素数。用 Turbo C 编译并运行它。” ClawDOS 阅读它关于这台机器上编译器的指南,编写源代码,然后在一次工具调用中完成编译、链接和运行。按下回车 64 秒后,答案就出现在屏幕上,其中 26 秒用于编译、链接和运行。

编译器独占整台机器。构建时,ClawDOS 保存自己的状态并让出内存,Turbo C 在约 450K 可用内存下运行,随后运行框架带着程序的输出回到同一段对话中。

在 XT 上编写的 WarGames

ClawDOS 在 PC 本机上写下了这部 1983 年电影的致敬之作:一张矢量世界地图、飞越极点的导弹弧线、一局井字棋终局,以及为 PC 扬声器或 AdLib 声卡谱写的配乐。五个 Turbo C 文件,15 KB 源码,一个不到 10 KB 的WG.EXE。

GREETINGS PROFESSOR FALKEN. SHALL WE PLAY A GAME? Global Thermonuclear War: missile arcs over a world map

Tic-tac-toe games played to a draw The only winning move is not to play

这是在真正的 5160 上运行,从它的 IBM 显示器上拍摄的:

Video: the WarGames demo running on a real IBM PC 5160 (YouTube)
▶ 在 YouTube 上观看 WarGames 演示

它记得

开一段新对话,只需说“你的 WarGames 演示”。ClawDOS 会打开它保存在C:\MEMORY里的笔记,找到最新的构建,并回忆起战争场景在 CGA 上玩的调色板把戏。

ClawDOS reads its WARGAMES memory and runs the demo with a screenshot

它看得见屏幕

那次Run调用要求在第 25 秒截一张图。一个定时器中断钩子会在那一刻复制 CGA 的显存,8088 将其编码为 PNG,图片随工具结果一起发给 Claude。这就是 PC 生成的文件,320x200,四色,16 KB:

The PNG screenshot encoded on the 8088

而这是 Claude 对它的解读:

Claude describes the screenshot: the map, the missile arcs, the explosions

工作中的智能体

被要求让演示自行退出时,ClawDOS 开始查找。它在源码中搜索键盘等待,读取文件,说出它的发现,然后改了一行。每次工具调用都会连同结果一起显示在对话记录中,而在两次调用之间,Claude 会说明它接下来要做什么。

Search, Read and Edit tool calls in the transcript

它会玩

十六色的文字艺术,直接写入对话记录,还有用 GW-BASIC 的PLAY语言在 PC 扬声器上播放的音乐。

ClawDOS draws itself in coloured text art

运行框架

为 CGA 打造的聊天界面。回复到达时流式显示在屏幕上,按 80 列在代码页 437 中自动换行。写入与回扫同步,因此不会出现雪花。对话记录通过 CRTC 起始地址在硬件层面滚动,用 PgUp 和 PgDn 回退。旋转指示器及其秒数由定时器中断驱动,在 PC 忙碌时也持续转动。

十八个工具。Claude 通过这些工具在机器上工作:

工具 它们的作用
sysinfo、dir、read、search 查看系统、列出目录、以文本或十六进制读取文件、跨文件查找文本
write、edit、delete、mkdir、rename 创建和修改文件;edit就地替换文件中的某一段
run 运行 DOS 程序和批处理文件并读回它们的输出,一次调用最多十二条命令,可按需截图
peek、poke、port 读写内存和 I/O 端口
play、textart PC 扬声器音乐和彩色 CP437 艺术
memory_list、memory_read、memory_write 它自己的笔记,保存在C:\MEMORY中

磁盘上的开发套件。两个汇编器(TINYASM 和 WASM)、Bruce's C、GW-BASIC 和 lDebug 调试器,外加 Turbo C 2.0,从external/中你自己的软盘镜像安装。它们都在 8088 上验证过,ClawDOS 知道如何驱动每一个。

记忆与技能。记忆是 ClawDOS 在你的 PC 上学到的东西:你们一起构建了什么、什么奏效、你喜欢什么。技能是随它一起提供的指南,例如开发工具和 CGA 演示效果。两者都是磁盘上的纯文本文件,列在每段对话的系统提示中,并在适合任务时读取。F4 浏览记忆:

The F4 memories screen

安全模式。默认开启。任何更改文件、记忆或端口的操作都会先询问Allow ...? (y/n)。F3 将其关闭。

持久的对话。每段聊天都是磁盘上的一个文件,采用 API 自己的消息格式。F6 列出它们,Enter 重新打开一个,你的下一条消息会接着进行。被电源开关中断的聊天也会重新打开。

The F6 chat list

任意模型,对话中途切换。/model列出CLAWDOS.CFG中的提供商,并在它们及其模型之间切换而不丢失对话。F5 设置 Claude 的思考强度,从低到最高。任何支持 Messages API 的主机都可以使用。

慢速链路上也很轻松。 系统提示和工具由 API 缓存。 对话的首次请求之后,PC 只上传新增内容,因此一个工具 结果大约 500 字节就能上传。连接断开或 API 过载 会重试,回合继续进行。

飞行记录仪。 CLAWDOS.LOG 为每一轮都有一行记录:首 token 时间、上传大小和时间、输入输出 token 数、缓存读取。

api anthropic claude-opus-5-5 round=1 ttft=2750 total=4015 up=165 len=1784 stop=tool_use in=2 out=221 cr=5543 cw=739 th=cont
relaunch: program 61.5 s, CLAWDOS away 82.3 s

底层实现

flowchart LR
    subgraph DOS["IBM PC XT (8088, 640K, CGA)"]
        direction TB
        subgraph APP["HARNESS.EXE"]
            direction TB
            UI["Chat screen"]
            LOOP["Agent loop<br/>Messages API requests, SSE and JSON,<br/>history on disk"]
            TOOLS["Tools<br/>files, search, DOS programs, screenshots,<br/>memory and ports, speaker"]
        end
        NET["mTCP + packet driver"]
        APP <--> NET
    end

    TUNNEL["TLS tunnel<br/>copies bytes"]
    API["Claude Messages API"]

    NET <-->|"plain HTTP"| TUNNEL
    TUNNEL <-->|"HTTPS"| API
   
机器 IBM PC XT 5160:8088 处理器 4.77 MHz,640K 内存,CGA 显卡。PicoMEM 卡提供磁盘(microSD 上的镜像)、作为 NE2000 的 WiFi、EMS 和电池时钟
代码 13,000 行 C 和 C++,用 Open Watcom 针对 8086 指令集构建
程序 HARNESS.EXE,176 KB,整个 harness。CLAWDOS.EXE,29 KB,你输入的启动器
系统 FreeDOS 1.4,配合 mTCP 实现 TCP/IP
API Claude Messages API,流式传输:工具使用、图像、提示缓存、消息线程
TLS 另一台机器上的隧道,tunnel/tunnel.py、socat 或 stunnel。它在普通端口和 api.anthropic.com:443 之间复制字节。它还可以持有 API 密钥,因此密钥永远不会接触 PC 的磁盘
内存 ClawDOS 运行的程序在 harness 旁边获得 200K,当 harness 退出时获得 450K
测试 DOSBox-X 中针对模拟 API 的 31 项启动测试、在 DOS 上运行的单元测试,以及在 86Box 的 8088 上运行

docs/API.md 准确说明了 ClawDOS 发送什么以及期望返回什么。

运行它

你需要一台装有 Python 3 的 Mac 或 Windows PC,以及一个 Anthropic API 密钥。在 Windows 上命令是 python。

python3 scripts/setup-tools.py          # fetch the compilers, FreeDOS, mTCP and the emulators
echo ANTHROPIC_API_KEY=sk-ant-... > .env
python3 scripts/build.py                # build/CLAWDOS.IMG, a bootable disk
python3 tunnel/tunnel.py                # the TLS tunnel, on port 8443
python3 scripts/run86box.py             # boot an IBM PC XT

在 C:\> 提示符下,输入 CLAWDOS。

没有密钥?python3 tunnel/mockapi.py 可离线模拟 API:输入 CLAWDOS 10.0.2.2:18023 并发送 !help。

在真实 PC 上: 使用运行隧道的机器的地址 (python3 scripts/build.py --tunnel 192.168.1.10:8443)构建,将 CLAWDOS.IMG 复制到 PicoMEM 的 microSD 卡,在 PicoMEM 菜单中选择它作为硬盘, 启动,然后输入 CLAWDOS。后续构建会就地更新卡上的镜像, 并保留其记忆和聊天 (python3 scripts/build.py --update /path/to/CLAWDOS.IMG)。

键盘操作

按键  
Enter 发送
Esc 停止回复,或清空输入
上 / 下 调出更早的消息
PgUp / PgDn 向上滚动
F1 帮助
F2 新聊天
F3 安全模式开或关
F4 记忆
F5 努力程度:低、中、高、xhigh、最大
F6 更早的聊天
F10 退出

/model、/chats、/memories、/new 和 /quit 可在输入框中工作。 CLAWDOS -m "..." 从命令行发送消息,-c NAME 重新打开 聊天。

更多

   
docs/MANUAL.md 完整设置、真实硬件、镜像更新器、其他提供商、所有设置
docs/API.md ClawDOS 发送给 API 的内容以及期望返回的内容
docs/ROADMAP.md 计划、基准测试和内存映射
路径 内容
src/harness/ HARNESS.EXE:聊天界面、回合、工具
src/clawdos/ CLAWDOS.EXE,启动器
lib/ 各个部分:屏幕、控制台、网络和 HTTP、API 请求写入器和流解析器、JSON、历史记录、工具执行器、截图和 PNG 编码器
tunnel/ TLS 隧道和模拟 Messages API
image/ 磁盘上的内容:清单、系统提示、工具模式、技能、测试
scripts/ 构建、磁盘镜像工具、模拟器运行器和测试 harness
tests/unit/ DOSUNIT.EXE,在 DOS 上运行的单元测试

许可证

ClawDOS 是自由软件,采用 GNU 通用公共许可证第 3 版或(由你选择) 任何更高版本:参见 LICENSE。HARNESS.EXE 链接 mTCP,后者是 GPLv3。src/boot/freedos 中的 FreeDOS 引导扇区按其自身的 GPLv2 或更高版本许可证原样内置 (其 COPYING)。你构建的磁盘镜像包含他人的软件(FreeDOS、mTCP,以及来自你自己软盘的 Turbo C):不要分发带有 Turbo C 的镜像。

ClawDOS 基于 mTCP、FreeDOS、 Open Watcom、 PicoMEM、86Box 和 DOSBox-X。

来源:Hacker News · ricapar.net