ReAct 循环（LLM 输出 → 有工具调用就执行 → 结果回灌 → 再调 LLM → 直到没有工具调用）在 Pi 库内部，由 session.prompt() 驱动。OpenClaw 不重写它，只"喂输入、看输出"。

1. 入站消息经渠道层 → auto-reply → agent-runner-execution.ts 组装运行参数。
2. runWithModelFallback（外层，Day 07）→ runEmbeddedPiAgent（run.ts:256，内层 + 会话排队）。
3. runEmbeddedAttempt（attempt.ts:1369）——单次尝试：修复会话 → 建系统提示 → createAgentSession + 挂 streamFn → session.prompt() 触发循环。
4. subscribeEmbeddedPiSession（attempt.ts:2187）订阅事件流，转成 onPartialReply/onToolResult 等回调。
5. usage 累加回 run.ts（UsageAccumulator）。

runEmbeddedPiAgent 用 enqueueSession/enqueueGlobal（run.ts:275-276）把运行串行化。

runEmbeddedAttempt（attempt.ts:1369）在真正调模型前做一堆"准备+修复"：

• SessionManager.open（attempt.ts:1731）打开会话，修复畸形的 tool_use/tool_result 配对（sanitizeToolUseResultPairing）。
• buildEmbeddedSystemPrompt（attempt.ts:1642）建系统提示（Day 09）。
• createAgentSession + 挂 streamFn（Day 06）。
• 修复尾部孤立 user 消息以免连续 user turn（attempt.ts:2364-2378）。
• 加载 prompt 里引用的图片（detectAndLoadPromptImages，attempt.ts:2390）。

// attempt.ts:2460 —— 这一行进入 Pi 的 ReAct 循环
await abortable(activeSession.prompt(effectivePrompt, { images }));
// 无图则 attempt.ts:2462: await abortable(activeSession.prompt(effectivePrompt));

循环跑的同时，subscribeEmbeddedPiSession（pi-embedded-subscribe.ts:34）订阅 Pi 会话事件流，把内部事件转成 OpenClaw 的回调：

// assistant 文本增量 → onPartialReply（流式打字）
// 完整消息块 → onBlockReply
// 工具调用/结果 → onToolResult
// 推理过程 → onReasoningStream
// 事件处理器分文件：pi-embedded-subscribe.handlers.{messages,tools,lifecycle,compaction}.ts

对话越来越长，迟早超出模型上下文窗口。run.ts 在尝试失败后检测溢出并自动压缩重试：

// MAX_OVERFLOW_COMPACTION_ATTEMPTS = 3（run.ts:740）
// 检测到 isLikelyContextOverflowError（Day 07 的错误分类）→ 触发 auto-compaction 重试
//   （run.ts:1003-1188），压缩逻辑在 pi-embedded-runner/compact.ts
// 另有：thinking 级别回退（pickFallbackThinkingLevel）、超大工具结果截断
//       （truncateOversizedToolResultsInSession, run.ts:69）

✋ 动手

cd /Users/bitmart/work/codes/github/openclaw
grep -n 'activeSession.prompt' src/agents/pi-embedded-runner/run/attempt.ts
grep -n 'enqueueSession\|enqueueGlobal' src/agents/pi-embedded-runner/run.ts
grep -n 'MAX_OVERFLOW_COMPACTION_ATTEMPTS' src/agents/pi-embedded-runner/run.ts
ls src/agents/pi-embedded-subscribe.handlers.*.ts