（11333期）Ralph Loop (Agent Mode) – AI 编码智能体循环编排引擎

AI 编码智能体循环编排引擎 通过 exec/process 工具编排 AI 编码智能体的循环工作流，支持 TTY 模式运行 OpenCode、Codex、Claude Code 等交互式 CLI。 使用说明 核心用法 Ralph Loop 是一种用于编排 AI 编码智能体的自动化工作流技能，指导 OpenClaw 代理使用 exec 和 process 工具执行循环任务。其核心模式分为两阶段： PLANNING 循环：分析需求、创建 specs/*.md 规格文档，仅更新 IMPLEMENTATION_PLAN.md 而不实施代码 BUILDING 循环：按优先级执行任务、实施代码、运行测试（backpressure）、更新计划并提交 关键创新在于使用 exec 工具的 pty: true 参数为交互式 CLI（如 OpenCode、Codex、Claude Code、Goose）提供 TTY 支持，解决传统后台执行导致的挂起问题。配合 background: true 和 process 工具的 poll/log/kill 动作，实现会话监控、实时日志获取和安全清理。 显著优点 TTY 兼容性：解决交互式编码智能体的终端依赖问题，支持主流 AI CLI 工具 结构化工作流：明确的规划/实施分离，通过 PROMPT.md 和 AGENTS.md 持久化上下文 灵活监控：基于会话 ID 的轮询机制，支持超时控制和并行会话 完成检测：通过 IMPLEMENTATION_PLAN.md 中的状态标记（如 STATUS: COMPLETE）自动识别任务结束 多智能体支持：可编排 Codex、Claude Code、OpenCode、Goose、Pi 等多种编码代理 潜在局限 复杂度门槛：需要理解 exec/process 工具链、PTY 机制及多种 CLI 的特定参数 安全风险：--full-auto、--yolo、--dangerously-skip-permissions 等自动授权标志可能导致未审查代码执行 超时调优：默认 3600 秒超时可能不适合所有任务规模，需人工调整 环境依赖：部分 CLI（如 Codex）要求 git 仓库上下文 无内置沙箱：虽有建议但未强制实施容器隔离，依赖外部沙箱方案 适合人群 需要批量自动化 AI 编码任务的开发团队 熟悉 OpenClaw 工具链和多种 AI CLI 的高级用户 追求规划-实施分离、可审计工作流的工程管理者 希望并行运行多个编码会话的技术负责人 常规风险 代码质量风险：自动授权模式可能引入未经审查的代码变更 资源泄漏：不当的会话管理可能导致僵尸进程或文件句柄泄漏 并发冲突：多会话并行时可能产生 git 冲突或文件竞争 凭证暴露：交互式 CLI 可能意外记录敏感信息到日志文件 无限循环：完成检测失败或提示词设计不当可能导致循环无法终止 建议使用 git worktree 隔离并行任务，在受控沙箱环境中运行，并始终保留人工审查环节。 原始说明 Guide OpenClaw agents to execute Ralph Wiggum loops using exec and process tools. Agent orchestrates coding agents (Codex, Claude Code, OpenCode, Goose) with proper TTY support via pty:true. Plans/builds code via PROMPT.md + AGENTS.md, SPECS and IMPLEMENTATION_PLAN.md. Includes PLANNING vs BUILDING modes, backpressure, sandboxing, and completion conditions. Users request loops, agents execute using tools.