agentic-loop-upgrade
Enhanced agentic loop with planning, parallel execution, confidence gates, semantic error recovery, and observable state machine. Includes Mode dashboard UI for easy configuration.
Install / Use
npx skills add LeoYeAI/openclaw-master-skills --skill agent-mode-upgradesInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
SecuritySupported Platforms
Our assessment of agentic-loop-upgrade
agentic-loop-upgrade scores 90/100 on our quality scale, 489th of 1,111 Security skills we index (top 45%).
Its SKILL.md is 18 KB long, well organised into 27 sections with 13 code examples: a thorough specification that gives an agent plenty to work with.
With 2,149 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-10-30 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 98/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
ReviewOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review judged it risky: Approval gates for high/critical risk operations are configured to auto-proceed after a timeout, effectively auto-approving risky actions.
AI review: risky
- Approval gates for high/critical risk operations are configured to auto-proceed after a timeout, effectively auto-approving risky actions.
- The retry engine automatically applies fixes such as 'add sudo' and retries failed executions, which can escalate privileges without explicit user approval.
- External knowledge-graph facts/episodes are auto-injected into the system prompt and old messages may be replaced by summaries, weakening prompt integrity and potentially dropping safety context.
AI review by kimi-k2.7-code on 2026-09-30. Automated pattern scan on 2026-09-30. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
agentic-loop-upgrade compared with similar skills
All 4 of these similar skills score higher than agentic-loop-upgrade; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| agentic-loop-upgrade (this skill)by LeoYeAI | 90 | 2.1k | 4mo ago | SKILL.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 149.0k | 6d ago | SKILL.md |
Frequently asked questions
- How do I install agentic-loop-upgrade?
- Run
npx skills add LeoYeAI/openclaw-master-skills --skill agentic-loop-upgrade. The install tabs above show the steps for each supported agent. - Which AI agents does agentic-loop-upgrade work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is agentic-loop-upgrade safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review judged it risky: Approval gates for high/critical risk operations are configured to auto-proceed after a timeout, effectively auto-approving risky actions. It is MIT-licensed and scores 98/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is agentic-loop-upgrade still maintained?
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubname: agentic-loop-upgrade description: "Enhanced agentic loop with planning, parallel execution, confidence gates, semantic error recovery, and observable state machine. Includes Mode dashboard UI for easy configuration."
Enhanced Agentic Loop Skill
A comprehensive upgrade to OpenClaw's agentic capabilities with persistent state, automatic planning, approval gates, retry logic, context management, checkpointing, knowledge graph auto-injection, and channel-aware plan rendering.
📋 Security review? See SECURITY.md for a complete trust and capability audit document including network activity, file write scope, credential handling, and rollback instructions.
Security & Trust Summary
| Property | Value |
|---|---|
| Outbound network | LLM provider only (inherited from host) |
| Telemetry / phone-home | ❌ None |
| System prompt modification | ✅ Additive-only (appends plan status; never replaces core prompt) |
| Runner wrapping | ✅ Transparent (original runner always called; interceptions logged) |
| Credential storage | ❌ None (inherits host agent auth, stores nothing new) |
| Persistence | Local ~/.openclaw/ only |
| Enabled by default | ❌ No — explicit opt-in required |
| Approval gates default | ✅ On for high/critical risk operations |
Status: ✅ Active (v2.3.0)
All components are integrated and working.
| Component | Status | |-----------|--------| | Mode Dashboard UI | ✅ Working | | Configuration System | ✅ Working | | Hook/Wrapper Integration | ✅ Working | | State Machine | ✅ Working | | Planning Layer | ✅ Working | | Parallel Execution | ✅ Working | | Confidence Gates | ✅ Working | | Error Recovery | ✅ Working | | Checkpointing | ✅ Working | | Memory Auto-Inject | ✅ Working (v2) | | Discord Plan Rendering | ✅ Working (v2) |
Features
1. Persistent Plan State
Plans survive across conversation turns. The agent knows where it left off.
import { getStateManager } from "@openclaw/enhanced-loop";
const state = getStateManager();
await state.init(sessionId);
// Plan persists in ~/.openclaw/agent-state/{sessionId}.json
state.setPlan(plan);
state.completeStep("step_1", "Files created");
const progress = state.getProgress(); // { completed: 1, total: 5, percent: 20 }
2. Automatic Step Completion Detection
Analyzes tool results to determine if plan steps are complete.
import { createStepTracker } from "@openclaw/enhanced-loop";
const tracker = createStepTracker(stateManager);
// After each tool execution
const analysis = await tracker.analyzeToolResult(tool, result);
if (analysis.isComplete) {
console.log(`Step done: ${analysis.suggestedResult}`);
}
3. Tool Approval Gates with Timeout
Risky operations pause for human approval, but auto-proceed after N seconds.
import { getApprovalGate } from "@openclaw/enhanced-loop";
const gate = getApprovalGate({
enabled: true,
timeoutMs: 15000, // 15 seconds to respond
requireApprovalFor: ["high", "critical"],
onApprovalNeeded: (request) => {
// Notify user: "⚠️ Approve rm -rf? Auto-proceeding in 15s..."
},
});
// Before risky tool execution
if (gate.requiresApproval(tool)) {
const result = await gate.requestApproval(tool);
if (!result.proceed) {
return { blocked: true, reason: result.request.riskReason };
}
}
// User can respond with:
gate.approve(requestId); // Allow it
gate.deny(requestId); // Block it
// Or wait for timeout → auto-proceeds
Risk Levels:
low: Read operations (auto-approved)medium: Write/Edit, safe exechigh: Messages, browser actions, git pushcritical: rm -rf, database drops, format commands
4. Automatic Retry with Alternatives
Failed tools get diagnosed and retried with modified approaches.
import { createRetryEngine } from "@openclaw/enhanced-loop";
const retry = createRetryEngine({
enabled: true,
maxAttempts: 3,
retryDelayMs: 1000,
});
const result = await retry.executeWithRetry(tool, executor);
// Automatically:
// - Diagnoses errors (permission, network, not_found, etc.)
// - Applies fixes (add sudo, increase timeout, etc.)
// - Retries with exponential backoff
5. Context Summarization
Automatically summarizes old messages when context grows long.
import { createContextSummarizer } from "@openclaw/enhanced-loop";
const summarizer = createContextSummarizer({
thresholdTokens: 80000, // Trigger at 80k tokens
targetTokens: 50000, // Compress to 50k
keepRecentMessages: 10, // Always keep last 10
});
if (summarizer.needsSummarization(messages)) {
const result = await summarizer.summarize(messages);
// Replaces old messages with summary, saves ~30k tokens
}
6. Checkpoint/Restore
Save and resume long-running tasks across sessions.
import { getCheckpointManager } from "@openclaw/enhanced-loop";
const checkpoints = getCheckpointManager();
// Create checkpoint
const ckpt = await checkpoints.createCheckpoint(state, {
description: "After step 3",
trigger: "manual",
});
// Later: check for incomplete work
const incomplete = await checkpoints.hasIncompleteWork(sessionId);
if (incomplete.hasWork) {
console.log(incomplete.description);
// "Incomplete task: Build website (3/6 steps, paused 2.5h ago)"
}
// Resume
const restored = await checkpoints.restore(sessionId);
// Injects context: "Resuming from checkpoint... [plan status]"
7. Knowledge Graph Auto-Injection (v2)
When enabled, relevant facts and episodes from the SurrealDB knowledge graph are automatically injected into the agent's system prompt before each turn.
"memory": {
"autoInject": true,
"maxFacts": 8,
"maxEpisodes": 3,
"episodeConfidenceThreshold": 0.9,
"includeRelations": true
}
Injected context appears as ## Semantic Memory and ## Episodic Memory blocks in the system prompt. Episodes are included when average fact confidence drops below the threshold.
8. Channel-Aware Plan Rendering (v2)
:::plan blocks are automatically transformed per channel:
- Webchat: Rendered as styled HTML cards with progress bars and checkmarks
- Discord: Stripped and replaced with emoji checklists (Discord doesn't support custom HTML)
- Other channels: Raw plan blocks passed through for channel-specific handling
Discord example output:
**Progress (2/5)**
✅ Gather requirements
🔄 Build the website
⬜ Deploy to hosting
⬜ Configure DNS
⬜ Final testing
Unified Orchestrator
The recommended way to use all features together:
import { createOrchestrator } from "@openclaw/enhanced-loop";
const orchestrator = createOrchestrator({
sessionId: "session_123",
planning: { enabled: true, maxPlanSteps: 7 },
approvalGate: { enabled: true, timeoutMs: 15000 },
retry: { enabled: true, maxAttempts: 3 },
context: { enabled: true, thresholdTokens: 80000 },
checkpoint: { enabled: true, autoCheckpointInterval: 60000 },
}, {
onPlanCreated: (plan) => console.log("Plan:", plan.goal),
onStepCompleted: (id, result) => console.log("✓", result),
onApprovalNeeded: (req) => notifyUser(req),
onCheckpointCreated: (id) => console.log("📍 Checkpoint:", id),
});
// Initialize (checks for incomplete work)
const { hasIncompleteWork, incompleteWorkDescription } = await orchestrator.init();
// Process a goal
const { planCreated, contextToInject } = await orchestrator.processGoal(
"Build a REST API with authentication"
);
// Execute tools with all enhancements
const result = await orchestrator.executeTool(tool, executor);
// - Approval gate checked
// - Retries on failure
// - Step completion tracked
// - Checkpoints created
// Get status for display
const status = orchestrator.getStatus();
// { hasPlan: true, progress: { completed: 2, total: 5, percent: 40 }, ... }
Mode Dashboard Integration
The skill includes a Mode tab for the OpenClaw Dashboard:
Location: Agent > Mode
Features:
- Toggle between Core Loop and Enhanced Loop
- Configure all settings visually
- Select orchestrator model from the OpenClaw model catalog (for cost control)
- Real-time configuration preview
OpenClaw Integration
The skill integrates via the enhanced-loop-hook in OpenClaw:
-
Config file:
~/.openclaw/agents/main/agent/enhanced-loop-config.json -
Automatic activation: When enabled, the hook:
- Loads
tryLoadEnhancedLoop()once per agent run, creating the orchestrator wrapRun()is called before each attempt, injecting plan context + memory + tool tracking- Detects planning intent in user messages via
processGoal() - Injects plan context into system prompt (additive; does not replace or override existing system prompt policies)
- Tracks tool executions and step progress via
onToolResult/onAgentEventwrappers - Creates checkpoints automatically
- Offers to resume incomplete tasks
- Falls back to memory-only injection if the orchestrator module is unavailable
- Loads
Host Build Requirement — Real-Time Plan Card Updates
⚠️ Requires OpenClaw UI build that includes the
app-tool-stream.tsplan event fix.
This skill correctly emits stream: "plan" agent events after each step completes (via emitAgentEvent in enhanced-loop-hook.ts). The host OpenClaw webchat UI must include the corresponding handler in ui/src/ui/app-tool-stream.ts to consume those events and update the plan card live.
Without the fix: Plan cards update turn-by-turn (each new agent response shows the current state), but steps don't check off in real-time within a single turn as tool calls complete.
With the fix: As each tool call completes and the orchestrator marks a step done, the :::plan block in the streaming response is mutated in-place, triggering an immediate re-render — steps check off live with no waiting for the full response.
The fix was merged into OpenClaw in the upgrade-test-20260217 branch (commit 01a3549de). If you are running an older build and see the plan card stuck at 0/N until the final response, upgrade your OpenClaw installation:
openclaw gateway update
Credentials and Security
- No additional API keys required. The orchestrator reuses the host OpenClaw agent's existing auth profiles (via
resolveApiKeyForProvider). - OAuth/token priority enforced. Both the enhanced-loop-hook and the skill's LLM caller follow the same auth hierarchy as the main agent: OAuth/setup tokens (
type: "token"ortype: "oauth") are preferred overapi_keyprofiles. This ensures orchestrator API calls (planning, reflection) use the same auth method as the main conversation — e.g., Claude Max OAuth instead of burning API credits. - OAuth setup tokens supported natively. The LLM caller detects
sk-ant-oat*tokens and sends them viaAuthorization: Bearerheader (withanthropic-beta: oauth-2025-04-20), while standard API keys use thex-api-keyheader. No manual configuration needed. - Auth profile order respected. When the caller reads from
auth-profiles.jsondirectly (fallback path), it follows the configuredorder.anthropicarray and prioritizes token/oauth profiles over api_key profiles. - Orchestrator model is dynamically selectable via the Mode dashboard. The dropdown is populated from the OpenClaw model catalog (
models.list), so any model the agent can use is available. Pick a smaller model for planning/reflection calls to minimize costs. - No external network calls beyond the configured LLM provider API (e.g.
api.anthropic.com). The skill does not phone home or send telemetry. Runscripts/verify.sh --network-auditto confirm. - Persistence is local only. Plan state, checkpoints, and configuration are written to
~/.openclaw/under the agent directory. No cloud storage. - Context injection is additive. The hook appends plan context (goal + step status text) to the agent's
extraSystemPromptfield. It does not replace, remove, or conflict wit
Truncated for display — read the full file on GitHub.
Related Skills
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
design
149.0kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
