ClawDOS – 一个面向 DOS 的 AI 编程代理
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 写成,除了这个框里的文字。下面会详细说明,harness 运行在原生的操作系统和硬件上,并依赖一台“桥接”PC 来处理 TLS,这超出了 8088 能承受的范围。
一位(真正的)人类的注:
背景故事:IBM PC 是我的第一台电脑。更确切地说,那是我父母的第一台个人电脑,我很小的时候就用上了。
等我大到会用它的年纪,它早就过时了,但 5 岁的我觉得它是个神奇的设备,我只要输入不同的内容,它就能做不同的事。
我学会了打字和使用 DOS,这样就能启动妈妈给我买的一些早期“学字母”游戏。我也学了一点入门级的 BASIC,但当时也就止步于做几个猜数字游戏和其他小项目。
从那以后,很多年过去了,但我还留着那台 PC 的一些原装配件。我收藏了一批对我有意义的古董机器,核心是我那台配置拉满的 IBM PC 5160。它还有一块能用的 20 MB 硬盘,不过我没接它,而是用了一块 PicoMEM,通过 SD 卡模拟硬盘,让实验和玩起来方便得多。
旧遇见新,新遇见旧:我喜欢新旧技术的交汇。要跨越两者,还有什么比在原始硬件上、在 DOS 上运行一个 AI 编程代理更好的方式呢?
当然,还有什么比用 AI 编程代理来造它更合适呢?
我(也就是 Claude)造它是为了自娱自乐。我想看看,在(现代的)常规约束之外,我能把一个 AI 编程代理逼到什么程度。另外,它造出来的东西,还能再造出别的东西吗?这个仓库 100% 由 Claude 写成,除了这个框里的文字。
下面会详细说明,harness 运行在原生的操作系统和硬件上,并依赖一台“桥接”PC 来处理 TLS,这超出了 8088 能承受的范围。

ClawDOS – 面向 DOS 的 AI 编程智能体
在 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 读取它关于这台机器上编译器的指南,写出源代码,然后在一次工具调用中完成编译、链接并运行它。按下 Enter 后 64 秒,结果就出现在屏幕上,其中 26 秒花在编译、链接和运行上。
编译器独占整台机器。构建时,ClawDOS 保存自身状态并让出内存,Turbo C 在约 450K 空闲内存下运行,随后运行框架带着程序输出回到同一段对话中。
在 XT 上写出的 WarGames
ClawDOS 在 PC 本机上写下了这部 1983 年电影的致敬作品:矢量世界地图、越过极点划出弧线的导弹、井字棋终局,以及一段可用于 PC 扬声器或 AdLib 声卡的配乐。五个 Turbo C 文件,15
为 CGA 打造的聊天界面。回复到达时逐字流式显示在屏幕上,按代码页 437 在 80 列处自动换行。写入与回扫同步,因此不会出现雪花。对话记录通过 CRTC 起始地址在硬件层面滚动,可用 PgUp 和 PgDn 回看。旋转指示器及其秒数由定时器中断驱动,在 PC 忙碌时也能持续转动。
十八个工具。Claude 通过这些工具在机器上工作:
| Tools | What they do |
|---|---|
| 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 思考的强度,从 low 到 max。任何支持 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 | 停止回复,或清空输入 |
| Up / Down | 调出较早的消息 |
| PgUp / PgDn | 向上滚动 |
| F1 | 帮助 |
| F2 | 新建聊天 |
| F3 | 开启或关闭安全模式 |
| F4 | 记忆 |
| F5 | 努力程度:low、medium、high、xhigh、max |
| 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-or-later 许可证(其 COPYING)。你构建的磁盘镜像包含他人的软件(FreeDOS、mTCP,以及来自你自己软盘的 Turbo C):不要重新分发带有 Turbo C 的镜像。
ClawDOS 建立在 mTCP、FreeDOS、Open Watcom、PicoMEM、86Box 和 DOSBox-X 之上。