核心功能
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/目录权限需严格限制,多用户系统存在状态隔离风险