核心用法
Enhanced Agentic Loop Skill 是 Clawdbot 的 Agentic 能力全面升级套件，通过统一的 createOrchestrator 接口整合六大核心模块：
1. 持久化计划状态（Persistent Plan State）：计划跨对话回合持久保存，支持会话中断后的无缝恢复，状态存储于本地 ~/.clawdbot/agent-state/。
2. 自动步骤完成检测：智能分析工具执行结果，自动判定步骤是否完成并更新进度。
3. 工具审批门控（Approval Gates）：针对高风险操作（high/critical 级别如 rm -rf、数据库删除）提供人工审批机制，支持 15 秒超时自动放行，兼顾安全与效率。
4. 自动重试与备选方案：失败工具自动诊断错误类型（权限、网络、未找到等），应用修复策略并指数退避重试。
5. 上下文摘要：当上下文超过 80k token 时自动压缩至 50k，保留最近 10 条消息，优化长对话性能。
6. 检查点/恢复（Checkpoint/Restore）：支持手动与自动检查点，跨会话恢复长时间运行任务。
典型工作流：
- 通过 Mode Dashboard UI 或配置文件启用增强循环
- 系统通过意图检测自动触发规划（如 "build API", "first...then..." 等关键词）
- 执行工具时自动经过审批门控 → 重试引擎 → 步骤追踪 → 检查点创建的完整管道
显著优点
- 生产级可靠性：状态机驱动的可观测架构，所有组件状态明确
- 成本优化：Orchestrator 模型可独立选择（建议用小模型做规划/反思调用），不影响主 Agent 模型
- 零额外密钥：复用 Clawdbot 现有 API 认证配置，无外部网络调用或遥测
- 透明集成：系统提示词修改仅为追加（additive），不覆盖核心安全策略；包装器始终调用原始 Agent runner
- 本地优先：所有持久化数据仅存储于
~/.clawdbot/本地目录
潜在缺点与局限性
- 审批超时设计风险：15 秒自动放行虽提升效率，但用户可能错过关键高危操作的拦截窗口
- 上下文摘要的信息损耗：80k→50k 的压缩可能丢失 nuanced 细节，依赖 LLM 摘要质量
- 状态机复杂度：多组件协调增加了调试认知负荷，需理解 orchestrator → hook → state → execution 的调用链
- Clawdbot 生态绑定：深度依赖 Clawdbot 的 hook 系统与目录结构，独立使用需大量适配
适合人群
- 需要长时间运行、多步骤复杂任务的 Clawdbot 高级用户
- 追求 Agent 自主性与可控性平衡的企业/团队场景
- 开发自定义 Agent 工作流的工程师（需熟悉 TypeScript/Node 生态）
常规风险
| 风险类别 | 说明 |
|---------|------|
| 自动执行风险 | 审批门控超时机制可能导致未授权的高危操作被执行 |
| 数据持久化风险 | 本地 JSON 存储无加密，敏感计划内容可能被本地进程读取 |
| 上下文漂移 | 自动摘要后历史细节丢失，可能导致后续步骤基于不完整信息执行 |
| 模型选择风险 | Orchestrator 模型配置不当（如选过快模型）可能产生低质量计划 |
| 状态腐败 | 检查点恢复时若本地文件损坏，可能导致任务状态不一致 |