智能体循环

智能体循环是 OpenClaw 处理消息的核心流程。

循环流程

用户消息
    ↓
加载会话上下文
    ↓
构建系统提示词
    ↓
调用 AI 模型
    ↓
解析响应
    ↓
┌─── 有工具调用？
│        ↓ 是
│    执行工具
│        ↓
│    添加工具结果
│        ↓
└────→ 继续调用模型
         ↓ 否
    发送最终响应
         ↓
    保存会话

工具调用循环

当模型请求工具调用时：

1. 解析工具调用请求
2. 验证工具权限
3. 执行工具
4. 将结果添加到上下文
5. 继续模型调用

这个循环可能多次迭代，直到模型生成最终响应。

超时和限制

• agents.defaults.timeoutSeconds - 整体超时
• agents.defaults.maxToolIterations - 最大工具迭代次数
• agents.defaults.maxTokens - 最大输出 token

流式输出

智能体循环支持流式输出：

• 文本逐步发送到通道
• 工具调用状态实时更新
• 进度指示器显示

错误处理

• 模型错误 - 尝试故障转移模型
• 工具错误 - 返回错误信息给模型
• 超时 - 发送部分响应或超时消息

相关文档

• 智能体
• 上下文
• 流式传输
• 重试