Self-Improving Proactive Agent for Openclaw

A dual-layer Openclaw skill that empowers AI agents to learn from user feedback while maintaining proactive task momentum.

yueyanc
v1.0.0
Mar 15, 2026
11
17.1k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install self-improving-proactive-agent

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install self-improving-proactive-agent using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Self-Improving Proactive Agent?

The Self-Improving Proactive Agent is a unified behavioral framework designed to bridge the gap between static memory and autonomous action. By merging two critical layers of agent logic, this skill allows an agent to evolve based on explicit user corrections while simultaneously pushing work forward without constant supervision. It is a core component for users of Openclaw Skills who require agents that don't just remember better, but operate with higher levels of follow-through and context awareness.

This skill provides a robust architecture for capturing durable preferences and managing active task states. It ensures that an agent remains productive by identifying the next useful move, recovering context independently before asking the user for help, and strictly adhering to safety boundaries during proactive execution.

Self-Improving Proactive Agent Use Cases

  • When an agent needs to capture and apply durable user preferences or coding style corrections across multiple sessions.
  • For managing complex, multi-step tasks where the agent must maintain state and recover context after a drift.
  • In scenarios requiring autonomous heartbeat behavior to follow up on blockers or pending decisions.
  • When a unified behavior model is needed to replace separate, overlapping learning and proactivity skills.

How Self-Improving Proactive Agent Works

  1. The agent monitors interactions for explicit evidence such as direct corrections, stated preferences, or repeated successful workflows.
  2. Captured information is routed to specific storage paths: durable lessons enter the self-improving memory, while active task data is stored in proactivity session files.
  3. Before requesting input, the agent performs context recovery by reading the working buffer and session state to identify the missing delta.
  4. The agent pushes the next useful move—such as preparing drafts or checking for blockers—while staying within defined safety boundaries.
  5. A promotion and decay logic periodically reviews logs, promoting frequent corrections to durable rules and archiving unused data to keep the context window clean.

Self-Improving Proactive Agent Setup

To deploy this skill within your agent's environment, you must initialize the required directory structure and configuration files. Execute the following commands in your workspace:

# Create directory structure
mkdir -p ~/self-improving/projects ~/self-improving/domains ~/self-improving/archive
mkdir -p ~/proactivity/memory

# Initialize core state files
touch ~/self-improving/memory.md ~/self-improving/corrections.md
touch ~/proactivity/session-state.md ~/proactivity/heartbeat.md

Ensure that your agent has read and write permissions for these paths as part of your Openclaw Skills integration.

Self-Improving Proactive Agent Data Schema & Taxonomy

The skill utilizes a structured file system to separate long-term learning from short-term execution state:

Directory Primary Files Data Type Purpose
~/self-improving/ memory.md, corrections.md Markdown Durable preferences and recent learned lessons.
~/proactivity/ session-state.md Markdown Tracks objective, last decision, blockers, and next move.
~/proactivity/memory/ working-buffer.md Markdown Volatile context for fragile or tool-heavy operations.
~/self-improving/ index.md Markdown Storage map and topic index for domain-scoped learning.

Self-Improving Proactive Agent Advanced Features

  • Intelligent Promotion Logic: Automatically promotes a lesson to HOT memory if repeated 3 times within 7 days.
  • Proactive Heartbeat: Detects missing next moves and surfaces prepared recommendations without user prompting.
  • Context Recovery Flow: Advanced logic to read session buffers and state files before asking the user to restate work.
  • Automated Decay: Automatically demotes or archives unused learnings after 30 to 90 days to maintain performance.
  • Safety Guardrails: Hard boundaries preventing autonomous financial transactions, data deletion, or public messaging without explicit approval.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*