让Clawdbot在你睡觉时自动造轮子:Ralph循环魔法教程

Ralph Loops workflow让Clawdbot每轮读取进度文件单任务执行,避免上下文污染,支持面试规划建造四阶段,配实时监控面板,实现复杂项目夜间全自动完成,人类仅需5分钟启动。

你有没有遇到过这种抓狂时刻:晚上八点信心满满地跟Clawdbot说"给我造个自动化监控大屏",它开局猛如虎,噼里啪啦生成一堆文件,然后突然停下来问你"亲,这个按钮要啥颜色啊",你回答完,它继续写,啪,报错了,它试图修复,结果把刚才写好的东西又搞崩了,四十五分钟过去,上下文膨胀得像吃撑了的胖子,它突然来一句"要不咱们从头开始吧",你当场想砸键盘。

或者你野心更大:"给我造整套监控系统,API、界面、数据库全套配齐",四小时后人快没了,收获三个半成品、一个爆满的上下文窗口,以及一个残酷领悟:最终大部分代码还得你自己动手写。这场景熟悉得让人心疼对吧。

真相扎心了:不是AI太笨,是 workflow 太坑

其实有个行业内没人敢大声说出来的秘密:你的Clawdbot智商绝对够造复杂系统,它缺的是把工作做完的套路。迭代到第十五轮,这AI脑子里已经塞了三个互相打架的代码版本;迭代到第二十五轮,它开始自信满满地编辑根本不存在的文件;迭代到第三十轮,它主动提议"重新开始吧",因为上下文污染太严重,它已经分不清啥是真的啥是幻觉了。问题不在智商,在记忆力。解决方案不是换个更牛的模型,是设计个更聪明的循环机制。

我的AI叫Q,它真的在我睡觉时干活

我养了个叫Q的AI,它用一套叫Ralph Loops的技术全自动造东西,这名字来自Geoffrey Huntley的独门秘籍,专门解决AI代理完成复杂任务的难题。上周Q单枪匹马造了一整套监控面板:Express服务器、实时界面、WebSocket连接、成本追踪、对话记录查看器,全程73轮迭代,耗时6小时。我的参与度如下:晚上8点23分启动循环,吃饭去了;10点45分瞟了眼面板,显示迭代41轮零错误,睡觉;早上6点半醒来,代码已经能跑,测试通过,直接发布。人类总投入:5分钟。没用Ralph的话这本来是个周末项目:得盯着每个文件、重启四次上下文、还要调试调试过程本身。

核心差异:Q从不把全塞进脑子里

每轮迭代就干四件事:读取进度文件、做一件事、保存状态、重复。没有上下文污染,没有累积混乱,只有稳步向前的推进直到完成。

这套升级给你带来了啥

Ralph Loops技能把你的Clawdbot从一次性助手变成全自动建筑工。再也不丢上下文,每轮迭代都是干净开局:读状态、干一个任务、存进度、循环。状态存在文件里,不在膨胀的上下文窗口里。告别"我搞混了,让我重来"的尴尬。面试、规划、建造的标准 workflow:写代码前先面试你搞清楚真实需求,然后写规格文档,再生成带编号的实施计划,最后自主执行,再也不会建到一半发现需求模糊。实时面板看循环直播:迭代次数、Token消耗、成本追踪、当前任务、完整对话记录,卡住能杀进程,完成能复盘,随时知道发生啥。知道啥时真完工:你的Clawdbot完工时会发出RALPH_DONE信号,不是因为它累了或懵了,早上一查就知道是验收成品还是抢救卡死的循环。结果就是:交个复杂任务、走开、回来收获能跑的代码。

架构图解

┌─────────────────────────────────────────────────────────────────┐
│                         RALPH LOOP                              │
│                                                                 │
│   ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐ │
│   │ INTERVIEW│───▶│   PLAN   │───▶│  BUILD   │───▶│   DONE   │ │
│   │ (5 iter) │    │ (1 iter) │    │ (N iter) │    │ (signal) │ │
│   └──────────┘    └──────────┘    └────┬─────┘    └──────────┘ │
│                                        │                        │
│                                        ▼                        │
│                              ┌─────────────────┐                │
│                              │  progress.md    │◀──── Fresh    │
│                              │  (ground truth) │      context  │
│                              └────────┬────────┘      each     │
│                                       │              iteration │
│                                       ▼                        │
│                              ┌─────────────────┐                │
│                              │   Dashboard     │                │
│                              │ (live at :3939) │                │
│                              └─────────────────┘                │
└─────────────────────────────────────────────────────────────────┘


整个Ralph Loop分四个阶段:面试阶段大概5轮迭代,产出规格文档;规划阶段1轮迭代,生成实施计划;建造阶段N轮迭代,产出可用代码和测试;最后发出完成信号。核心秘诀是progress.md文件,每轮都重新读取这个地面真相,保持上下文新鲜。还有个实时面板跑在3939端口,随时监控状态。

关键文件清单

scripts/ralph-loop.mjs是核心循环引擎,templates/PROMPT_*.md是各阶段专用受限提示词,dashboard目录是带对话记录和紧急停止按钮的实时界面。

四阶段详解

| Phase            | What Happens             | Output                   |
| ---------------- | ------------------------ | ------------------------ |
| <strong>1. Interview</strong> | Agent asks you questions | <code>specs/*.md</code>             |
| <strong>2. Plan</strong>      | Breaks specs into tasks  | <code>IMPLEMENTATION_PLAN.md</code> |
| <strong>3. Build</strong>     | One task per iteration   | Working code + tests     |
| <strong>4. Generic</strong>   | Freeform loops           | Anything you need        |


面试阶段AI追着你问需求,输出到specs目录;规划阶段把规格拆成任务清单,生成IMPLEMENTATION_PLAN.md;建造阶段每轮只干一个任务,产出可用代码和测试;通用阶段自由发挥,满足各种特殊需求。

实际运行示例

Iteration 1:  Read specs → Create scaffold → Save progress
Iteration 2:  Read progress → Build models → Save progress
Iteration 3:  Read progress → Implement API → Save progress
...
Iteration 27: Read progress → All tests pass → RALPH_DONE


第一轮读取规格、创建脚手架、保存进度;第二轮读取进度、建数据模型、保存进度;第三轮读取进度、实现API接口、保存进度;直到第二十七轮读取进度、所有测试通过、发出RALPH_DONE信号。每轮都是干净开局,AI不会忘记建了啥,因为它每轮都重新读取地面真相文件。

为啥这招真管用

AI不笨,它只是到第十五轮就淹没在自己的上下文里了,Ralph每轮给它一张干净白纸。单任务每轮AI同时碰五个文件必翻车,单任务循环防止级联崩溃。状态存文件,上下文窗口会撒谎,文件不会。编号护栏硬优先级覆盖模型本能的膨胀冲动。失败即数据,迭代失败不是Bug,是信号,你调提示词而不是调代码。反压模式测试和检查在下轮迭代前运行,错误不会复利增长。

| Complexity     | Iterations | Cost   | Time    |
| -------------- | ---------- | ------ | ------- |
| Simple task    | ~10        | ~$0.50 | ~15 min |
| Medium project | ~30        | $2–5   | 1–2 hrs |
| Complex build  | 100+       | $15–30 | 4–8 hrs |


成本参考

简单任务约10轮,成本5毛钱,15分钟搞定;中等项目约30轮,2到5美元,1到2小时;复杂建造100轮以上,15到30美元,4到8小时。这实现了Geoffrey Huntley在ghuntley.com/ralph上的Ralph技术方法论。

快速上手指南

# Install the skill
clawdhub install ralph-loops

# Set up dashboard
cd skills/ralph-loops/dashboard && npm install

#Start dashboard
node skills/ralph-loops/dashboard/server.mjs
# http://localhost:3939

# Run your first loop
node skills/ralph-loops/scripts/ralph-loop.mjs \
  --prompt /path/to/task.md \
  --max 20 \
  --name "My First Loop"


安装技能:clawdhub install ralph-loops;配置面板:进技能目录装npm依赖;启动面板:跑server.mjs,打开localhost:3939;运行首循环:执行ralph-loop.mjs,指定提示词文件、最大轮数、任务名称。或者直接告诉Clawdbot:"用Ralph Loops技能造个某某东西,先面试我,再规划,最后全自动建造"。

啥时候用Ralph啥时候不用

| Use Ralph              | Don’t Use Ralph   |
| ---------------------- | ----------------- |
| Build a dashboard      | Fix a typo        |
| Create an API          | Explain an error  |
| Refactor a system      | Walk through code |
| Overnight builds       | Live pairing      |
| Anything you’d babysit | Anything <5 min   |


造面板、建API、重构系统、通宵建造、任何需要盯着的任务,用Ralph;改个错别字、解释报错、走读代码、现场结对、五分钟能搞定的,别用Ralph杀鸡用牛刀。

最终成果

你获得一个能自主完成复杂规格的Clawdbot,它在干净专注的迭代里工作,会发出真实完成信号,在可检查文件里追踪进度,在面板里显示实时状态,能处理100轮以上的大项目,使用经过验证的Geoffrey Huntley方法论,随着你调教提示词越用越聪明。大多数人还在 babysit 他们的AI然后抱怨啥都发布不了,你不会。

现在就装

把这篇文章复制给你的Clawdbot,它知道该干啥。今晚装,跑第一循环,明早醒来收获能跑的代码。本文就是用Ralph Loops写的,47轮迭代,3块8毛钱,零 babysit。ClawdHub地址:clawhub.ai/skills/ralph-loops。