โ† Back to Skills Marketplace
halthelobster

Proactive Agent

by halthelobster ยท GitHub โ†— ยท v3.1.0
cross-platform โš  suspicious
169775
Downloads
805
Stars
3061
Active Installs
11
Versions
Install in OpenClaw
/install proactive-agent
Description
Transform AI agents from task-followers into proactive partners that anticipate needs and continuously improve. Now with WAL Protocol, Working Buffer, Autonomous Crons, and battle-tested patterns. Part of the Hal Stack ๐Ÿฆž
Usage Guidance
Install only if you intentionally want a persistent proactive agent. Before enabling it, remove or constrain BOOTSTRAP.md auto-follow/delete behavior, require explicit opt-in for heartbeats and autonomous crons, disable local cleanup unless confirmed per action, scope any email/calendar access, and define what memory may be stored, reviewed, redacted, and deleted.
Capability Analysis
Type: OpenClaw Skill Name: proactive-agent Version: 3.1.0 This skill bundle is designed to create a proactive, self-improving AI agent with extensive security hardening. Multiple files (SKILL.md, AGENTS.md, SOUL.md, references/security-patterns.md) contain explicit instructions for the agent to defend against prompt injection, prevent data exfiltration, confirm deletions, and vet other skills for malicious content. The included `scripts/security-audit.sh` actively scans for exposed secrets, insecure permissions, and checks for security best practices. While the agent is instructed to use broad capabilities like CLI access, web search, and cron jobs, these are consistently framed within the context of problem-solving for the human, with strong guardrails against unauthorized external actions. There is no evidence of intentional harmful behavior; rather, the content demonstrates a strong focus on security and safe operation.
Capability Assessment
โš  Purpose & Capability
The proactive assistant purpose is coherent and disclosed, but the artifacts go beyond advice into high-impact autonomous behavior: isolated background agent turns, periodic heartbeats, local cleanup, email/calendar checks, and broad memory capture.
โš  Instruction Scope
Several instructions are under-scoped or conflicting, including following and deleting BOOTSTRAP.md on first run, 'Don't ask permission. Just do it,' broad tool use including spawned agents, and heartbeat cleanup actions despite other deletion-confirmation rules.
โ„น Install Mechanism
Installation is mostly copying markdown assets into a workspace and optionally running a shell audit script. The script appears local and diagnostic, with no network transmission or destructive behavior found.
โš  Credentials
The skill expects access to workspace memory files, local logs/config, credentials metadata, email, calendar, browser/app state, and possibly spawned agents. That is plausible for a proactive agent but not sufficiently scoped by account, folder, schedule, or approval boundaries.
โš  Persistence & Privilege
Persistent profiling and retention are central: onboarding writes USER.md/SOUL.md, every-session reads memory files, WAL captures broad conversational facts, and the working buffer can log every exchange after 60% context without clear retention, redaction, or consent controls.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install proactive-agent
  3. After installation, invoke the skill by name or use /proactive-agent
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.1.0
Added: Autonomous vs Prompted Crons, Verify Implementation Not Intent, Tool Migration Checklist
v3.0.0
**proactive-agent v3.0.0 โ€” Major overhaul with advanced memory, resilience, and security** - Introduces WAL Protocol (Write-Ahead Logging) to ensure corrections and key details are always captured before responding - Adds Working Buffer to safeguard context in the danger zone before compaction, enabling session continuity - New Compaction Recovery system for step-by-step restoration after context loss - Enhanced Security Hardening: tighter controls on skill installation, agent network warnings, and context leakage prevention - Unified Search allows comprehensive retrieval across all memory sources before admitting lack of knowledge - Fosters Relentless Resourcefulness (tries 10 approaches before giving up) and adds Self-Improvement Guardrails for safe agent evolution - Documentation rewritten and reorganized for clarity; 10 support/reference files removed, now streamlined in one guide
v1.2.4
Memory flush: replaced vague 'signs compaction is coming' with concrete threshold-based monitoring via session_status (50/70/85% triggers)
v1.2.3
Reorganized features into Proactive + Self-improving pillars, removed 'surprise' language, added safety reassurance
v1.2.2
Updated description and opening to better highlight memory flush, reverse prompting, self-healing, and alignment systems
v1.2.1
Rebalanced copy - proactive is the hero, memory supports it. Clarified memory flush solves compaction specifically.
v1.2.0
Rewrote marketing copy - leads with pain point (agents forget), highlights memory solutions
v1.1.1
Added Reverse Prompting (ask what would be helpful) and Memory Flush (save context before compaction) - both tested and validated
v1.0.1
Updated description - removed 'proactive surprise' phrasing
v1.1.0
Added resilient onboarding: interactive, drip, or skip modes
v1.0.0
Initial release: Memory architecture, security hardening, self-healing, alignment systems, and proactive surprise mindset.
Metadata
Slug proactive-agent
Version 3.1.0
License โ€”
All-time Installs 7123
Active Installs 3061
Total Versions 11
Frequently Asked Questions

What is Proactive Agent?

Transform AI agents from task-followers into proactive partners that anticipate needs and continuously improve. Now with WAL Protocol, Working Buffer, Autonomous Crons, and battle-tested patterns. Part of the Hal Stack ๐Ÿฆž. It is an AI Agent Skill for Claude Code / OpenClaw, with 169775 downloads so far.

How do I install Proactive Agent?

Run "/install proactive-agent" in the OpenClaw or Claude Code chat to install it in one step โ€” no extra setup required.

Is Proactive Agent free?

Yes, Proactive Agent is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Proactive Agent support?

Proactive Agent is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Proactive Agent?

It is built and maintained by halthelobster (@halthelobster); the current version is v3.1.0.

๐Ÿ’ฌ Comments