Agentic Loop Upgrade

🔄 智能体任务规划与可恢复执行引擎

OpenClaw智能体增强框架,提供持久化计划状态、审批门控、自动重试、语义错误恢复和可观测状态机,支持跨会话任务恢复与实时进度追踪

收藏
7.1k
安装
1.8k
版本
2.3.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能

Enhanced Agentic Loop 是 OpenClaw 平台的智能体执行层增强套件,通过可观测状态机重构任务执行流程。核心采用"规划-执行-监控"闭环架构:

1. 智能规划层:自动识别复杂任务意图("build API"、"from scratch"等触发词),生成最多7步结构化计划,支持跨会话持久化存储于 ~/.openclaw/agent-state/

2. 并行执行引擎:多步骤并行调度,配合置信度门控(confidence gates)动态评估执行质量

3. 审批安全门控:四级风险分级(low/medium/high/critical),高危操作(rm -rf、数据库删除等)强制15秒人工确认,超时自动降级处理

4. 语义错误恢复:自动诊断失败原因(权限/网络/资源不存在),应用修复策略(sudo提权、超时延长)并指数退避重试

5. 上下文智能压缩:80k token阈值触发摘要,保留最近10条消息,节省约30%上下文窗口

6. 检查点/恢复机制:手动/自动双模式,支持跨会话任务续作,自动注入恢复上下文

7. 记忆图谱注入(v2):SurrealDB知识图谱的事实与情景记忆自动嵌入系统提示,置信度低于0.9时触发情景回忆

8. 渠道感知渲染:::plan 块自适应转换——Web端为HTML进度卡片,Discord转为emoji清单(✅🔄⬜)

架构优势

  • 透明包装:原始 runner 无条件调用,拦截行为全日志记录
  • 仅附加提示注入:不替换核心系统提示,仅追加计划状态文本
  • OAuth优先认证:继承主代理的token/oauth凭据层级,避免API key泄露
  • 零外部网络:除配置LLM提供商外无出站连接,无遥测上报

显著局限

1. 实时更新依赖UI版本:计划卡片实时勾选需 OpenClaw upgrade-test-20260217 分支(commit 01a3549de)及以上,旧版本仅回合级更新
2. SurrealDB依赖:记忆注入功能需主机代理已配置 SurrealDB,否则静默禁用

3. 状态机复杂度:11个组件(State Machine/Checkpoint/Approval Gate等)带来学习曲线,调试需理解FSM转换规则

4. Token开销:计划生成、反思调用、上下文摘要均消耗额外LLM token,建议Mode面板选用小模型控制成本

适用人群

  • 需要长时间运行复杂多步骤任务的研究人员/开发者
  • 对AI操作有合规审计要求的企业团队(审批门控+完整操作日志)
  • Discord/Web多端部署场景(渠道自适应渲染)
  • 需要任务可恢复性的自动化工作流(检查点机制)

风险提示

  • v2.3.0前版本缺陷:上游合并曾导致编排器管线丢失,仅记忆注入工作,建议立即升级验证
  • 审批超时风险:15秒默认超时可能不足复杂决策场景,需按组织SLA调整
  • OAuth令牌刷新:长期任务中需确保 sk-ant-oat* 令牌有效期覆盖执行周期
  • 本地存储边界~/.openclaw/ 目录权限需严格限制,多用户系统存在状态隔离风险

Agentic Loop Upgrade 内容

references文件夹
scripts文件夹
src文件夹
context文件夹
dist文件夹
context文件夹
execution文件夹
llm文件夹
planning文件夹
state文件夹
state-machine文件夹
tasks文件夹
execution文件夹
llm文件夹
planning文件夹
state文件夹
state-machine文件夹
tasks文件夹
ui文件夹
controllers文件夹
views文件夹
手动下载zip · 248.3 kB
confidence-gates.mdtext/markdown
请选择文件