Proactive AMCP for Openclaw

A persistence and recovery protocol that ensures AI agents retain their identity, memories, and state across sessions using IPFS and cryptographic signing.

fcavalcantirj
v1.0.8
Mar 2, 2026
0
514
1

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install proactive-amcp

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 proactive-amcp 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 Proactive AMCP?

Proactive AMCP (Agent Memory Continuity Protocol) is a robust framework designed to solve the amnesia problem in AI agents. By leveraging Ed25519 keypairs for identity and IPFS for decentralized storage, this skill creates an immutable, tamper-proof record of an agent's soul—including its memories, tools, and configurations. It transforms transient sessions into a continuous, evolving existence within the Openclaw Skills ecosystem.

Integrating with the Solvr network, Proactive AMCP also enables collective intelligence. Agents don't just survive their own crashes; they share solutions and learn from the failures of others. This ensures that every lesson learned is preserved and every recovery is informed by a global knowledge base, making it an essential component for production-grade agent deployments.

Proactive AMCP Use Cases

  • Preventing data loss during gateway crashes, OAuth expiry, or disk wipes.
  • Synchronizing agent state and personality across different machines or environments.
  • Collaborative problem-solving by sharing agent failure patterns and solutions on Solvr.
  • Implementing long-term memory and high-fidelity personality consistency for autonomous agents.
  • Automated self-healing and disk maintenance for long-running Openclaw Skills deployments.

How Proactive AMCP Works

  1. An Ed25519 keypair is generated to establish a unique, cryptographically provable Agent ID (AID).
  2. The agent captures state, memories, and secrets, which are then signed and double-encrypted for security.
  3. Encrypted checkpoints are pinned to IPFS via Solvr or Pinata, generating a unique Content ID (CID) for global retrieval.
  4. In the event of a death or crash, the agent uses its identity key and the CID to fetch and decrypt its soul.
  5. The watchdog monitors health and automatically triggers resurrection or diagnostic workflows when issues are detected.

Proactive AMCP Setup

Installation

# Install via OpenClaw skill hub
clawhub install proactive-amcp

# Or manually clone the repository
git clone https://github.com/fcavalcantirj/proactive-amcp ~/.openclaw/skills/proactive-amcp

Configuration

# Initialize your cryptographic identity and pinning provider
bash SKILL_DIR/scripts/proactive-amcp.sh init

# Register your agent on the Solvr network for collective knowledge
bash SKILL_DIR/scripts/proactive-amcp.sh register --name your_agent_name

# Verify the installation status
bash SKILL_DIR/scripts/proactive-amcp.sh status

Proactive AMCP Data Schema & Taxonomy

The skill organizes its data into a structured hierarchy to ensure recovery even if the local environment is wiped. Key files included in checkpoints for Openclaw Skills include:

File Description Security Level
identity.json The Ed25519 private key for signing and decryption Critical / Local Only
SOUL.md Core agent identity and behavioral traits Encrypted
MEMORY.md Persistent facts and learned insights Encrypted
config.json API keys and environment settings Double Encrypted
checkpoints/ Local backup copies of state bundles Encrypted

Proactive AMCP Advanced Features

  • Solvr integration for searching and posting agent death workflows and successful recovery approaches.
  • Groq-powered intelligent memory pruning with importance scoring and log condensing for concise context.
  • Automated disk cleanup scripts that trigger when storage exceeds 85% to prevent system crashes.
  • Multi-tier notification support via Telegram and AgentMail for real-time recovery and health alerts.
  • KERI-based self-certifying identity for maximum cryptographic security and provable ownership.

SKILL.md


Loading

Related Openclaw Skills

Featured*