ClawDOS:在 IBM PC XT 上运行的 DOS AI 编程智能体
ClawDOS – An AI coding agent for DOS
ClawDOS 是一个运行在 IBM PC XT(8088 4.77 MHz、640K 内存、CGA 显卡)上的 AI 编程智能体,整个 harness 为 176 KB 的 DOS 程序 HARNESS.EXE,直接调用 Claude Messages API,仅 TLS 由一台桥接 PC 处理。
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 的处理能力。

在 C:\> 提示符下输入 CLAWDOS,就能和 Claude 对话。它会读取并编辑你磁盘上的文件,编写程序,用 Turbo C 编译它们,运行它们,并查看它们在屏幕上绘制的内容。它会在对话之间保存笔记,并从上次中断的地方继续。
整套运行框架都运行在这台 PC 上。HARNESS.EXE 是一个 176 KB 的 DOS 程序,它自己直接与 Claude Messages API 通信:它编写请求、解析流式回复、运行工具,并把每次对话保存在各自的磁盘上。除了 TLS,8088 什么都做。
看看它如何工作
下面的每一屏都来自一台在 86Box 中模拟的、运行频率 4.77 MHz 的 5160。对话是与实时 API 进行的。
从一句话到一个运行中的程序

一条消息:“编写 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。
这是在真正的 5160 上运行,从它的 IBM 显示器上拍摄的:
它记得
开一段新对话,只需说“你的 WarGames 演示”。ClawDOS 会打开它保存在C:\MEMORY里的笔记,找到最新的构建,并回忆起战争场景在 CGA 上玩的调色板把戏。

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

而这是 Claude 对它的解读:

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

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

运行框架
为 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 浏览记忆:

安全模式。默认开启。任何更改文件、记忆或端口的操作都会先询问Allow ...? (y/n)。F3 将其关闭。
持久的对话。每段聊天都是磁盘上的一个文件,采用 API 自己的消息格式。F6 列出它们,Enter 重新打开一个,你的下一条消息会接着进行。被电源开关中断的聊天也会重新打开。

任意模型,对话中途切换。/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
