Time Capsule for Openclaw

A digital vault for sealing messages to your future self that return with AI-driven reflections on your growth and life changes.

wyatt88
v1.0.0
Mar 20, 2026
0
754
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install timebottle

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 timebottle 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 Time Capsule?

Time Capsule is a sophisticated emotional and reflective tool within the Openclaw Skills ecosystem designed to bridge the gap between your past and future selves. Unlike standard reminders, this skill preserves your exact words, emotions, and environmental context, sealing them away in a dedicated state file to prevent spoilers during routine memory searches.

When a capsule is eventually opened, the AI doesn't just repeat your message; it performs a deep dive into your recent history to craft a narrative reflection. By comparing your state of mind at the time of sealing—including detected moods like anxious-hopeful or determined—with your subsequent life events, it provides a meaningful "then vs now" perspective that highlights personal evolution and milestones.

Time Capsule Use Cases

  • Writing a heartfelt letter to your future self during significant life milestones.
  • Sealing professional decisions or career bets to review your intuition months later.
  • Capturing fleeting emotional states or "baby milestones" that you want to revisit with fresh eyes.
  • Recording specific wishes or predictions to be revealed on birthdays or anniversaries.
  • Burying thoughts that require time and distance to process effectively.

How Time Capsule Works

  1. Capture and Seal: The agent collects your message and desired opening date, detecting your current mood and extracting key topic hints.
  2. Isolated Storage: The capsule is saved to a specialized JSON file at ~/.openclaw/state/time-capsules.json to ensure it remains hidden from standard search results.
  3. Automated Scheduling: A cron job is scheduled to trigger an agent turn on the exact opening date and time.
  4. Contextual Retrieval: Upon opening, the AI uses query hints to search your memory for relevant life events that occurred while the capsule was sealed.
  5. Narrative Reflection: The skill generates a sincere, narrative-style response that quotes your original message and contrasts it with your growth.
  6. Lifecycle Management: You can list active capsules, delete them with confirmation, or choose to re-seal a message for even further in the future.

Time Capsule Setup

To begin using this skill within your environment, ensure your system supports cron operations and initialize the state directory. The skill will automatically create the necessary data structure upon your first request.

# Ensure the state directory exists
mkdir -p ~/.openclaw/state/

# The skill will initialize the JSON file on the first seal command
# No additional manual configuration of time-capsules.json is required.

Time Capsule Data Schema & Taxonomy

Capsules are managed via a structured JSON schema that tracks the emotional and contextual metadata of each entry.

Field Description
id Unique sortable identifier (e.g., tc_20260320_a1b2c3)
status Current state: sealed, opened, or expired
mood Detected emotional tone (e.g., excited, anxious, neutral)
queryHints AI-generated keywords used to search memory upon opening
contextSnapshot A brief summary of the conversation context at the time of sealing
openAt ISO8601 timestamp for the scheduled delivery

Time Capsule Advanced Features

  • Memory Integration: Performs up to 3 rounds of specialized memory searches to narrate your life changes since the seal date.
  • Tone Adaptation: Automatically adjusts the opening delivery voice based on the original mood of the capsule (e.g., gentler for sad content, straightforward for determined content).
  • Cron Sync: Includes automated cleanup of scheduled tasks when capsules are deleted or modified.
  • Privacy Guard: Uses a dedicated storage path outside of standard workspace memory to prevent the AI from accidentally mentioning sealed content prematurely.
  • Pre-arrival Nudges: Optional heartbeat checks can notify you three days before a capsule is set to arrive.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*