什么是Ralph Loop (Agent Mode)
Ralph Loop（Agent Mode）是一个专为 OpenClaw 代理设计的自动化工作流框架，用于引导 AI 编码代理高效执行软件开发任务。该技能通过标准化的 Ralph 循环流程，将复杂项目拆解为清晰的规划（PLANNING）与构建（BUILDING）两个阶段，帮助代理系统性地推进开发目标。在每次迭代中，代理会依据 `specs/*.md` 文件中的需求规格、`IMPLEMENTATION_PLAN.md` 中的任务清单以及 `AGENTS.md` 中的操作指南，调用外部编码工具（如 OpenCode、Codex、Claude Code 等）完成具体工作。整个流程通过磁盘持久化机制保持上下文连续性，确保多轮对话之间信息不丢失。特别之处在于，它利用 OpenClaw 的 `exec` 工具配合 `pty: true` 参数，为交互式命令行工具提供完整的终端支持，解决了传统后台进程无法处理 TTY 依赖的问题，从而显著提升了主流 AI 编程工具的兼容性与稳定性。
核心功能特点
- 基于 Ralph 循环模型，分 PLANNING 和 BUILDING 两阶段推进项目
- 自动检测 CLI 类型，智能选择 exec+pty 模式或简单循环执行
- 通过 PROMPT.md + AGENTS.md 实现上下文持续传递与知识沉淀
- 支持主流 AI 编码工具（OpenCode/Codex/Claude Code/Pi/Goose）的集成调用
- 内置背压控制、超时管理、会话监控与完成状态识别机制
- 提供沙箱隔离、并行任务管理与 git 工作树等工程化保障手段
适用场景
Ralph Loop 特别适用于需要长期迭代、多步骤协作的大型软件项目开发场景。例如，当团队希望使用 Claude Code 或 Codex 等高级 AI 助手从零开始搭建一个完整 Web 应用时，可以先通过 PLANNING 模式生成详细的 `specs/` 目录结构，明确功能模块与技术选型；随后进入 BUILDING 模式，由代理逐项实现核心功能并运行自动化测试，同时根据实际进展动态更新实施计划。对于需要频繁调整需求或存在不确定性的探索性项目，该工具也能发挥价值——代理可在早期快速产出最小可行原型，再结合用户反馈逐步完善。此外，在企业级环境中部署多个 AI 代理协同工作时，Ralph Loop 提供的标准化接口和工作目录隔离机制，可有效避免资源冲突与权限混乱问题，提升整体研发效率与可维护性。无论是个人开发者还是团队协作，只要涉及结构化编码任务分解与 AI 工具链整合，都能从中获益。