概述
agentic-loop-upgrade 是 OpenClaw 平台的旗舰级智能代理增强框架，将基础对话代理升级为具备完整自主规划能力的任务执行系统。该技能通过持久化状态机、自动规划引擎、人机协作门控机制三大核心架构，解决了传统代理在长任务中"遗忘上下文"、"盲目执行"、"失败即崩溃"的痛点。
核心用法
用户通过 Mode 面板一键切换至 Enhanced Loop 模式后，系统会自动：
- 意图检测：识别复杂任务请求（如"帮我搭建一个带认证的 REST API"）
- 计划生成：拆分为可执行的步骤序列（如 1.设计数据模型 → 2.实现认证中间件 → 3.编写路由...）
- 状态持久化：计划存储于
~/.openclaw/agent-state/，支持跨会话恢复 - 执行监控：工具调用完成后自动分析结果并标记步骤完成
- 进度渲染：Webchat 显示为带进度条的 HTML 卡片，Discord 自动转换为 emoji 清单
关键 API 入口为 createOrchestrator()，统一封装了规划、审批、重试、上下文压缩、检查点等全部能力。
显著优点
1. 任务连续性：检查点机制允许长达数小时的任务中断后精准恢复，适用于 CI/CD 流水线、复杂数据迁移等场景
2. 成本可控：支持为规划/反思调用单独指定轻量级模型（如 Claude 3 Haiku），与主对话模型解耦
3. 安全协作：四级风险分级（low/medium/high/critical）配合 15 秒超时审批门，既防误操作又不阻塞工作流
4. 错误韧性：语义错误诊断自动识别权限不足、网络超时、文件不存在等故障类型，并尝试修复（如自动加 sudo、延长超时）
5. 零配置记忆：可选接入 SurrealDB 知识图谱，自动注入相关事实与历史 episode，无需手动管理 RAG
潜在缺点与局限性
- 宿主依赖：实时计划卡片更新需要特定版本的 OpenClaw UI（commit 01a3549de 之后），旧版本降级为回合级刷新
- OAuth 令牌限制：虽然支持 Claude Max OAuth，但部分第三方模型可能缺乏同等认证机制
- 存储本地化：检查点与状态仅限本地文件系统，无内置多机同步或云备份
- 复杂计划开销：超过 7 步骤的深层规划可能消耗显著 token，建议结合
thresholdTokens触发上下文压缩 - SurrealDB 可选性：知识图谱功能需外部数据库，未配置时静默降级为无记忆模式
适合人群
- 自动化工程师：需要可靠、可审计的长周期任务代理
- 全栈开发者：通过 Discord/Webchat 统一管理项目初始化、部署、运维流程
- AI 产品经理：需要可视化进度追踪与人工审批节点的合规场景
- 多项目管理者：利用检查点在多个并行任务间切换上下文
常规风险
| 风险类别 | 说明 | 缓解措施 |
|---------|------|---------|
| 权限提升 | 自动重试可能尝试 `sudo` 等特权操作 | 审批门强制拦截 high/critical 风险，默认可用 |
| 数据残留 | 本地 `~/.openclaw/` 可能包含敏感任务状态 | 提供 `scripts/verify.sh` 审计脚本，支持手动清理 |
| 计划漂移 | LLM 生成的计划可能与用户真实意图偏差 | 每次计划创建触发 UI 通知，用户可即时否决 |
| 无限重试 | 配置错误可能导致死循环 | 默认最大 3 次重试，指数退避延迟 |
| 提示注入 | 恶意用户可能通过任务描述操控计划 | 上下文注入为"附加式"，永不替换核心安全策略 |
安全等级 S 评定基于：完全本地化持久化、零遥测、透明 runner 包装、OAuth 优先的凭证继承机制。