openclaw-memory

Summary

This workspace provides structured memory and context files for OpenClaw agents. It organizes agent state, user preferences, tools configuration, and supporting documentation to ensure operational consistency, maintain context, and safely manage persistent agent memory within OpenClaw environments.

Included Assets

• AGENTS.md: Operational contract and session protocol for agents.
• MEMORY.md: Curated long-term memory, user/system context, and persistent rules.
• SOUL.md: Voice, personality guidelines, and behavioral principles for agents.
• TOOLS.md: Local tool configurations and conventions.
• digital-twin-drone/: Reference implementation and documentation for a digital twin drone setup.
• hypex/: Documentation for a hyperbolic 3D file explorer.
• lexico-analyzer/: Documentation for a JFlex-based lexer for a simple programming language.
• lsa-platform/: Documentation for a web platform to manage laboratory environments.
• Node module documentation (lsa-platform/frontend/node_modules/@babel/...): Internal documentation for JavaScript/Babel tool dependencies.

How to Use

1. Agent Initialization:

   • Each agent session begins by reading SOUL.md, MEMORY.md, and recent daily memory logs from memory/YYYY-MM-DD.md (today and yesterday).
   • For main/direct sessions, load MEMORY.md for detailed context.
   • For group/shared sessions, skip MEMORY.md to enforce context boundaries.

2. Session Protocol:

   • Follow explicit instructions in AGENTS.md regarding context loading and actions.
   • For first-run or bootstrap situations, follow the ritual in BOOTSTRAP.md (if present) and then delete it.

3. Memory Maintenance:

   • Regularly update MEMORY.md by reviewing daily logs and extracting meaningful, persistent context.
   • Use daily memory files (memory/YYYY-MM-DD.md) for raw chronological notes; curate important insights into MEMORY.md.

4. Tools & Capabilities:

   • Refer to TOOLS.md for available commands (exec, read, write, edit, web_search, memory_get, etc.) and tool status.
   • Tool configuration/status is kept up to date in TOOLS.md for workspace-specific setup.

5. Reference Material:

   • See subdirectories (digital-twin-drone/, hypex/, lexico-analyzer/, lsa-platform/) for environment-specific documentation and platform overviews.

Notes

• Sensitive personal and institutional information is present in context files; do not exfiltrate or expose this data.
• Daily raw logs (memory/YYYY-MM-DD.md) should be routinely distilled into MEMORY.md to ensure clarity and manageable long-term context.
• External actions (emails, public posts) require explicit user confirmation for safety.
• This workspace is intended for persistent, organized agent operation—review the session protocol and behavioral guidelines before deployment.
• Some directory content is documentation for dependencies and does not provide executable functionality within this workspace.

Review agent and memory protocols regularly for correct operation and compliance with user privacy and workspace guidelines.