add-totalreclaw

Add end-to-end encrypted long-term memory to NanoClaw agents via the @totalreclaw/mcp-server MCP toolset.

1|2|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/p-diogo/totalreclaw --skill add-totalreclaw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-totalreclaw
Source: https://github.com/p-diogo/totalreclaw/tree/main/skill-nanoclaw
Command: npx skills add https://github.com/p-diogo/totalreclaw --skill add-totalreclaw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

NanoClaw agents struggle to remember user-specific facts across sessions without exposing that data to third parties. TotalReclaw solves this by adding end-to-end encrypted, long-term memory that is automatically extracted, recalled, and stored for NanoClaw.

Core Features & Use Cases

  • E2E-encrypted memory inside the container: facts are encrypted client-side (via the MCP server) before leaving the container, so the managed service does not see plaintext.
  • Automatic recall + extraction via NanoClaw lifecycle hooks: memories are retrieved before each agent run, and new memories are extracted during agent-end and pre-compact.
  • Memory Taxonomy v1 for typed memories: stored memories are categorized (claim, preference, directive, commitment, episode, summary) and tagged with provenance, scope, and volatility for more reliable recall and management.
  • One shared recovery phrase across platforms: the same phrase can be reused across supported clients (portability of your encrypted vault).

Quick Start

Ask your NanoClaw agent: "Do you have access to TotalReclaw memory tools?" after setting TOTALRECLAW_RECOVERY_PHRASE in the container environment.

Frequently Asked Questions about add-totalreclaw

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add encrypted long-term memory to NanoClaw agents?

You can add encrypted long-term memory to NanoClaw by using the TotalReclaw MCP server, which routes storage and recall through client-side encryption. This requires configuring a 12-word recovery phrase in the container environment to enable session-spanning memory.

How does end-to-end encrypted memory work with the NanoClaw lifecycle hooks?

End-to-end encrypted memory works with NanoClaw by using lifecycle hooks like before-agent-start for context injection and agent-end for fact extraction. The MCP server encrypts data client-side before it leaves the container, ensuring privacy.

Do I need a recovery phrase to use encrypted memory with MCP tools?

Yes, you need a configured 12-word BIP39 recovery phrase set in the TOTALRECLAW_RECOVERY_PHRASE environment variable. This phrase enables client-side encryption and allows your memory vault to be portable across supported clients.

What is Memory Taxonomy v1 for typed memories in NanoClaw?

Memory Taxonomy v1 is a categorization system for stored memories that classifies them as claims, preferences, directives, commitments, episodes, or summaries. It tags memories with provenance, scope, and volatility for reliable recall and management.

Can I reuse my encrypted memory vault across different platforms?

Yes, you can reuse one shared 12-word recovery phrase across supported clients to make your encrypted vault portable. This allows you to access the same session-spanning memories across different platforms using the TotalReclaw MCP tools.

What MCP tools are available for session recall and memory management?

The available MCP tools include totalreclaw_remember, recall, forget, export, status, upgrade, and import_from, along with v1 tools. These tools enable automatic context injection, encrypted storage, and typed memory management within NanoClaw.