Newshot

ClawDOS——面向 DOS 的 AI 编程智能体

Translation(model translation, not the source's own text)

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 的启动画面
ClawDOS 的启动画面

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 进行。

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

ClawDOS 编写、编译并运行 PRIMES.C
ClawDOS 编写、编译并运行 PRIMES.C

一条消息:“写一个 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 通过这些工具在机器上工作:

ToolsWhat they do
sysinfo , dir , read , search查看系统、列出目录、以文本或十六进制读取文件、跨文件查找文本
write , edit , delete , mkdir , rename创建和修改文件;edit 就地替换文件中的某一段内容
run运行 DOS 程序和批处理文件,并读回它们打印的内容,一次调用最多十二条命令,可按需截图
peek , poke , port读写内存和 I/O 端口
play , textartPC 扬声器音乐和彩色 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 浏览记忆:

F4 记忆界面
F4 记忆界面

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

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

F6 聊天列表
F6 聊天列表

对话中途可换任何模型。/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
APIClaude 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.mdClawDOS 发送给 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 之上。

The translation is machine-generated and individual terms may be off. Nothing is rewritten or cut; the original is authoritative.

Published by Hacker News
This site only summarises and aggregates; copyright stays with the original author. Headlines and summaries follow the source — where they differ, the original wins.
Read the original ↗